Permission

Create grant

Changed on

Create a new grant for a principal on the given scope. Either role_id or actions is required. Grants are immutable; delete and recreate to change them.

post/v1/permissions

Request

  • Base URL: https://example.com/api
  • URL: https://example.com/api/v1/permissions
  • Auth: OAuth 2 (authorization code, authorization URL /oauth/authorize, token URL /oauth/token; client credentials, token URL /oauth/token; password, token URL /oauth/token)

Request body

role_idstring

Optional role whose bundled actions are granted on the scope.

actionsAction[]

Optional explicit actions granted on the scope.

Example request

{
  "principal": {
    "id": "9bsv0s46s6s002p9ltq0"
  },
  "scope": {
    "id": "9bsv0s46s6s002p9ltq0"
  },
  "role_id": "9bsv0s46s6s002p9ltq0"
}

Response

Example response

idstring required

ID of the newly created resource.

Changes

  • 8a34c0b5508eRevision changes
    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 6c0b21e4101eRevision changes
    • info

      added the new Extension enum value to the request property /