---
title: "Get All Workspace Permissions"
method: GET
path: "/workspaces/permissions"
tags: ["Workspaces"]
---

# Get All Workspace Permissions

`GET /workspaces/permissions`

Get all workspace permissions.

Returns a list of all available workspace permissions.

Returns:
    List[Permission]: A list of Permission objects representing the available workspace permissions.

Raises:
    HTTPException: If there is an error retrieving the workspace permissions.

## Response `200`

Successful Response

- Permission[]

## Changes

- **2026-05-19** `a7f9a6823230` — 1 warning
  - added the new `view_events` enum value to the `items/` response property for the response status `200`
- **2026-05-02** `6e37373d45fe` — 1 info
  - api tag `Workspaces` added
- **2026-03-04** `c8917fecb5bf` — 2 warning
  - added the new `edit_webhooks` enum value to the `items/` response property for the response status `200`
  - added the new `view_webhooks` enum value to the `items/` response property for the response status `200`
- **2026-02-27** `8fcd55a5a656` — 3 warning
  - added the new `edit_tools` enum value to the `items/` response property for the response status `200`
  - added the new `run_tools` enum value to the `items/` response property for the response status `200`
  - added the new `view_tools` enum value to the `items/` response property for the response status `200`
- **2026-02-13** `72fe88316d15` — 10 warning, 3 info
  - added the new `deploy_environments` enum value to the `items/` response property for the response status `200`
  - added the new `edit_api_keys` enum value to the `items/` response property for the response status `200`
  - added the new `edit_environments` enum value to the `items/` response property for the response status `200`
  - added the new `edit_folders` enum value to the `items/` response property for the response status `200`
  - …9 more

[Full history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/workspaces/permissions/get.md)

---

[API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) · [All operations](https://skmtc.dev/agenta-ai/apis/agenta-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agenta-ai/agenta-api/revisions/c26abd89e092/schema)