Merge

Merge Subpackage Tool Packs API

The subpackage_toolPacks API from Merge — 4 operation(s) for subpackage_toolpacks.

Documentation GitHub OpenAPI

Operations 9

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/v1/tool-packs/ List tool packs · List Tool Packs #

Ask an LLM

“Which tool packs have I set up?”

“Can I page through my tool packs?”

Tell an agent

List my tool packs.

Show page {page} of tool packs, {page_size} per page.

POST /api/v1/tool-packs/ Create a tool pack · Create Tool Pack #

Ask an LLM

“How do I bundle several connectors into a new tool pack?”

“What do I need to create a tool pack?”

Tell an agent

Create a tool pack named {name} with description {description} and id {id}.

Create tool pack {name} (id {id}, description {description}) with connectors {connectors}.

GET /api/v1/tool-packs/{id}/ Get a tool pack · Get Tool Pack #

Ask an LLM

“Where can I see a single tool pack's settings?”

“What name and description does a given tool pack have?”

Tell an agent

Get tool pack {id}.

Show details of tool pack {id}.

DELETE /api/v1/tool-packs/{id}/ Delete a tool pack · Delete Tool Pack #

Ask an LLM

“Can I permanently remove a tool pack I no longer use?”

“What's the way to delete a tool pack for good?”

Tell an agent destructive · confirm first

Delete tool pack {id}.

Remove tool pack {id} entirely.

PATCH /api/v1/tool-packs/{id}/ Update a tool pack · Update Tool Pack #

Ask an LLM

“How do I rename a tool pack or change its description?”

“Can I edit a tool pack's settings after creating it?”

Tell an agent

Rename tool pack {id} to {name}.

Change the description of tool pack {id} to {description}.

GET /api/v1/tool-packs/{tool_pack_id}/connectors/ List connectors in a tool pack · List connectors in a Tool Pack #

Ask an LLM

“Which connectors are attached to a tool pack, and which tools are on?”

“What tools are enabled for each connector in my pack?”

Tell an agent

List the connectors in tool pack {tool_pack_id}.

Show enabled tools per connector for tool pack {tool_pack_id}.

PUT /api/v1/tool-packs/{tool_pack_id}/connectors/ Replace a tool pack's connector list · Update connectors in a Tool Pack #

Ask an LLM

“How do I set a tool pack's connectors to exactly a new list?”

“Will connectors I leave out be removed when I replace the list?”

Tell an agent

Replace all connectors in tool pack {tool_pack_id} with a new list.

Overwrite the full connector set of tool pack {tool_pack_id}, detaching anything not listed.

PATCH /api/v1/tool-packs/{tool_pack_id}/connectors/ Add or adjust some connectors in a tool pack · Update connectors in a Tool Pack (partial) #

Ask an LLM

“Can I add a connector to a tool pack without touching the others?”

“How do I change enabled tools on just one connector in a pack?”

Tell an agent

Add or update connectors in tool pack {tool_pack_id}, leaving the rest untouched.

Partially adjust connector tools in tool pack {tool_pack_id}.

DELETE /api/v1/tool-packs/{tool_pack_id}/connectors/{slug}/ Remove a connector from a tool pack · Remove a connector from a Tool Pack #

Ask an LLM

“Is there a way to detach a single connector from a tool pack?”

“Can I drop one integration from a pack by its slug?”

Tell an agent destructive · confirm first

Remove connector {slug} from tool pack {tool_pack_id}.

Detach {slug} from tool pack {tool_pack_id}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/merge:merge-subpackage-toolpacks-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Agent Handler Subpackage Tool Packs API
  version: 1.0.0
servers:
- url: https://ah-api.merge.dev
tags:
- name: subpackage_toolPacks
paths:
  /api/v1/tool-packs/:
    get:
      operationId: list
      summary: List Tool Packs
      description: Retrieves a list of Tool Packs
      tags:
      - subpackage_toolPacks
      parameters:
      - name: page
        in: query
        description: A page number within the paginated result set.
        required: false
        schema:
          type: integer
      - name: page_size
        in: query
        description: Number of results to return per page.
        required: false
        schema:
          type: integer
      - name: Authorization
        in: header
        description: Token-based authentication with required prefix "Bearer"
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedToolPackPublicList'
    post:
      operationId: create
      summary: Create Tool Pack
      description: Creates a Tool Pack with connectors
      tags:
      - subpackage_toolPacks
      parameters:
      - name: Authorization
        in: header
        description: Token-based authentication with required prefix "Bearer"
        required: true
        schema:
          type: string
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolPackPublic'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ToolPackPublicWrite'
  /api/v1/tool-packs/{id}/:
    get:
      operationId: retrieve
      summary: Get Tool Pack
      description: Retrieves a Tool Pack by ID
      tags:
      - subpackage_toolPacks
      parameters:
      - name: id
        in: path
        description: Agent Handler ID of the Tool Pack
        required: true
        schema:
          type: string
          format: uuid
      - name: Authorization
        in: header
        description: Token-based authentication with required prefix "Bearer"
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolPackPublic'
    delete:
      operationId: destroy
      summary: Delete Tool Pack
      description: Deletes a Tool Pack by ID
      tags:
      - subpackage_toolPacks
      parameters:
      - name: id
        in: path
        description: Agent Handler ID of the Tool Pack
        required: true
        schema:
          type: string
          format: uuid
      - name: Authorization
        in: header
        description: Token-based authentication with required prefix "Bearer"
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response
    patch:
      operationId: partial-update
      summary: Update Tool Pack
      description: Updates a Tool Pack by ID
      tags:
      - subpackage_toolPacks
      parameters:
      - name: id
        in: path
        description: Agent Handler ID of the Tool Pack
        required: true
        schema:
          type: string
          format: uuid
      - name: Authorization
        in: header
        description: Token-based authentication with required prefix "Bearer"
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolPackPublic'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchedToolPackPublicWrite'
  /api/v1/tool-packs/{tool_pack_id}/connectors/:
    get:
      operationId: list-connectors
      summary: List connectors in a Tool Pack
      description: List the connectors attached to a tool pack, with the tools enabled on each connector.
      tags:
      - subpackage_toolPacks
      parameters:
      - name: tool_pack_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: Authorization
        in: header
        description: Token-based authentication with required prefix "Bearer"
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ConnectorPublic'
    put:
      operationId: replace-connectors
      summary: Update connectors in a Tool Pack
      description: 'Replace a tool pack''s connector list declaratively. Any connector not in the request body is removed from the tool pack.


        `tool_names` behavior per item:

        - Omitted: all tools are enabled on the connector.

        - `[]` (empty list): the connector is removed from the tool pack.

        - Otherwise: exactly these tools are enabled.


        Returns the updated list of connectors on the tool pack.'
      tags:
      - subpackage_toolPacks
      parameters:
      - name: tool_pack_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: Authorization
        in: header
        description: Token-based authentication with required prefix "Bearer"
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ConnectorPublic'
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/ToolPackConnectorBulkInput'
    patch:
      operationId: bulk-upsert-delete-connectors
      summary: Update connectors in a Tool Pack (partial)
      description: 'Partially update a tool pack''s connectors. Connectors not listed in the request body are left untouched.


        `tool_names` behavior per item:

        - Omitted (new connector): all tools are enabled.

        - Omitted (existing connector): the connector''s tools are left unchanged.

        - `[]` (empty list): the connector is removed from the tool pack.

        - Otherwise: exactly these tools are enabled.


        Returns the updated list of connectors on the tool pack.'
      tags:
      - subpackage_toolPacks
      parameters:
      - name: tool_pack_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: Authorization
        in: header
        description: Token-based authentication with required prefix "Bearer"
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ConnectorPublic'
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/ToolPackConnectorBulkInput'
  /api/v1/tool-packs/{tool_pack_id}/connectors/{slug}/:
    delete:
      operationId: delete-connector
      summary: Remove a connector from a Tool Pack
      description: Remove a single connector from a tool pack by slug. Returns 204 No Content.
      tags:
      - subpackage_toolPacks
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      - name: tool_pack_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: Authorization
        in: header
        description: Token-based authentication with required prefix "Bearer"
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response
components:
  schemas:
    ToolPackPublic:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: ID of the Tool Pack
        name:
          type: string
          description: Name of the Tool Pack
        description:
          type: string
          description: Description of the Tool Pack
        connectors:
          type: array
          items:
            $ref: '#/components/schemas/ConnectorPublic'
          description: Connectors enabled with the Tool Pack
      required:
      - id
      - name
      - description
      - connectors
      title: ToolPackPublic
    ToolPackConnectorBulkInputAuthScope:
      type: string
      enum:
      - INDIVIDUAL
      - SHARED
      - ORGANIZATION
      description: 'Authentication scope. INDIVIDUAL: each user authenticates separately. SHARED: users in the same registered_company share one credential. Defaults to INDIVIDUAL when creating a new connector.


        * `INDIVIDUAL` - INDIVIDUAL

        * `SHARED` - SHARED

        * `ORGANIZATION` - ORGANIZATION'
      title: ToolPackConnectorBulkInputAuthScope
    ConnectorPublic:
      type: object
      properties:
        slug:
          type: string
        name:
          type: string
        source_url:
          type:
          - string
          - 'null'
        logo_url:
          type: string
        categories:
          type: array
          items:
            description: Any type
        auth_scope:
          $ref: '#/components/schemas/ConnectorPublicAuthScope'
          description: 'How credentials are shared for this connector.


            - `INDIVIDUAL`: each registered user authenticates with their own credential

            - `SHARED`: users in the same registered_company share one credential

            - `ORGANIZATION`: one credential is used for the whole organization


            * `INDIVIDUAL` - INDIVIDUAL

            * `SHARED` - SHARED

            * `ORGANIZATION` - ORGANIZATION'
        tools:
          type: array
          items:
            $ref: '#/components/schemas/ConnectorTool'
        connector_id:
          type: string
          format: uuid
          description: DEPRECATED — alias for the connector UUID. Prefer `slug` as the primary identifier. Retained for backward compatibility.
      required:
      - slug
      - name
      - source_url
      - logo_url
      - categories
      - auth_scope
      - tools
      - connector_id
      description: 'Public tool-pack-scoped connector shape.


        Used across public endpoints that return a connector attached to a tool

        pack: both the nested `connectors[]` in `GET /api/v1/tool-packs/{id}/`

        and the items in `/api/v1/tool-packs/{id}/connectors/` (GET/PATCH/PUT).

        See the "Consolidating connector response" tech-debt spec (column E).'
      title: ConnectorPublic
    ToolPackConnectorInputAuthScope:
      type: string
      enum:
      - INDIVIDUAL
      - SHARED
      - ORGANIZATION
      default: INDIVIDUAL
      description: 'How credentials are shared for this connector.


        - `INDIVIDUAL`: each registered user authenticates with their own credential

        - `SHARED`: users in the same registered_company share one credential

        - `ORGANIZATION`: one credential is used for the whole organization


        * `INDIVIDUAL` - INDIVIDUAL

        * `SHARED` - SHARED

        * `ORGANIZATION` - ORGANIZATION'
      title: ToolPackConnectorInputAuthScope
    PaginatedToolPackPublicList:
      type: object
      properties:
        count:
          type: integer
        next:
          type:
          - string
          - 'null'
          format: uri
        previous:
          type:
          - string
          - 'null'
          format: uri
        results:
          type: array
          items:
            $ref: '#/components/schemas/ToolPackPublic'
      required:
      - count
      - results
      title: PaginatedToolPackPublicList
    ToolPackPublicWrite:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        description:
          type: string
        connectors:
          type: array
          items:
            $ref: '#/components/schemas/ToolPackConnectorInput'
          description: Full-replace list of connectors. Any connector not in this array is detached from the tool pack. For incremental add/remove, use the `/tool-packs/{id}/connectors/` sub-resource endpoints.
      required:
      - id
      - name
      - description
      title: ToolPackPublicWrite
    PatchedToolPackPublicWrite:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        description:
          type: string
        connectors:
          type: array
          items:
            $ref: '#/components/schemas/ToolPackConnectorInput'
          description: Full-replace list of connectors. Any connector not in this array is detached from the tool pack. For incremental add/remove, use the `/tool-packs/{id}/connectors/` sub-resource endpoints.
      title: PatchedToolPackPublicWrite
    ConnectorPublicAuthScope:
      type: string
      enum:
      - INDIVIDUAL
      - SHARED
      - ORGANIZATION
      description: 'How credentials are shared for this connector.


        - `INDIVIDUAL`: each registered user authenticates with their own credential

        - `SHARED`: users in the same registered_company share one credential

        - `ORGANIZATION`: one credential is used for the whole organization


        * `INDIVIDUAL` - INDIVIDUAL

        * `SHARED` - SHARED

        * `ORGANIZATION` - ORGANIZATION'
      title: ConnectorPublicAuthScope
    ConnectorTool:
      type: object
      properties:
        name:
          type: string
        description:
          type:
          - string
          - 'null'
        input_schema:
          description: Any type
        credit_type:
          type: string
      required:
      - name
      - description
      - input_schema
      - credit_type
      description: Full version of ConnectorTool serializer that includes input_schema details.
      title: ConnectorTool
    ToolPackConnectorInput:
      type: object
      properties:
        slug:
          type: string
          description: Connector slug — primary identifier.
        connector_id:
          type: string
          format: uuid
          description: DEPRECATED — prefer `slug`. Retained for backward compatibility.
        auth_scope:
          $ref: '#/components/schemas/ToolPackConnectorInputAuthScope'
          description: 'How credentials are shared for this connector.


            - `INDIVIDUAL`: each registered user authenticates with their own credential

            - `SHARED`: users in the same registered_company share one credential

            - `ORGANIZATION`: one credential is used for the whole organization


            * `INDIVIDUAL` - INDIVIDUAL

            * `SHARED` - SHARED

            * `ORGANIZATION` - ORGANIZATION'
        tool_names:
          type: array
          items:
            type: string
          description: Tool names to enable for this connector. Omit to enable all tools.
      description: 'Shared validation for connector identifier inputs.


        At least one identifier must be provided. When both are set, `slug` wins

        and the deprecated `connector_id` is discarded.'
      title: ToolPackConnectorInput
    ToolPackConnectorBulkInput:
      type: object
      properties:
        slug:
          type: string
          description: Connector slug — primary identifier.
        connector_id:
          type: string
          format: uuid
          description: DEPRECATED — prefer `slug`. Retained for backward compatibility.
        auth_scope:
          $ref: '#/components/schemas/ToolPackConnectorBulkInputAuthScope'
          description: 'Authentication scope. INDIVIDUAL: each user authenticates separately. SHARED: users in the same registered_company share one credential. Defaults to INDIVIDUAL when creating a new connector.


            * `INDIVIDUAL` - INDIVIDUAL

            * `SHARED` - SHARED

            * `ORGANIZATION` - ORGANIZATION'
        tool_names:
          type: array
          items:
            type: string
          description: 'Tool names to enable on this connector.

            - Omitted (new connector): all tools are enabled.

            - Omitted (existing connector, PATCH): the connector''s tools are left unchanged.

            - `[]` (empty list): the connector is removed from the tool pack.

            - Otherwise: exactly these tools are enabled.'
      description: One item in a tool pack connector update request.
      title: ToolPackConnectorBulkInput
  securitySchemes:
    tokenAuth:
      type: http
      scheme: bearer
      description: Token-based authentication with required prefix "Bearer"

Merge Subpackage Tool Packs API

Operations 9

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification