Agents API

Send a message and wait for the reply

post/api/v1/agents/{id}/messages

Request

  • Base URL: https://three.ws
  • URL: https://three.ws/api/v1/agents/{id}/messages
  • 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

messagestring required

The user message.

modelstring

Overrides the agent model for this call.

temperaturenumber
channelstring

Where the message came from.

paid_fallbackboolean

Response

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

Changes

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