Unsupported Principal Type

URI: https://docs.ankatech.co/errors/unsupported-principal-type
HTTP Status: 403 Forbidden

When you see this

The authenticated principal type is not supported for the requested operation.

Common Causes

• A service or machine principal calling an endpoint reserved for user principals (or vice versa).
• A principal type that the operation does not accept.
• Using credentials whose principal category is not authorized for the action.

Response Example

{
  "type": "https://docs.ankatech.co/errors/unsupported-principal-type",
  "title": "Unsupported Principal Type",
  "status": 403,
  "detail": "Principal type 'SERVICE' is not supported for this operation.",
  "instance": "/api/v3/admin/tenants/00000000-0000-0000-0000-000000000001/principals",
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "timestamp": 1730000000
}

Content-Type: application/problem+json — the response follows RFC 7807 Problem Details.

How to Resolve

1. Confirm the principal type your credentials represent.
2. Use a principal of a type the operation accepts.
3. If a different principal type is required, authenticate with appropriate credentials and re-submit.

For full schema definitions, examples, and interactive testing, see the Developer Hub Reference.