v27

latestOpenAPI 3.1.0LicenseRef-Proprietaryraw.githubusercontent.com2026-07-21173076.1 KB

Tasks

List task turns

List the individual turns for a task in execution order.

get/api/tasks/{taskId}/turns

Path parameters

taskIdstring required

Example:tsk_01HZY31W2SZJ8MJ2FQTR3M1K9D

Task id returned by the create task endpoint.

Response

Task turns.

taskIdstring required

Example response

{
  "taskId": "tsk_2Z-YWz3hFq6VlW",
  "items": [
    {
      "id": "trn_4Hq-9Vk2pLm8Rx",
      "taskId": "tsk_2Z-YWz3hFq6VlW",
      "role": "assistant",
      "input": "What's the weather today in Barcelona?",
      "outputText": "It's currently 21°C and sunny in Barcelona with a light breeze from the south-east.",
      "structuredOutput": {
        "temperatureCelsius": 21,
        "conditions": "sunny"
      },
      "status": "completed",
      "startedAt": "2026-05-11T09:14:22.000Z",
      "completedAt": "2026-05-11T09:14:48.000Z",
      "durationMs": 25812,
      "credits": 42,
      "inputTokens": 1842,
      "outputTokens": 312
    }
  ]
}