> ## 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 tool definitions > Administrator-only, read-only generated definitions; never executes or dispatches. This is not an MCP transport. Uses the same overlay registry and generator for current account/member, requiring agentic path, auto approval and active owned/org connection or enabled hook. No entitlement collaborator is supplied today. Returns standard mcp_tool plus internal trust metadata. 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/tool_definitions 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/tool_definitions: get: tags: - Integrations summary: List integration tool definitions description: >- Administrator-only, read-only generated definitions; never executes or dispatches. This is not an MCP transport. Uses the same overlay registry and generator for current account/member, requiring agentic path, auto approval and active owned/org connection or enabled hook. No entitlement collaborator is supplied today. Returns standard mcp_tool plus internal trust metadata. 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-tool-definitions parameters: - name: account_id in: path required: true schema: type: integer description: Route account; caller must be a member. responses: '200': description: Current response content: application/json: schema: $ref: '#/components/schemas/MarketplaceTools' example: tools: - mcp_tool: name: synthetic_read title: Read inputSchema: type: object properties: {} annotations: readOnlyHint: true idempotentHint: true openWorldHint: true trust: approval_tier: none reversible: true pre_action_narration: false emit_receipt: false idempotency_key: null rate_limit: null class: read_only action_key: synthetic.read integration_app_id: synthetic kind: nango_proxy provider_config_key: synthetic connection_scope: org paths: manual: true agentic: true schema_version: 1 x-example-provenance: capture_file: >- docs/platform-api/marketplace-evidence/list-integration-tool-definitions-default.json synthetic: true scrubbed: true x-current-examples: manual-only: capture_file: >- docs/platform-api/marketplace-evidence/list-integration-tool-definitions-manual-only.json body: tools: [] no-connection: capture_file: >- docs/platform-api/marketplace-evidence/list-integration-tool-definitions-no-connection.json body: tools: [] '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-tool-definitions-agent.json body: error: You are not authorized to do this action foreign: capture_file: >- docs/platform-api/marketplace-evidence/list-integration-tool-definitions-foreign.json body: error: You are not authorized to access this account unauthenticated: capture_file: >- docs/platform-api/marketplace-evidence/list-integration-tool-definitions-unauthenticated.json body: errors: - You need to sign in or sign up before continuing. security: - userApiKey: [] components: schemas: MarketplaceTools: type: object properties: tools: type: array items: $ref: '#/components/schemas/MarketplaceTool' description: tools from the current marketplace serializer. required: - tools MarketplaceAuthError: oneOf: - $ref: '#/components/schemas/MarketplaceError' - type: object properties: errors: type: array items: type: string required: - errors MarketplaceTool: type: object properties: mcp_tool: type: object properties: name: type: string description: name from the current marketplace serializer. title: type: string description: title from the current marketplace serializer. description: type: string description: description from the current marketplace serializer. inputSchema: type: object additionalProperties: true description: inputSchema from the current marketplace serializer. annotations: type: object properties: readOnlyHint: type: boolean description: readOnlyHint from the current marketplace serializer. idempotentHint: type: boolean description: idempotentHint from the current marketplace serializer. openWorldHint: type: boolean description: openWorldHint from the current marketplace serializer. destructiveHint: type: boolean description: destructiveHint from the current marketplace serializer. required: - readOnlyHint - idempotentHint - openWorldHint description: annotations from the current marketplace serializer. required: - name - title - inputSchema - annotations description: mcp tool from the current marketplace serializer. trust: $ref: '#/components/schemas/MarketplaceToolTrust' required: - mcp_tool - trust MarketplaceError: type: object properties: error: type: string description: error from the current marketplace serializer. required: - error MarketplaceToolTrust: type: object properties: class: type: string nullable: true description: class from the current marketplace serializer. approval_tier: type: string nullable: true description: approval tier from the current marketplace serializer. approval_policy: type: string nullable: true description: approval policy from the current marketplace serializer. idempotency_key: type: string nullable: true description: idempotency key from the current marketplace serializer. action_key: type: string nullable: true description: action key from the current marketplace serializer. integration_app_id: type: string nullable: true description: integration app id from the current marketplace serializer. kind: type: string nullable: true description: kind from the current marketplace serializer. provider_config_key: type: string nullable: true description: provider config key from the current marketplace serializer. connection_scope: type: string nullable: true description: connection scope from the current marketplace serializer. reversible: type: boolean nullable: true description: reversible from the current marketplace serializer. pre_action_narration: type: boolean nullable: true description: pre action narration from the current marketplace serializer. emit_receipt: type: boolean nullable: true description: emit receipt from the current marketplace serializer. rate_limit: type: integer nullable: true description: rate limit from the current marketplace serializer. schema_version: type: integer description: schema version from the current marketplace serializer. paths: type: object properties: manual: type: boolean description: manual from the current marketplace serializer. agentic: type: boolean description: agentic from the current marketplace serializer. description: paths from the current marketplace serializer. required: - class - approval_tier - reversible - pre_action_narration - emit_receipt - idempotency_key - rate_limit - action_key - integration_app_id - kind - provider_config_key - connection_scope - paths - schema_version 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.