Edit a tool

curl -X PUT https://app.scalysis.com/api/v1/tools/512 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "timeoutMs": 15000 }'

curl -X PUT https://app.scalysis.com/api/v1/tools/512 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "headers": [
      { "key": "X-Api-Key", "value": "••••••••", "secret": true },
      { "key": "Accept", "value": "application/json" }
    ]
  }'

{
  "success": true,
  "action": "update_tool",
  "tool": {
    "id": 512,
    "name": "Check stock",
    "timeoutMs": 15000
  }
}

Send only the fields you want to change. Everything else stays the same. PATCH works the same way.

Changes apply to every agent using this tool, starting with the next call. You don’t need to republish the agent.

Path

number

required

Tool ID.

Body

Any field from Create a tool. Rules for lists:

headers, parameters and presetParameters replace the whole list. Send every item you want to keep.
To keep a secret header without resending it, send its value as ••••••••.
Send bodyTemplate: null to go back to the default body.

curl -X PUT https://app.scalysis.com/api/v1/tools/512 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "timeoutMs": 15000 }'

curl -X PUT https://app.scalysis.com/api/v1/tools/512 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "headers": [
      { "key": "X-Api-Key", "value": "••••••••", "secret": true },
      { "key": "Accept", "value": "application/json" }
    ]
  }'

{
  "success": true,
  "action": "update_tool",
  "tool": {
    "id": 512,
    "name": "Check stock",
    "timeoutMs": 15000
  }
}

The response has the full tool. Shortened in the example.

Errors

Status	`error_code`	Meaning
`400`	`INVALID_REQUEST`	A field is wrong. Nothing changed.
`404`	`TOOL_NOT_FOUND`	No API tool with this ID on your account.
`503`	`SERVICE_UNAVAILABLE`	Try again. Get the tool to check whether it changed.

curl -X PUT https://app.scalysis.com/api/v1/tools/512 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "timeoutMs": 15000 }'

curl -X PUT https://app.scalysis.com/api/v1/tools/512 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "headers": [
      { "key": "X-Api-Key", "value": "••••••••", "secret": true },
      { "key": "Accept", "value": "application/json" }
    ]
  }'

{
  "success": true,
  "action": "update_tool",
  "tool": {
    "id": 512,
    "name": "Check stock",
    "timeoutMs": 15000
  }
}

Calls

Orders

Campaigns

Account

Agents

Agent chat

Tools

Path

Body

Errors

​Path

​Body

​Errors

Path

Body

Errors