SMAO API Documentation
Public APITools

Delete a tool

DELETE
/tools/{tool_id}

Deletes the tool and removes its _id from any assistant's tool_ids list so no assistant is left referencing a missing tool.

Authorization

bearerAuth
AuthorizationBearer <token>

API key in the Authorization: Bearer <key> header. Keys are created in the SMAO dashboard (Settings → API Keys).

In: header

Path Parameters

tool_id*string
Match^[a-f0-9]{24}$

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/tools/65f8fa6f1a9d8e0012ab34cd"
{  "data": {}}

Update a tool PATCH

Partial update — only included fields are changed. `tool_key` and `execution_type` are immutable (create a new tool instead). To rotate an auth secret, submit a full `auth` object with the new value; the previous secret is overwritten in place.

List calls (paginated) GET

List calls (paginated)