Automette docs
API Reference

Reply to a task

POST
/api/v1/tasks/{id}/messages

Authorization

ApiKeyAuth
AuthorizationBearer <token>

API key from API Keys in the dashboard menu.

In: header

Path Parameters

id*string

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/tasks/string/messages" \  -H "Content-Type: application/json" \  -d '{}'
{  "ok": true,  "task_id": "string",  "answered": true}

The conversation GET

The conversation, oldest first: `role` (`user` or `assistant`), `content`, and for an agent's question its `kind`, `options`, `fields` or `template` form. The latest assistant question is what a `waiting_for_input` task is waiting on.

Reply to a task (same as POST /messages) POST

Write to a task: JSON `{ "message": string, "files"?: [...] }` or multipart with `files`. It answers the question a `waiting_for_input` task is asking, reaches the agent while it works, or carries a finished task on. The task resumes within about a second; poll again.