---
title: "List action classes"
method: GET
path: "/api/v3/action-classes"
tags: ["V3 Action Classes"]
---

# List action classes

`GET /api/v3/action-classes`

Returns the action classes (user actions that can trigger an app survey) for a workspace. Use
the returned ids as `distribution.triggers[].actionClassId` when creating or updating app
surveys. Read-only: this v3 endpoint lists action classes but does not create them — action
classes are managed in the Formbricks app (Actions settings) or via the v1/v2 management API.

An empty `data` array means the workspace has no action classes yet. Triggers are optional, so
you can still create an app survey with `distribution.triggers: []` (or omit `distribution`
entirely) and attach triggers later via `PATCH` once an action class exists. Session cookie or
x-api-key.

## Query parameters

- `workspaceId` string, cuid2, required
- `limit` integer
- `cursor` string

## Response `200`

Action classes retrieved successfully

- object
  - `data` ActionClassResource[], required
    - `id` string, cuid2, required — Use this value as `distribution.triggers[].actionClassId` on an app survey.
    - `name` string, required
    - `description` string, nullable, required
    - `type` 'code' | 'noCode', required
    - `key` string, nullable, required — Code-action key for code-type action classes; null for no-code actions.
  - `meta` object, required
    - `limit` integer, required
    - `nextCursor` string, nullable, required — Opaque cursor for the next page. `null` when there are no more results.

## Other responses

- `400` — Bad Request — malformed JSON, invalid query/body/params, duplicate name, or unsupported field.
- `401` — Not authenticated (no valid session or API key).
- `403` — Forbidden — no workspace access, or resource does not exist (404 not used; avoids existence leak).
- `429` — Rate limit exceeded.
- `500` — Internal Server Error.

---

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