Sign in
Role Bindings

Get a role binding

Get a single role binding by its ID.

Authorization Requires ROLE_BINDING_READ permission on the binding's resource. If the binding does not exist, belongs to another account, or the caller lacks this permission, the endpoint returns 404.

<Note>This endpoint is in beta, read more here.</Note>

get/v2/role-bindings/{binding_id}

Path parameters

binding_idstring required

A universally unique identifier (base64-encoded opaque string).

Example:RW50aXR5OjEyMzQ1

The unique role binding identifier (base64)

Response

A role binding object.

idstring required

Unique identifier for the role binding.

role_idstring required

A universally unique identifier (base64-encoded opaque string).

user_idstring required

A universally unique identifier (base64-encoded opaque string).

resource_type'SPACE' | 'PROJECT' required

Resource type for the binding. Only SPACE and PROJECT are supported for single-binding CRUD. resource_id must encode the same resource type.

resource_idstring required

A universally unique identifier (base64-encoded opaque string).

created_atstring date-time required

Timestamp when the binding was created.

updated_atstring date-time required

Timestamp when the binding was last updated.

Example response

{
  "role_id": "RW50aXR5OjEyMzQ1",
  "user_id": "RW50aXR5OjEyMzQ1",
  "resource_id": "RW50aXR5OjEyMzQ1"
}

Changes

No changes recorded. 1 of the 16 revisions has no diff computed, so it could not be searched.