Automette docs
API Reference

The conversation

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

Authorization

ApiKeyAuth
AuthorizationBearer <token>

API key from API Keys in the dashboard menu.

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/tasks/string/messages"
{  "task_id": "string",  "agent_id": "string",  "status": "queued",  "message": "string",  "error": "string",  "messages": [    {      "role": "user",      "content": "string",      "kind": "question",      "options": [        "string"      ],      "fields": [        {}      ],      "values": {},      "decision": "string",      "at": "2019-08-24T14:15:22Z"    }  ]}

Delete a task DELETE

Deletes the task for good: its conversation, files, results, questions and any tasks it handed work to. A running task is stopped first. Credits it used stay in the account's usage.

Reply to a task 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.