Taifa Identity. Docs
OpenAPI Developers

API reference

Acknowledge

Management API contract View .md

POST/v1/lifecycle/{project_id}/ack

Authentication Bearer access token with audience taifa-management. Roles and local eligibility are reviewed separately from the OpenAPI bearer scheme.

Parameters

NameInTypeRequiredDescription
project_idpathstringYes

Request body

application/jsonRequiredAcknowledgement

FieldTypeRequiredDescription
sequenceintegerYesValidation: minimum 0; maximum 2147483647

Responses

200Successful Response

Content type: application/jsonLifecycleAcknowledgement

FieldTypeRequiredDescription
headintegerYes
acknowledgedintegerYes
statuspending | effectiveYes

Other responses

StatusDescriptionSchema
422Validation ErrorHTTPValidationError

Request example

Illustrative only. TypeScript runs in Node.js on the server. Keep management tokens out of browser bundles. Replace the host, token, path values, and any header or required body placeholders before use. Examples do not send requests.

Shell
curl -X POST 'https://YOUR_IDENTITY_HOST/v1/lifecycle/REPLACE_WITH_PROJECT_ID/ack' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  --data '{
  "sequence": 0
}'

Response example

No response example in the current specification.

Popular

Browse by section