Update a custom tool

Change parameters, headers, body template, or rotate auth credentials.

PATCH /api/v1/custom_tools/:id

Partial update. Send only the fields you want to change. The tool's name is immutable, rename means delete + recreate.

Scope: custom_tools:write

Path parameters

Param	Type
`:id`	string

Request body

Any subset of create body fields, plus:

Field	Type	Notes
`is_active`	boolean	Disable without deleting. Disabled tools don't appear in agent pickers.

Rotating credentials

Send a fresh auth.credentials object. The encrypted blob is replaced entirely. The previous credential is unrecoverable.

curl -X PATCH https://dashboard.getmacha.com/api/v1/custom_tools/tool_64f1c0... \
  -H "Authorization: Bearer $MACHA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "auth": {
      "type": "api_key",
      "credentials": { "apiKey": "NEW-postmark-token", "header_name": "X-Postmark-Server-Token" }
    }
  }'

Errors

Status	Code	When
`404`	`custom_tool_not_found`	Unknown ID.
`422`	`validation_failed`	Bad enum value, malformed auth, etc.