DEPlatform

Tools

Update tool

Change a tool's description or recipe.

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

Changes name, description or recipe. id and slug stay so agents keep finding the tool. The recipe is merged by key: if you send only output, sources and the rest stay.

Path parameters

spacestringPflicht

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

tooluuidPflicht

ID of the tool.

Body

namestring

New display name.

descriptionstring

New description for the agent.

recipeobject

The parts of the recipe that change.

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 PATCH https://app.elunos.ai/api/v1/spaces/praxis-mueller/tools/0199a3c4-1f2a-7c55-8e10-6b7d9a3e2f11 \
  -H "Authorization: Bearer np_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "recipe": {
      "output": {
        "fields": [
          "slots"
        ],
        "limit": 3
      }
    }
  }'

Response

{
  "data": {
    "id": "0199a3c4-1f2a-7c55-8e10-6b7d9a3e2f11",
    "slug": "find_slots",
    "…": "…"
  },
  "changes": [
    {
      "path": "recipe.output.limit",
      "from": 5,
      "to": 3
    }
  ]
}

Publish every agent that uses the tool afterwards. Tool usage shows which ones.