---
title: "Permissions"
method: GET
path: "/api/v1/projects/permissions"
tags: ["Projects"]
---

# Permissions

`GET /api/v1/projects/permissions`

Returns a list of all the available roles and the associated actions they can
perform in a project.

## Response `200`

Successful Response

- RoleToActionMappingView
  - `project_collaborator_actions` RoleView[], required — Project collaborator roles and their allowed actions.
    - `name` union, required — Role that grants the listed actions.
      - 'CREATOR' | 'ADMIN' | 'READ_WRITE' | 'EDIT_ONLY' | 'COMPLETE_ONLY' — User role in the project. For personal project the role should be always "CREATOR" User role for projects v1 maybe specified as "CREATOR" or "ADMIN", because in the past there was no permissions.
      - 'ADMIN' | 'MEMBER' | 'GUEST' — Role of the user inside the workspace
    - `actions` ActionView[], required — Actions granted to this role.
      - `name` string, required — Permission action name.
  - `workspace_collaborator_actions` RoleView[], required — Workspace collaborator roles and their allowed actions.
    - `name` union, required — Role that grants the listed actions.
      - 'CREATOR' | 'ADMIN' | 'READ_WRITE' | 'EDIT_ONLY' | 'COMPLETE_ONLY' — User role in the project. For personal project the role should be always "CREATOR" User role for projects v1 maybe specified as "CREATOR" or "ADMIN", because in the past there was no permissions.
      - 'ADMIN' | 'MEMBER' | 'GUEST' — Role of the user inside the workspace
    - `actions` ActionView[], required — Actions granted to this role.
      - `name` string, required — Permission action name.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/todoist/apis/todoist-api.md) · [All operations](https://skmtc.net/todoist/apis/todoist-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/todoist/todoist-api/revisions/69a962f1578f/schema)