Composio Platform API — Tool Router

naftiko: 1.0.0-alpha2
info:
  label: Composio Platform API — Tool Router
  description: 'Composio Platform API — Tool Router. 15 operations. Lead operation: Create a new tool router session (Legacy).
    Self-contained Naftiko capability covering one Composio business surface.'
  tags:
  - Composio
  - Tool Router
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    COMPOSIO_API_KEY: COMPOSIO_API_KEY
capability:
  consumes:
  - type: http
    namespace: composio-tool-router
    baseUri: https://backend.composio.dev
    description: Composio Platform API — Tool Router business capability. Self-contained, no shared references.
    resources:
    - name: api-v3-labs-tool_router-session
      path: /api/v3/labs/tool_router/session
      operations:
      - name: postlabstoolroutersession
        method: POST
        description: Create a new tool router session (Legacy)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v3-tool_router-session
      path: /api/v3/tool_router/session
      operations:
      - name: posttoolroutersession
        method: POST
        description: Create a new tool router session
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v3-tool_router-session-session_id
      path: /api/v3/tool_router/session/{session_id}
      operations:
      - name: gettoolroutersessionbysessionid
        method: GET
        description: Get a tool router session by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: session_id
          in: path
          type: string
          description: The unique identifier of the tool router session
          required: true
      - name: patchtoolroutersessionbysessionid
        method: PATCH
        description: Patch a tool router session config
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: session_id
          in: path
          type: string
          description: The unique identifier of the tool router session
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v3-tool_router-session-session_id-execute
      path: /api/v3/tool_router/session/{session_id}/execute
      operations:
      - name: posttoolroutersessionbysessionidexecute
        method: POST
        description: Execute a tool within a tool router session
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: session_id
          in: path
          type: string
          description: Tool router session ID (required for public API, optional for internal - injected by middleware)
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v3-tool_router-session-session_id-execute_meta
      path: /api/v3/tool_router/session/{session_id}/execute_meta
      operations:
      - name: posttoolroutersessionbysessionidexecutemeta
        method: POST
        description: Execute a meta tool within a tool router session
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: session_id
          in: path
          type: string
          description: Tool router session ID (required for public API, optional for internal - injected by middleware)
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v3-tool_router-session-session_id-link
      path: /api/v3/tool_router/session/{session_id}/link
      operations:
      - name: posttoolroutersessionbysessionidlink
        method: POST
        description: Create a link session for a toolkit in a tool router session
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: session_id
          in: path
          type: string
          description: The unique identifier of the tool router session
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v3-tool_router-session-session_id-mounts-mount_id-delete
      path: /api/v3/tool_router/session/{session_id}/mounts/{mount_id}/delete
      operations:
      - name: posttoolroutersessionbysessionidmountsbymountiddelete
        method: POST
        description: Delete a file from a session mount
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: session_id
          in: path
          type: string
          description: The unique identifier of the tool router session
          required: true
        - name: mount_id
          in: path
          type: string
          description: ID of the storage mount
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v3-tool_router-session-session_id-mounts-mount_id-download_url
      path: /api/v3/tool_router/session/{session_id}/mounts/{mount_id}/download_url
      operations:
      - name: posttoolroutersessionbysessionidmountsbymountiddownloadurl
        method: POST
        description: Create a presigned download URL for a mount file
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: session_id
          in: path
          type: string
          description: The unique identifier of the tool router session
          required: true
        - name: mount_id
          in: path
          type: string
          description: ID of the storage mount
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v3-tool_router-session-session_id-mounts-mount_id-items
      path: /api/v3/tool_router/session/{session_id}/mounts/{mount_id}/items
      operations:
      - name: gettoolroutersessionbysessionidmountsbymountiditems
        method: GET
        description: List files in a session mount
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: session_id
          in: path
          type: string
          description: The unique identifier of the tool router session
          required: true
        - name: mount_id
          in: path
          type: string
          description: ID of the storage mount
          required: true
        - name: cursor
          in: query
          type: string
          description: Pagination cursor from the previous response next_cursor field
        - name: limit
          in: query
          type: number
          description: Maximum number of files to return per page (1-500)
        - name: mount_relative_prefix
          in: query
          type: string
          description: Relative path prefix within the mount for filtering
    - name: api-v3-tool_router-session-session_id-mounts-mount_id-upload_url
      path: /api/v3/tool_router/session/{session_id}/mounts/{mount_id}/upload_url
      operations:
      - name: posttoolroutersessionbysessionidmountsbymountiduploadurl
        method: POST
        description: Create a presigned upload URL for a mount file
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: session_id
          in: path
          type: string
          description: The unique identifier of the tool router session
          required: true
        - name: mount_id
          in: path
          type: string
          description: ID of the storage mount
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v3-tool_router-session-session_id-proxy_execute
      path: /api/v3/tool_router/session/{session_id}/proxy_execute
      operations:
      - name: posttoolroutersessionbysessionidproxyexecute
        method: POST
        description: Execute proxy request within a tool router session
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: session_id
          in: path
          type: string
          description: Tool router session ID (required for public API, optional for internal - injected by middleware)
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v3-tool_router-session-session_id-search
      path: /api/v3/tool_router/session/{session_id}/search
      operations:
      - name: posttoolroutersessionbysessionidsearch
        method: POST
        description: Search for tools using a query
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: session_id
          in: path
          type: string
          description: Tool router session ID (trs_*)
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v3-tool_router-session-session_id-toolkits
      path: /api/v3/tool_router/session/{session_id}/toolkits
      operations:
      - name: gettoolroutersessionbysessionidtoolkits
        method: GET
        description: Get toolkits for a tool router session
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: session_id
          in: path
          type: string
          description: The unique identifier of the tool router session
          required: true
        - name: limit
          in: query
          type: integer
          description: Number of items per page, max allowed is 50
        - name: cursor
          in: query
          type: string
          description: Cursor for pagination. The cursor is a base64 encoded string of the page and limit. The page is the
            page number and the limit is the number of items per page. T
        - name: toolkits
          in: query
          type: array
          description: Optional comma-separated list of toolkit slugs to filter by. If provided, only these toolkits will
            be returned, overriding the session configuration.
        - name: is_connected
          in: query
          type: boolean
          description: Whether to filter by connected toolkits. If provided, only connected toolkits will be returned.
        - name: search
          in: query
          type: string
          description: Search query to filter toolkits by name, slug, or description
    - name: api-v3-tool_router-session-session_id-tools
      path: /api/v3/tool_router/session/{session_id}/tools
      operations:
      - name: gettoolroutersessionbysessionidtools
        method: GET
        description: List tools with schemas for a tool router session
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: session_id
          in: path
          type: string
          description: Tool router session ID
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    authentication:
      type: apikey
      key: x-api-key
      value: '{{env.COMPOSIO_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: composio-tool-router-rest
    port: 8080
    description: REST adapter for Composio Platform API — Tool Router. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/api/v3/labs/tool-router/session
      name: api-v3-labs-tool-router-session
      description: REST surface for api-v3-labs-tool_router-session.
      operations:
      - method: POST
        name: postlabstoolroutersession
        description: Create a new tool router session (Legacy)
        call: composio-tool-router.postlabstoolroutersession
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v3/tool-router/session
      name: api-v3-tool-router-session
      description: REST surface for api-v3-tool_router-session.
      operations:
      - method: POST
        name: posttoolroutersession
        description: Create a new tool router session
        call: composio-tool-router.posttoolroutersession
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v3/tool-router/session/{session-id}
      name: api-v3-tool-router-session-session-id
      description: REST surface for api-v3-tool_router-session-session_id.
      operations:
      - method: GET
        name: gettoolroutersessionbysessionid
        description: Get a tool router session by ID
        call: composio-tool-router.gettoolroutersessionbysessionid
        with:
          session_id: rest.session_id
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: patchtoolroutersessionbysessionid
        description: Patch a tool router session config
        call: composio-tool-router.patchtoolroutersessionbysessionid
        with:
          session_id: rest.session_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v3/tool-router/session/{session-id}/execute
      name: api-v3-tool-router-session-session-id-execute
      description: REST surface for api-v3-tool_router-session-session_id-execute.
      operations:
      - method: POST
        name: posttoolroutersessionbysessionidexecute
        description: Execute a tool within a tool router session
        call: composio-tool-router.posttoolroutersessionbysessionidexecute
        with:
          session_id: rest.session_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v3/tool-router/session/{session-id}/execute-meta
      name: api-v3-tool-router-session-session-id-execute-meta
      description: REST surface for api-v3-tool_router-session-session_id-execute_meta.
      operations:
      - method: POST
        name: posttoolroutersessionbysessionidexecutemeta
        description: Execute a meta tool within a tool router session
        call: composio-tool-router.posttoolroutersessionbysessionidexecutemeta
        with:
          session_id: rest.session_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v3/tool-router/session/{session-id}/link
      name: api-v3-tool-router-session-session-id-link
      description: REST surface for api-v3-tool_router-session-session_id-link.
      operations:
      - method: POST
        name: posttoolroutersessionbysessionidlink
        description: Create a link session for a toolkit in a tool router session
        call: composio-tool-router.posttoolroutersessionbysessionidlink
        with:
          session_id: rest.session_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v3/tool-router/session/{session-id}/mounts/{mount-id}/delete
      name: api-v3-tool-router-session-session-id-mounts-mount-id-delete
      description: REST surface for api-v3-tool_router-session-session_id-mounts-mount_id-delete.
      operations:
      - method: POST
        name: posttoolroutersessionbysessionidmountsbymountiddelete
        description: Delete a file from a session mount
        call: composio-tool-router.posttoolroutersessionbysessionidmountsbymountiddelete
        with:
          session_id: rest.session_id
          mount_id: rest.mount_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v3/tool-router/session/{session-id}/mounts/{mount-id}/download-url
      name: api-v3-tool-router-session-session-id-mounts-mount-id-download-url
      description: REST surface for api-v3-tool_router-session-session_id-mounts-mount_id-download_url.
      operations:
      - method: POST
        name: posttoolroutersessionbysessionidmountsbymountiddownloadurl
        description: Create a presigned download URL for a mount file
        call: composio-tool-router.posttoolroutersessionbysessionidmountsbymountiddownloadurl
        with:
          session_id: rest.session_id
          mount_id: rest.mount_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v3/tool-router/session/{session-id}/mounts/{mount-id}/items
      name: api-v3-tool-router-session-session-id-mounts-mount-id-items
      description: REST surface for api-v3-tool_router-session-session_id-mounts-mount_id-items.
      operations:
      - method: GET
        name: gettoolroutersessionbysessionidmountsbymountiditems
        description: List files in a session mount
        call: composio-tool-router.gettoolroutersessionbysessionidmountsbymountiditems
        with:
          session_id: rest.session_id
          mount_id: rest.mount_id
          cursor: rest.cursor
          limit: rest.limit
          mount_relative_prefix: rest.mount_relative_prefix
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v3/tool-router/session/{session-id}/mounts/{mount-id}/upload-url
      name: api-v3-tool-router-session-session-id-mounts-mount-id-upload-url
      description: REST surface for api-v3-tool_router-session-session_id-mounts-mount_id-upload_url.
      operations:
      - method: POST
        name: posttoolroutersessionbysessionidmountsbymountiduploadurl
        description: Create a presigned upload URL for a mount file
        call: composio-tool-router.posttoolroutersessionbysessionidmountsbymountiduploadurl
        with:
          session_id: rest.session_id
          mount_id: rest.mount_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v3/tool-router/session/{session-id}/proxy-execute
      name: api-v3-tool-router-session-session-id-proxy-execute
      description: REST surface for api-v3-tool_router-session-session_id-proxy_execute.
      operations:
      - method: POST
        name: posttoolroutersessionbysessionidproxyexecute
        description: Execute proxy request within a tool router session
        call: composio-tool-router.posttoolroutersessionbysessionidproxyexecute
        with:
          session_id: rest.session_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v3/tool-router/session/{session-id}/search
      name: api-v3-tool-router-session-session-id-search
      description: REST surface for api-v3-tool_router-session-session_id-search.
      operations:
      - method: POST
        name: posttoolroutersessionbysessionidsearch
        description: Search for tools using a query
        call: composio-tool-router.posttoolroutersessionbysessionidsearch
        with:
          session_id: rest.session_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v3/tool-router/session/{session-id}/toolkits
      name: api-v3-tool-router-session-session-id-toolkits
      description: REST surface for api-v3-tool_router-session-session_id-toolkits.
      operations:
      - method: GET
        name: gettoolroutersessionbysessionidtoolkits
        description: Get toolkits for a tool router session
        call: composio-tool-router.gettoolroutersessionbysessionidtoolkits
        with:
          session_id: rest.session_id
          limit: rest.limit
          cursor: rest.cursor
          toolkits: rest.toolkits
          is_connected: rest.is_connected
          search: rest.search
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v3/tool-router/session/{session-id}/tools
      name: api-v3-tool-router-session-session-id-tools
      description: REST surface for api-v3-tool_router-session-session_id-tools.
      operations:
      - method: GET
        name: gettoolroutersessionbysessionidtools
        description: List tools with schemas for a tool router session
        call: composio-tool-router.gettoolroutersessionbysessionidtools
        with:
          session_id: rest.session_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: composio-tool-router-mcp
    port: 9090
    transport: http
    description: MCP adapter for Composio Platform API — Tool Router. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: create-new-tool-router-session
      description: Create a new tool router session (Legacy)
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: composio-tool-router.postlabstoolroutersession
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: create-new-tool-router-session-2
      description: Create a new tool router session
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: composio-tool-router.posttoolroutersession
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-tool-router-session-id
      description: Get a tool router session by ID
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: composio-tool-router.gettoolroutersessionbysessionid
      with:
        session_id: tools.session_id
      outputParameters:
      - type: object
        mapping: $.
    - name: patch-tool-router-session-config
      description: Patch a tool router session config
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: composio-tool-router.patchtoolroutersessionbysessionid
      with:
        session_id: tools.session_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: execute-tool-within-tool-router
      description: Execute a tool within a tool router session
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: composio-tool-router.posttoolroutersessionbysessionidexecute
      with:
        session_id: tools.session_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: execute-meta-tool-within-tool
      description: Execute a meta tool within a tool router session
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: composio-tool-router.posttoolroutersessionbysessionidexecutemeta
      with:
        session_id: tools.session_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: create-link-session-toolkit-tool
      description: Create a link session for a toolkit in a tool router session
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: composio-tool-router.posttoolroutersessionbysessionidlink
      with:
        session_id: tools.session_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-file-session-mount
      description: Delete a file from a session mount
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: composio-tool-router.posttoolroutersessionbysessionidmountsbymountiddelete
      with:
        session_id: tools.session_id
        mount_id: tools.mount_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: create-presigned-download-url-mount
      description: Create a presigned download URL for a mount file
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: composio-tool-router.posttoolroutersessionbysessionidmountsbymountiddownloadurl
      with:
        session_id: tools.session_id
        mount_id: tools.mount_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: list-files-session-mount
      description: List files in a session mount
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: composio-tool-router.gettoolroutersessionbysessionidmountsbymountiditems
      with:
        session_id: tools.session_id
        mount_id: tools.mount_id
        cursor: tools.cursor
        limit: tools.limit
        mount_relative_prefix: tools.mount_relative_prefix
      outputParameters:
      - type: object
        mapping: $.
    - name: create-presigned-upload-url-mount
      description: Create a presigned upload URL for a mount file
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: composio-tool-router.posttoolroutersessionbysessionidmountsbymountiduploadurl
      with:
        session_id: tools.session_id
        mount_id: tools.mount_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: execute-proxy-request-within-tool
      description: Execute proxy request within a tool router session
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: composio-tool-router.posttoolroutersessionbysessionidproxyexecute
      with:
        session_id: tools.session_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: search-tools-using-query
      description: Search for tools using a query
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: composio-tool-router.posttoolroutersessionbysessionidsearch
      with:
        session_id: tools.session_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-toolkits-tool-router-session
      description: Get toolkits for a tool router session
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: composio-tool-router.gettoolroutersessionbysessionidtoolkits
      with:
        session_id: tools.session_id
        limit: tools.limit
        cursor: tools.cursor
        toolkits: tools.toolkits
        is_connected: tools.is_connected
        search: tools.search
      outputParameters:
      - type: object
        mapping: $.
    - name: list-tools-schemas-tool-router
      description: List tools with schemas for a tool router session
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: composio-tool-router.gettoolroutersessionbysessionidtools
      with:
        session_id: tools.session_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.