POST/api/orgs/{org_id}/identities

Create 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.

認証: AuthorizationヘッダーにBearer形式のAPIキー

パスパラメータ

  • org_idstring必須

    Your organization id (uuid). GET /api/whoami returns it.

リクエストボディ

  • display_namestring必須
  • descriptionstring | null
  • identity_idstring | null

    Stable id: lowercase alphanumerics separated by ., - or _; may not start with org-. Unique across the platform. Generated from the display name when omitted.

レスポンス

  • 201

    Created.

    レスポンス
    • identity_idstring必須
    • display_namestring必須
    • descriptionstring | null必須
    • activeboolean必須

      False blocks minting new keys under it; existing keys keep serving until revoked.

    • is_defaultboolean必須

      The org's default identity (holds dashboard-minted keys).

    • created_atstring必須
    • updated_atstring必須
  • 401

    Missing, unknown or revoked API key.

    レスポンス
    • errorstring必須

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 403

    The key is not a provisioning key (inference keys are refused, reads included), or it is a customer-plan key.

    レスポンス
    • errorstring必須

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 404

    Unknown organization, or not the key's own organization.

    レスポンス
    • errorstring必須

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 409

    The identity id is taken.

    レスポンス
    • errorstring必須

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 422

    Body validation failed, or the id is reserved (org- prefix) or malformed.

リクエスト

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"
}'

レスポンス

{
  "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