---
title: "Discover configured actions"
method: GET
path: "/actions"
tags: ["Actions"]
---

# Discover configured actions

`GET /actions`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/actions`
- Auth: HTTP bearer

Use to discover which actions are currently configured and which families are available. For what actually ran in a conversation, use list_action_executions with conversationId instead. Requires actions:read. Bounded pages cover integration, published collection, named Sheets and HTTP definitions. Includes inactive/unavailable states. No provider calls. Schemas are returned by get_action. Pages inspect at most ten source definitions and can contain up to thirty integration actions. Concurrent edits are not a point-in-time snapshot; newly inserted definitions can appear on later pages. Unknown versions are null; availableVersions lists the current discoverable version only.

## Query parameters

- `cursor` string
- `connectorId` string

## Response `200`

Successful read

- ActionsPage
  - `actions` DiscoveredAction[], required
    - `actionId` string, required
    - `integrationId` string, nullable, required
    - `family` 'integration' | 'collection' | 'sheets' | 'http', required
    - `name` object, required
      - `en` string, required
      - `es` string, required
    - `version` integer, nullable, required
    - `availableVersions` integer[], required
    - `provider` string, nullable
    - `propertyIds` string[], required
    - `availability` 'configured' | 'unavailable', required
    - `blockers` string[], required
    - `playgroundOnly` boolean
    - `operations` object[], required
      - `name` string, required
      - `readOnly` boolean
      - `inputSchema` object
    - `scopeMode` 'tenant' | 'businesses': tenant applies throughout this workspace and requires empty propertyIds; businesses uses explicitly selected active business IDs. Omission preserves legacy scope semantics. Scope is not an execution permission.
    - `connectorId` string
    - `connectionId` string, nullable
  - `nextCursor` string, nullable, required

## Other responses

- `400`: Structured error
- `401`: Structured error
- `403`: Structured error
- `404`: Structured error
- `409`: Structured error
- `503`: Structured error

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)