Tools

Delete tool

Remove a tool no agent uses anymore.

DELETEhttps://app.elunos.ai/api/v1/spaces/{space}/tools/{tool}

Deletes a tool. If it is still attached to an agent, the API refuses with 409 referenced and names the agents.

Path parameters

spacestringPflicht

Slug of the space, e.g. `praxis-mueller`. Returned by `GET /spaces`.

tooluuidPflicht

ID of the tool.

Query parameters

expected_updated_atdatetime

`updated_at` from your last read. If the stored value differs, the API answers 409 `stale` with the current record instead of overwriting someone else's change.

Example

curl -X DELETE https://app.elunos.ai/api/v1/spaces/praxis-mueller/tools/0199a3c4-1f2a-7c55-8e10-6b7d9a3e2f11 \
  -H "Authorization: Bearer np_xxxxxxxx"

Response

If the tool is still in use:

{
  "code": "referenced",
  "message": "The tool is used by 1 agent.",
  "references": [
    {
      "type": "agent",
      "id": "0199a3c2-7d4e-7b21-9f3a-2c5e8d1b4a70",
      "name": "Empfang"
    }
  ]
}