KEkeycardai
Zone Roles

Create role

Changed on

Creates a new customer-owned role in the specified zone. The owner_type is always customer; platform roles are managed by Keycard.

post/zones/{zoneId}/roles

Request

  • Base URL
    https://docs.keycard.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://docs.keycard.ai/zones/{zoneId}/roles
  • Auth
    • HTTP bearer
    • or OAuth 2
      Client credentials
      Token URL: /service-account-token

Path parameters

zoneIdstring required

Zone ID

Request body

identifierstring required

Role identifier: a lowercase slug (letters and digits separated by single hyphens or underscores), unique per owner type within a zone. Role identifiers surface in policy evaluation, so the slug restriction keeps them unambiguous in policy text.

descriptionstring

Human-readable description

Response

A role that can be assigned to users within a zone.

idstring required

Unique identifier of the role

zone_idstring required

Zone this role belongs to

identifierstring required

Role identifier: a lowercase slug (letters and digits separated by single hyphens or underscores), unique per owner type within a zone. Role identifiers surface in policy evaluation, so the slug restriction keeps them unambiguous in policy text.

descriptionstring nullable

Human-readable description

owner_type'platform' | 'customer' required

Who owns this role. Platform-owned roles are managed by Keycard and cannot be modified or deleted via the API; customer-owned roles are user-created.

created_atstring date-time required

Entity creation timestamp

updated_atstring date-time required

Entity update timestamp

Changes

  • d65d51379d93Revision changes
    • breaking

      added the pattern ^[a-z0-9]+(?:[-_][a-z0-9]+)*$ to the request property

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      the response's property pattern ^[a-z0-9]+(?:[-_][a-z0-9]+)*$ was added for the status

  • 7e0e4fa2e16fRevision changes
    • info

      endpoint added