Authentication

{
  "mode": "api",
  "origin": "https://partner.example.com",
  "scopes": ["profile:read", "quota:read"],
  "ttlSeconds": 120
}

{
  "token": "<integration-jwt>",
  "subjectType": "user",
  "subjectId": "<subject-id>"
}

{
  "integrationToken": "<integration-jwt>",
  "reason": "security-incident"
}

{
  "organizationId": "<organization-uuid>",
  "jti": "<token-jti>",
  "reason": "manual-revoke"
}

{
  "mode": "api",
  "origin": "https://partner.example.com",
  "scopes": ["profile:read"],
  "ttlSeconds": 120,
  "revokeIntegrationToken": "<old-integration-jwt>"
}

{
  "detail": "Rate limit exceeded for grant. Try again in <seconds> seconds."
}

{
  "detail": {
    "error": "INSUFFICIENT_API_KEY_SCOPE",
    "message": "API key lacks required scope for this endpoint",
    "required_scope": "conversations:write",
    "granted_scopes": ["conversations:read"]
  }
}