This operation creates a new principal (a human or agent identity). Requires service credential authentication via X-Service-Auth-Key. If a principal with the same external_id already exists, the existing record is returned with created=false and HTTP 200.
Request payload for creating a principal.
Your system's identifier for this principal (for example, a user ID). Must be unique. Max 255 characters.
1 - 255The principal type. Possible values: human, agent.
human, agent The display name for this principal. Max 255 characters.
1 - 255Arbitrary key-value metadata to associate with the principal.
Already exists (idempotent). Successful Response
Create principal response payload with idempotency metadata.
Pagination metadata for list responses.
Supports both legacy offset-based and cursor-based pagination.
Cursor fields (has_more, after, before) are populated for
cursor-paginated endpoints. Legacy fields (offset, limit) are
populated when the caller uses the deprecated offset parameter.