Create

POST
/workspaces
/:workspace
/permissions

Creates a custom permission set. Restricted to admins only.

Request

REQUIRED SCOPES

WORKSPACE

URL PARAMETERS

workspacerequiredstring

The workspace name.

POST PARAMETERS

descriptionstring

The description of the permission set.

namerequiredstring

The name of the permission set.

pipeline_access_levelrequiredstring

Can be one of DENIED, READ_ONLY, RUN_ONLY, or READ_WRITE.

repository_access_levelrequiredstring

Can be one of READ_ONLY, READ_WRITE, or MANAGE.

sandbox_access_levelrequiredstring

Can be one of DENIED, READ_ONLY, or READ_WRITE.

project_team_access_levelstring

Can be READ_ONLYor MANAGE.

Last modified on Jan 19, 2026

Delete Single custom permission set

Request example


curl -X POST "https://api.buddy.works/workspaces/:workspace/permissions" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Artist",
  "description": "Artists can only view source",
  "repository_access_level": "READ_ONLY",
  "pipeline_access_level": "DENIED",
  "sandbox_access_level": "DENIED"
}'

Response

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

STATUS
201 Created