Task Messages

Submit tool outputs.

Changed on

Resumes a task paused on awaiting_tool_results by submitting the results of the function calls requested by the agent. All pending tool_call_ids must be answered in one request. Returns 202 Accepted; poll the task for progress — the agent may request further function calls or complete with a final answer.

post/api/v1/projects/{projectId}/tasks/{taskId}/tool-outputs

Request

Path parameters

projectIdinteger required

The unique identifier of the agent.

taskIdstring required

The task ID.

Request body

Example request

{
  "tool_outputs": [
    {
      "tool_call_id": "call_8f14e45fceea167a5a36dedd4bea2543",
      "output": "{\"orders_today\": 42, \"revenue\": 1337.50}"
    }
  ]
}

Response

Task created and submitted successfully. Poll GET /tasks/{taskId} for progress.

status'error' | 'success'

The status of the response

Example response

{
  "status": "success",
  "data": {
    "id": "f1b9aaf0-5e4e-11eb-ae93-0242ac130002",
    "project_id": 1,
    "name": "Analyse this document",
    "created_at": "Monday, 01-Jan-24 12:00:00 UTC",
    "updated_at": "Monday, 01-Jan-24 12:00:00 UTC"
  }
}

Changes