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.

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.

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 (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.

Response

slugstring

namestring

source_urlstring or null

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.

$	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"
>	]
>	}
>	]'

1	[
2	{
3	"slug": "github",
4	"name": "GitHub",
5	"source_url": "https://github.com",
6	"logo_url": "https://github.com/favicon.ico",
7	"categories": [
8	"Developer Tools"
9	],
10	"auth_scope": "INDIVIDUAL",
11	"tools": [
12	{
13	"name": "create_issue",
14	"description": "Create a new issue",
15	"input_schema": {
16	"type": "object",
17	"properties": {
18	"title": {
19	"type": "string"
20	}
21	},
22	"required": [
23	"title"
24	]
25	},
26	"credit_type": "default"
27	}
28	],
29	"connector_id": "3c90c3c0-6d46-4b50-8888-8dd25736052f"
30	}
31	]