Orgs / Roles / Permissions

Add permissions to an organization role (single or batch)

post/v2/organizations/{orgId}/roles/{roleId}/permissions

Request

  • The document declares no server URL.
  • Auth: none declared

Path parameters

orgIdnumber required
roleIdstring required

Headers

Authorizationstring

For non-platform customers - value must be Bearer <token> where <token> is api key prefixed with cal_

x-cal-secret-keystring

For platform customers - OAuth client secret key

x-cal-client-idstring

For platform customers - OAuth client ID

Request body

permissionsstring[] required

Permissions to add (format: resource.action)

Example request

{
  "permissions": [
    "eventType.read",
    "booking.read"
  ]
}

Response

statusstring required
datastring[] required

Example response

{
  "status": "success"
}

Changes

No recorded changes to this operation across all 1 revision of this API.