API referenceAdmin

List the platform permission policies

Returns the platform-level policy switches, such as whether admin invites are restricted to the owner. Platform admins only.

Authorization

apiKey

AuthorizationBearer <token>

Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.

In: header

curl -X GET "https://example.com/v1/admin/policies"

{  "data": [    {      "id": "string",      "name": "string",      "description": "string",      "enabled": true,      "appliesTo": "string"    }  ]}

{  "_tag": "ApiNotFound",  "error": "not_found",  "message": "That item does not exist, or this key cannot see it.",  "status": 404}

{  "_tag": "ApiNotFound",  "error": "not_found",  "message": "That item does not exist, or this key cannot see it.",  "status": 404}

List recent platform background runs

Returns the recent background and worker runs shown on the admin console, with their status and timing. Platform admins only.

Enable or disable a platform permission policy

Toggles one platform policy and records an audit event. Platform admins only; an unknown `policyId` is reported as not found.