Update connectors in a tool pack

curl -X PUT https://ah-api.merge.dev/api/v1/tool-packs/tool_pack_id/connectors/ \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '[
  {
    "slug": "github",
    "auth_scope": "INDIVIDUAL",
    "tool_names": [
      "create_issue"
    ]
  }
]'

[
  {
    "slug": "github",
    "name": "GitHub",
    "source_url": "https://github.com",
    "logo_url": "https://github.com/favicon.ico",
    "categories": [
      "Developer Tools"
    ],
    "auth_scope": "INDIVIDUAL",
    "tools": [
      {
        "name": "create_issue",
        "description": "Create a new issue",
        "input_schema": {
          "type": "object",
          "properties": {
            "title": {
              "type": "string"
            }
          },
          "required": [
            "title"
          ]
        },
        "credit_type": "default"
      }
    ],
    "connector_id": "3c90c3c0-6d46-4b50-8888-8dd25736052f"
  }
]

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.

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.

Authentication

AuthorizationBearer

Token-based authentication with required prefix “Bearer”

Path parameters

tool_pack_idstringRequiredformat: "uuid"

Request

This endpoint expects a list of objects.

slugstringOptional

Connector slug — primary identifier.

connector_idstringOptionalformat: "uuid"

DEPRECATED — prefer slug. Retained for backward compatibility.

auth_scopeenumOptional

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

Allowed values:

tool_nameslist of stringsOptional

Tool names to enable on this connector.

Omitted: all tools are enabled.
[] (empty list): the connector is removed from the tool pack.
Otherwise: exactly these tools are enabled.

Response

slugstring

namestring

source_urlstring

logo_urlstring

categorieslist of any

auth_scopeenum

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

Allowed values:

toolslist of objectsRead-only

connector_idstringformat: "uuid"

DEPRECATED — alias for the connector UUID. Prefer slug as the primary identifier. Retained for backward compatibility.