Skip to main content
POST
/
agent
/
contexts
/
{id}
/
execute
Execute agent
curl --request POST \
  --url https://api.wacht.dev/agent/contexts/{id}/execute \
  --header 'Content-Type: multipart/form-data' \
  --cookie session_id= \
  --form 'message=Hello, can you help me?' \
  --form 'files=<string>' \
  --form files.items='@example-file'
{
  "status": 200,
  "message": "",
  "data": {
    "message": {
      "id": "msg_abc123",
      "message_type": "user",
      "content": {
        "type": "text",
        "text": "Hello, how can you help?"
      },
      "timestamp": "2024-01-15T10:30:00Z",
      "metadata": {}
    },
    "status": "complete",
    "tool_calls": [],
    "usage": {
      "prompt_tokens": 123,
      "completion_tokens": 123,
      "total_tokens": 123
    }
  },
  "session": {
    "id": "123456789012345678",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  },
  "errors": [
    {
      "code": "INVALID_CREDENTIALS",
      "message": "Invalid credentials. Please try again."
    }
  ]
}

Authorizations

session_id
string
cookie
required

Session-based authentication using cookies

Path Parameters

id
string<uint64>
required

Context ID

Body

multipart/form-data
message
string
required

User message to send to the agent

Example:

"Hello, can you help me?"

files
file[]

Optional file attachments

Response

Agent response

status
integer

HTTP status code

Example:

200

message
string

Response message (empty on success)

Example:

""

data
object
session
object

Minimal session info included in every response

errors
object[] | null

Error details (null on success)