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

# List Tools For Connection

> ListToolsForConnection returns tools for a connection. By default returns
 all tools the catalog has ever observed; pass seen_since to filter.

 Permission: gateway.view. Allowed callers: identity.PlatformUser,
 identity.Agent.



## OpenAPI

````yaml GET /v1/tools/{connection_id}/catalog
openapi: 3.0.3
info:
  title: Dome Platform API
  description: Connect and REST APIs for the Dome agent governance platform.
  version: 2.0.0
servers:
  - url: https://api.domesystems.ai
    description: Production
security: []
tags:
  - name: Agents
  - name: Authorization
  - name: Guards
  - name: Tools
  - name: Tool Catalog
  - name: Models
  - name: Model Pools
  - name: Quotas
  - name: Gateways
  - name: Webhooks
  - name: Audit
  - name: Workspaces
  - name: Access Control
  - name: Tenants
  - name: Platform Keys
  - name: Enrollment
  - name: Platform
  - name: Identity
paths:
  /v1/tools/{connection_id}/catalog:
    get:
      tags:
        - Tools
      description: >-
        ListToolsForConnection returns tools for a connection. By default
        returns
         all tools the catalog has ever observed; pass seen_since to filter.

         Permission: gateway.view. Allowed callers: identity.PlatformUser,
         identity.Agent.
      operationId: MCPToolCatalog_ListToolsForConnection
      parameters:
        - name: connection_id
          in: path
          required: true
          schema:
            type: string
        - name: workspace_id
          in: query
          schema:
            type: string
        - name: seen_since
          in: query
          description: |-
            Optional. If set, only return tools whose last_seen_at falls within
             (now - seen_since). Unset / zero = all-time.
          schema:
            pattern: ^-?(?:0|[1-9][0-9]{0,11})(?:\.[0-9]{1,9})?s$
            type: string
            description: >-
              Represents a a duration between -315,576,000,000s and
              315,576,000,000s (around 10000 years). Precision is in
              nanoseconds. 1 nanosecond is represented as 0.000000001s
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListToolsForConnectionResponse'
components:
  schemas:
    ListToolsForConnectionResponse:
      type: object
      properties:
        tools:
          type: array
          items:
            $ref: '#/components/schemas/Tool'
    Tool:
      type: object
      properties:
        id:
          type: string
        connection_id:
          type: string
        name:
          type: string
        description:
          type: string
        input_schema:
          type: string
          format: bytes
        current_schema_hash:
          type: string
        first_seen_at:
          type: string
          format: date-time
        last_seen_at:
          type: string
          format: date-time
        status:
          type: string
          description: |-
            Lifecycle status. One of "active", "deprecated", "blocked".
             Empty on the wire is treated as "active" by clients for forward-compat.
        status_message:
          type: string
          description: >-
            Operator-supplied note ("use create_page_v2", "dangerous
            mass-delete", ...).
        status_changed_at:
          type: string
          description: >-
            When the most recent transition happened. Unset for tools never
            transitioned.
          format: date-time
        status_changed_by:
          type: string
          description: |-
            Plain UUID of the platform user who set the current status (no FK).
             Survives user deletion. Empty for tools never transitioned.

````