Taifa Identity. Docs
OpenAPI Developers

API reference

Read scoped project authority status

Management API contract View .md

Read current source review and signed activation observations for an approved project as its current owner or a current project approver. A fresh positive Go readback is an observation, not a lasting sign-in guarantee.

GET/v1/projects/{project_id}/authority-status

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

Parameters

NameInTypeRequiredDescription
project_idpathstringYesValidation: min length 1; max length 128
limitqueryintegerNoValidation: minimum 1; maximum 50
offsetqueryintegerNoValidation: minimum 0; maximum 10000

Request body

This operation has no request body.

Responses

200Successful Response

Content type: application/jsonProjectAuthorityStatus

FieldTypeRequiredDescription
project_idstringYesValidation: min length 1; max length 128
observed_atintegerYesRead time, Unix seconds.
lifecycleLifecycleStatusYes
activation_effectivenessunknownYesProject-wide effectiveness remains unknown; inspect each current signed client observation.
clientsClientAuthorityStatus[]YesValidation: max items 50
next_offsetinteger | nullYesOffset for the next page, or null at the end.

Other responses

StatusDescriptionSchema
403Current project owner or approver authority required.
404Approved project not found.
409More rows exist beyond the bounded pagination ceiling.
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 GET 'https://YOUR_IDENTITY_HOST/v1/projects/REPLACE_WITH_PROJECT_ID/authority-status' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Response example

No response example in the current specification.

Popular

Browse by section