Sign in
latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-219564187.7 KB

4640caa6d712

Permission

Get grant

Get a grant by its ID.

get/v1/permissions/{id}

Response

OK

idstring required

Unique identifier of the grant.

principalstring required

ID of the principal that holds the grant.

principal_type'Assignment' | 'Attachment' | 'Comment' | 'Document' | 'Issue' | 'IssueRelation' | 'Label' | 'Namespace' | 'Notification' | 'Organization' | 'Permission' | 'Project' | 'ResourceType' | 'Role' | 'Team' | 'Todo' | 'User' | 'UserToken' | 'Folder' | 'Installation' required
scopestring required

ID of the resource the grant applies to.

scope_type'Assignment' | 'Attachment' | 'Comment' | 'Document' | 'Issue' | 'IssueRelation' | 'Label' | 'Namespace' | 'Notification' | 'Organization' | 'Permission' | 'Project' | 'ResourceType' | 'Role' | 'Team' | 'Todo' | 'User' | 'UserToken' | 'Folder' | 'Installation' required
role_idstring nullable required

ID of the role whose actions are included in this grant.

actionsAction[] required

Actions granted on the scope.

created_atstring date-time required

Date when the grant was created.

updated_atstring date-time nullable required

Date when the grant was updated.

Example response

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