Single custom permission set

GET
/workspaces
/:workspace
/permissions
/:permission_set_id

Returns a single permission set defined in the workspace. Restricted to admins only.

type can be either DEVELOPER, READ_ONLY or CUSTOM.

Request

REQUIRED SCOPES

WORKSPACE

URL PARAMETERS

workspacerequiredstring

The workspace name.

permission_set_idrequiredinteger

The numerical ID of the desired permission set.

Last modified on Jan 19, 2026

Create Permission sets in a workspace

Request example

CURL
curl -X GET "https://api.buddy.works/workspaces/:workspace/permissions/:permission_set_id" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json" \

Response

EXAMPLE RESPONSE
{
  "url": "https://api.buddy.works/workspaces/buddy/permissions/3",
  "html_url": "https://app.buddy.works/buddy/permissions/edit/3",
  "id": 3,
  "name": "Artist",
  "description": "Artists can only view source",
  "type": "CUSTOM",
  "repository_access_level": "READ_ONLY",
  "pipeline_access_level": "DENIED",
  "sandbox_access_level": "DENIED"
}