/api/orgs/{org_id}/identitiesCreate an identity
Provisioning key only. Identity ids are unique across the platform: an id already taken (by you or anyone) answers 409 identity_id_unavailable with details.suggested_id.
Authentication: Bearer API key in the Authorization header
Path parameters
org_idstringrequiredYour organization id (uuid).
GET /api/whoamireturns it.
Request body
display_namestringrequireddescriptionstring | nullidentity_idstring | nullStable id: lowercase alphanumerics separated by
.,-or_; may not start withorg-. Unique across the platform. Generated from the display name when omitted.
Responses
201Created.
Response
identity_idstringrequireddisplay_namestringrequireddescriptionstring | nullrequiredactivebooleanrequiredFalse blocks minting new keys under it; existing keys keep serving until revoked.
is_defaultbooleanrequiredThe org's default identity (holds dashboard-minted keys).
created_atstringrequiredupdated_atstringrequired
401Missing, unknown or revoked API key.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
403The key is not a provisioning key (inference keys are refused, reads included), or it is a customer-plan key.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
404Unknown organization, or not the key's own organization.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
409The identity id is taken.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
422Body validation failed, or the id is reserved (
org-prefix) or malformed.
Request
curl -X POST https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/identities \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"display_name": "Acme support",
"description": "Customer support agent",
"identity_id": "acme-support"
}'Response
{
"identity_id": "acme-support",
"display_name": "Acme support",
"description": "Customer support agent",
"active": true,
"is_default": false,
"created_at": "2026-11-02T09:14:00Z",
"updated_at": "2026-11-02T09:14:00Z"
}https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/identities