Skip to main content
GET
/
workspaces
/
{id}
/
roles
Get workspace roles
curl --request GET \
  --url https://api.wacht.dev/workspaces/{id}/roles \
  --cookie session_id=
[
  {
    "id": "444444444444444444",
    "workspace_id": "123456789012345678",
    "name": "Developer",
    "permissions": [
      "workspace:read",
      "workspace:write"
    ],
    "is_system_role": false,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
]

Authorizations

​
session_id
string
cookie
required

Session-based authentication using cookies

Path Parameters

​
id
string<uint64>
required

Workspace ID

Response

Roles retrieved successfully

​
id
string<uint64>

Role ID

Example:

"444444444444444444"

​
workspace_id
string<uint64>

Workspace ID

Example:

"123456789012345678"

​
name
string

Role name

Example:

"Developer"

​
permissions
string[]

Role permissions

Example:
["workspace:read", "workspace:write"]
​
is_system_role
boolean

Whether this is a system role

Example:

false

​
created_at
string<date-time>
​
updated_at
string<date-time>