Update a NEO tool

`PATCH /tool/{id}`

Updates name, description, definition and/or aiAgentId. slug is immutable and ignored. Re-validated via an ephemeral agent; an update snapshot is appended to history.

Path parameters

idintegerpathrequired

Tool ID.

Request body

namestringbody

No description.

descriptionstringbody

No description.

definitionobjectbody

No description.

aiAgentIdintegerbody

No description.

Request Example

{
  "name": "string",
  "description": "string",
  "definition": null,
  "aiAgentId": 1
}

Responses

200 — Updated

Response Example

{
  "tool": {
    "id": 1,
    "slug": "string",
    "aiAgentId": 1,
    "name": "string",
    "description": "string",
    "definition": null,
    "createdAt": "2026-01-01T12:00:00Z",
    "modifiedAt": "2026-01-01T12:00:00Z"
  },
  "success": true
}

404 — Tool not found

422 — Invalid definition (validation violations returned)