> ## Documentation Index
> Fetch the complete documentation index at: https://docs.visitoai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List manageable action configurations

> Requires `action_configurations:read`. Includes collection drafts and archived definitions. Summaries only, without private configuration or credentials. At most ten source definitions per page; follow nextCursor until null, including empty pages. Cursor is signed and bound to tenant and family filter. Disabled families are skipped without a filter and return 404 when explicitly requested. Concurrent changes are not a snapshot.



## OpenAPI

````yaml /openapi.json get /actions/configurations
openapi: 3.0.3
info:
  title: Visito M2M API
  version: 1.0.0
  description: >-
    Tenant-scoped server-to-server API for channels, conversations, commerce,
    custom AI tools, and WhatsApp templates. Send operations are asynchronous
    and return queued acknowledgements. Expansion adds conversation controls,
    knowledge, sales opportunities, delivery status, reporting, and signed
    webhooks.
servers:
  - url: https://platform-api.visitoai.com/m2m/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Channels
  - name: Conversations
  - name: Commerce
  - name: Custom tools
  - name: WhatsApp templates
  - name: Properties
  - name: Knowledge
  - name: Sales CRM
  - name: Delivery
  - name: Reporting
  - name: Webhooks
paths:
  /actions/configurations:
    get:
      tags:
        - Actions
      summary: List manageable action configurations
      description: >-
        Requires `action_configurations:read`. Includes collection drafts and
        archived definitions. Summaries only, without private configuration or
        credentials. At most ten source definitions per page; follow nextCursor
        until null, including empty pages. Cursor is signed and bound to tenant
        and family filter. Disabled families are skipped without a filter and
        return 404 when explicitly requested. Concurrent changes are not a
        snapshot.
      operationId: listActionConfigurations
      parameters:
        - name: family
          in: query
          required: false
          schema:
            type: string
            enum:
              - http
              - collection
              - sheets
        - name: cursor
          in: query
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Successful action operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionConfigurationsPage'
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '403':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '409':
          $ref: '#/components/responses/Error'
        '503':
          $ref: '#/components/responses/Error'
components:
  schemas:
    ActionConfigurationsPage:
      type: object
      additionalProperties: false
      properties:
        actions:
          type: array
          items:
            $ref: '#/components/schemas/ActionConfigurationSummary'
          maxItems: 10
        nextCursor:
          type: string
          nullable: true
      required:
        - actions
        - nextCursor
    ActionConfigurationSummary:
      type: object
      additionalProperties: false
      properties:
        actionId:
          type: string
        family:
          type: string
          enum:
            - http
            - collection
            - sheets
        revision:
          type: integer
          minimum: 1
          nullable: true
        supportedOperations:
          type: array
          items:
            type: string
            enum:
              - configuration
              - update
              - state
              - lifecycle
              - delete
              - test
        state:
          $ref: '#/components/schemas/ActionState'
        name:
          type: string
      required:
        - actionId
        - family
        - revision
        - supportedOperations
        - state
        - name
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              example: M2M_AUTH_INSUFFICIENT_SCOPE
            message:
              type: string
            details:
              type: object
              additionalProperties: true
      example:
        error:
          code: M2M_AUTH_INSUFFICIENT_SCOPE
          message: M2M credential does not have required scope.
          details:
            requiredScopes:
              - conversations:write
            missingScopes:
              - conversations:write
    ActionState:
      type: object
      additionalProperties: false
      properties:
        active:
          type: boolean
        playgroundOnly:
          type: boolean
        status:
          type: string
          enum:
            - draft
            - published
            - paused
            - archived
        allowInPlayground:
          type: boolean
        mode:
          type: string
          enum:
            - 'off'
            - playground
            - active
            - legacy_live_only
          description: >-
            Computed availability. legacy_live_only preserves existing HTTP live
            access without Playground access until explicitly changed.
      required:
        - active
  responses:
    Error:
      description: Structured error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Visito M2M API key
      description: Server-side tenant-scoped credential created from Build > API Keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.