Agents API

Update an agent (partial)

patch/api/v1/agents/{id}

Request

  • Base URL: https://three.ws
  • URL: https://three.ws/api/v1/agents/{id}
  • Auth: one of:
    • HTTP bearer
    • API key in header Authorization

Path parameters

idstring required

Headers

Idempotency-Keystring

A retry with the same key and body replays the stored response for 24 hours.

Request body

namestring

Display name, up to 80 characters.

personastring

Short public description.

systemPromptstring

Instructions the agent follows on every turn.

modelstring

Model id from GET /api/v1/models.

temperaturenumber
skillsstring[]

Built-in skill ids from GET /api/v1/skills.

strategystring

Strategy preset id from GET /api/v1/strategies.

Response

The { data, meta: { requestId, timestamp } } envelope.

Changes

No recorded changes to this operation across all 1 revision of this API.