Replace a tool

​

Overwrites the tool's description, argument schema, and endpoint URL, with no new agent version. The endpoint and the argument check apply from the next tool call of every agent version that names the tool. The agent reads the new description and schema from the next call, chat turn, or orchestration session that starts. The name cannot change: a different name returns HTTP 422. An archived tool returns HTTP 404.

Path Parameters

  • tool_id
    Type: string
    required

Headers

  • X-Resia-Organization-Id
    Type: stringnullable

    Insito admins only: the organization this request acts on. A customer's own credential may omit it, or name only its own organization.

Body·

required
application/json
  • description
    Type: string
    min length:  
    1
    max length:  
    1000
    required

    What the tool does and when the agent should use it.

  • endpoint_url
    Type: string
    min length:  
    1    Format: uri
    required

    The owner's public HTTPS endpoint. Resia sends one ToolRequest POST for each tool call, with no retry or redirect. The total deadline is ten seconds. Return a 2xx ToolEndpointResponse of at most 64 KiB. A timeout leaves the action outcome unknown. Treat the complete URL as a credential.

  • name
    Type: string
    required

    The tool name, unique in your organization. An agent version names the tool by it. A built-in tool name such as get_schema, run_sql, end_chat, or start_call is refused. The name stays reserved after the tool is archived.

  • parameters
    Type:
    required

    An object JSON Schema for the tool arguments.

    Properties: 1

Responses

  • application/json
  • application/json
Request Example for put/v1/tools/{tool_id}
curl 'https://api.resia.ai/v1/tools/{tool_id}' \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "name": "",
  "description": "",
  "parameters": {
    "additionalProperty": "anything"
  },
  "endpoint_url": ""
}'

{
  "name": "string",
  "description": "string",
  "parameters": {
    "additionalProperty": "anything"
  },
  "endpoint_url": "https://example.com",
  "id": "01K1SA3F7M8QW2V5C9H4YTB0KD",
  "created_at": "2026-10-07T20:32:25.800Z",
  "updated_at": "2026-10-07T20:32:25.800Z"
}

Successful Response