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

# List integration action catalog

> Administrator-only manual-path catalogue using the current account overlay and connections. Includes retained non-active Nango connections with needs_reconnect true; absent connections are omitted. User-scoped connections belong to the requesting member. Ordered by action key; page clamps to 1..10000 and per_page to 100, default 25; malformed/nonpositive per_page uses 25. Connected-app credentials are held by the integration provider and are not returned by any of these operations. ENG-5874 / ENG-5831 track consistent unknown-provider and field-level validation behavior; this documents current behavior.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/accounts/{account_id}/integrations/action_catalog
openapi: 3.0.4
info:
  title: Tied API
  description: >-
    The Tied REST API. Three families of endpoint, each with its own credential:
    **Application** for everything inside an account, **Platform** for
    provisioning accounts and users, and **Client** for acting as a contact from
    your own surface.
  version: 1.1.0
  termsOfService: https://tied.com/legal
  contact:
    email: hello@tied.com
  license:
    name: MIT License
    url: https://opensource.org/licenses/MIT
servers:
  - url: https://app.tied.com
    description: Tied cloud
security: []
tags:
  - name: Account AgentBots
    description: Account-specific Agent Bots
  - name: Agents
    description: Agent management APIs
  - name: Canned Responses
    description: Pre-defined responses for common queries
  - name: Contacts
    description: Contact management APIs
  - name: Contact Labels
    description: Manage contact labels
  - name: Conversation Assignments
    description: Manage conversation assignments
  - name: Conversation Labels
    description: Manage conversation labels
  - name: Conversations
    description: Conversation management APIs
  - name: Custom Attributes
    description: Custom fields for contacts and conversations
  - name: Custom Filters
    description: Saved filters for conversations
  - name: Inboxes
    description: Communication channels setup
  - name: Integrations
    description: Third-party integrations
  - name: Messages
    description: Message management APIs
  - name: Profile
    description: User profile APIs
  - name: Reports
    description: Analytics and reporting APIs
  - name: Teams
    description: Team management APIs
  - name: Webhooks
    description: Event notification webhooks
  - name: Automation Rule
    description: Workflow automation rules
  - name: Help Center
    description: Knowledge base management
  - name: Contacts API
    description: Public contact APIs
  - name: Conversations API
    description: Public conversation APIs
  - name: Messages API
    description: Public message APIs
  - name: CSAT Survey Page
    description: Customer satisfaction survey
  - name: Account
    description: >-
      The authenticated user's own account — read and update account settings.
      Distinct from the Platform family's **Accounts**, which provisions
      accounts across an installation.
  - name: Audit Logs
    description: Read the account's audit trail
  - name: Inbox API
    description: Public inbox lookup by channel identifier
  - name: Labels
    description: >-
      Create and manage the account's labels. Applying one to a conversation or
      contact is a separate endpoint under those resources.
  - name: Macros
    description: >-
      Saved multi-step actions an agent — or an integration — can run against
      one or more conversations.
  - name: Campaigns
    description: Ongoing website campaigns and one-off SMS and WhatsApp sends.
  - name: Contact Notes
    description: Internal notes on a contact. Never visible to the contact.
  - name: Help Center Categories
    description: Categories group a portal's articles, one tree per allowed locale.
  - name: Help Center Articles
    description: The articles a portal publishes, and their draft and archived states.
  - name: Summary Reports
    description: Per-agent, per-team, per-inbox and per-label totals for a period, as JSON.
  - name: Live Reports
    description: Right-now queue counts. No date range — these describe the present.
  - name: CSAT
    description: >-
      The satisfaction ratings contacts have submitted, and the metrics computed
      from them.
  - name: Notifications
    description: >-
      The per-user notification feed, its read and snooze state, and the
      settings that decide what lands in it.
  - name: Conversation Participants
    description: >-
      The agents watching a conversation. Participants get notified about it
      without being assigned to it.
  - name: Draft Messages
    description: >-
      The unsent reply held for a conversation. Stored in Redis, one per
      conversation.
  - name: Search
    description: >-
      One search service across conversations, contacts, messages and Help
      Center articles.
  - name: Dashboard Apps
    description: Embedded pages that appear as a tab beside a conversation.
  - name: Assignment Policies
    description: How conversations are handed out, and which inbox uses which policy.
  - name: Files
    description: Storing a file so another endpoint can attach it.
  - name: Bot Flows
    description: >-
      Scripted conversation flows, their versions, and the publish and rollback
      that move between them.
  - name: Billing
    description: >-
      Credit balance, usage, invoices, spend controls and the provider-hosted
      payment flows.
  - name: AMB Templates
    description: >-
      Saved Apple Messages primitive payloads an agent can reuse from the
      composer.
  - name: AMB Onboarding
    description: The in-flight Apple Messages for Business registration for an account.
  - name: Widget Session
    description: Starting a widget session and reading the visitor it belongs to.
  - name: Widget Conversation
    description: The visitor's conversation and its messages.
  - name: Widget Context
    description: Campaigns, agents, labels, events and uploads for a widget session.
  - name: CSAT Survey
    description: The public, unauthenticated survey a contact answers from a link.
  - name: Workspace
    description: Scheduling and cancelling deletion of the whole workspace.
  - name: Widget Integrations
    description: Provider actions available to a visitor session in its own conversation.
  - name: Orchestration Studio
    description: >-
      Administrator-only read APIs for Orchestration Studio cases and knowledge
      sources.
  - name: Topic Analytics
    description: Account Topics readiness, labeling health and usage aggregates.
  - name: Analytics V2
    description: >-
      Account-scoped metrics, anonymized benchmarks and audited conversation
      drilldown.
  - name: Knowledge proposals
    description: Administrator-only proposal review and revision decisions.
  - name: Model settings
    description: Administrator-only routing profiles and Tied-hosted catalogue.
paths:
  /api/v1/accounts/{account_id}/integrations/action_catalog:
    get:
      tags:
        - Integrations
      summary: List integration action catalog
      description: >-
        Administrator-only manual-path catalogue using the current account
        overlay and connections. Includes retained non-active Nango connections
        with needs_reconnect true; absent connections are omitted. User-scoped
        connections belong to the requesting member. Ordered by action key; page
        clamps to 1..10000 and per_page to 100, default 25;
        malformed/nonpositive per_page uses 25. Connected-app credentials are
        held by the integration provider and are not returned by any of these
        operations. ENG-5874 / ENG-5831 track consistent unknown-provider and
        field-level validation behavior; this documents current behavior.
      operationId: list-integration-action-catalog
      parameters:
        - name: account_id
          in: path
          required: true
          schema:
            type: integer
          description: Route account; caller must be a member.
        - name: page
          in: query
          schema:
            type: integer
          description: >-
            Current controller normalizes/clamps malformed values; see operation
            description.
        - name: per_page
          in: query
          schema:
            type: integer
          description: >-
            Current controller normalizes/clamps malformed values; see operation
            description.
      responses:
        '200':
          description: Current response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketplaceActionCatalog'
              example:
                actions:
                  - app_id: synthetic
                    action_key: synthetic.read
                    label: Read
                    description: null
                    mutates: false
                    input_schema:
                      type: object
                      properties: {}
                    trust_class: read_only
                    approval_tier: none
                    needs_reconnect: false
                meta:
                  page: 1
                  per_page: 25
                  total_count: 1
                  total_pages: 1
                  next_page: null
          x-example-provenance:
            capture_file: >-
              docs/platform-api/marketplace-evidence/list-integration-action-catalog-default.json
            synthetic: true
            scrubbed: true
          x-current-examples:
            no-connection:
              capture_file: >-
                docs/platform-api/marketplace-evidence/list-integration-action-catalog-no-connection.json
              body:
                actions: []
                meta:
                  page: 1
                  per_page: 25
                  total_count: 0
                  total_pages: 0
                  next_page: null
            query-arrays:
              capture_file: >-
                docs/platform-api/marketplace-evidence/list-integration-action-catalog-query-arrays.json
              body:
                actions:
                  - app_id: synthetic
                    action_key: synthetic.read
                    label: Read
                    description: null
                    mutates: false
                    input_schema:
                      type: object
                      properties: {}
                    trust_class: read_only
                    approval_tier: none
                    needs_reconnect: false
                meta:
                  page: 1
                  per_page: 25
                  total_count: 1
                  total_pages: 1
                  next_page: null
            tenant-isolation:
              capture_file: >-
                docs/platform-api/marketplace-evidence/list-integration-action-catalog-tenant-isolation.json
              body:
                actions:
                  - app_id: synthetic
                    action_key: synthetic.read
                    label: Read
                    description: null
                    mutates: false
                    input_schema:
                      type: object
                      properties: {}
                    trust_class: read_only
                    approval_tier: none
                    needs_reconnect: false
                meta:
                  page: 1
                  per_page: 100
                  total_count: 1
                  total_pages: 1
                  next_page: null
        '401':
          description: >-
            Unauthenticated, non-member or unauthorized role; auth uses
            errors[], membership/policy uses error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketplaceAuthError'
          x-current-examples:
            agent:
              capture_file: >-
                docs/platform-api/marketplace-evidence/list-integration-action-catalog-agent.json
              body:
                error: You are not authorized to do this action
            foreign:
              capture_file: >-
                docs/platform-api/marketplace-evidence/list-integration-action-catalog-foreign.json
              body:
                error: You are not authorized to access this account
            unauthenticated:
              capture_file: >-
                docs/platform-api/marketplace-evidence/list-integration-action-catalog-unauthenticated.json
              body:
                errors:
                  - You need to sign in or sign up before continuing.
      security:
        - userApiKey: []
components:
  schemas:
    MarketplaceActionCatalog:
      type: object
      properties:
        actions:
          type: array
          items:
            $ref: '#/components/schemas/MarketplaceManualAction'
          description: actions from the current marketplace serializer.
        meta:
          type: object
          properties:
            page:
              type: integer
              description: page from the current marketplace serializer.
            per_page:
              type: integer
              description: per page from the current marketplace serializer.
            total_count:
              type: integer
              description: total count from the current marketplace serializer.
            total_pages:
              type: integer
              description: total pages from the current marketplace serializer.
            next_page:
              type: integer
              nullable: true
              description: next page from the current marketplace serializer.
          required:
            - page
            - per_page
            - total_count
            - total_pages
            - next_page
          description: meta from the current marketplace serializer.
      required:
        - actions
        - meta
    MarketplaceAuthError:
      oneOf:
        - $ref: '#/components/schemas/MarketplaceError'
        - type: object
          properties:
            errors:
              type: array
              items:
                type: string
          required:
            - errors
    MarketplaceManualAction:
      type: object
      properties:
        app_id:
          type: string
          description: app id from the current marketplace serializer.
        action_key:
          type: string
          description: action key from the current marketplace serializer.
        label:
          type: string
          description: label from the current marketplace serializer.
        description:
          type: string
          nullable: true
          description: description from the current marketplace serializer.
        mutates:
          type: boolean
          nullable: true
          description: mutates from the current marketplace serializer.
        input_schema:
          type: object
          additionalProperties: true
          description: input schema from the current marketplace serializer.
        trust_class:
          type: string
          nullable: true
          description: trust class from the current marketplace serializer.
        approval_tier:
          type: string
          nullable: true
          description: approval tier from the current marketplace serializer.
        needs_reconnect:
          type: boolean
          description: needs reconnect from the current marketplace serializer.
      required:
        - app_id
        - action_key
        - label
        - description
        - mutates
        - input_schema
        - trust_class
        - approval_tier
        - needs_reconnect
    MarketplaceError:
      type: object
      properties:
        error:
          type: string
          description: error from the current marketplace serializer.
      required:
        - error
  securitySchemes:
    userApiKey:
      type: apiKey
      in: header
      name: api_access_token
      description: >-
        This token can be obtained by visiting the profile page or via rails
        console. Provides access to  endpoints based on the user permissions
        levels. This token can be saved by an external system when user is
        created via API, to perform activities on behalf of the user.

````

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