Tasks

Get Task

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/tasks/{task_id}

Get task state by ID. Requires workspace context — the task's workspace_id must match.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

workspace_idstringRequired

task_idstringRequired

Responses

200

Successful Response

application/json

task_idstringRequired

call_sidstringRequired

workspace_idstringRequired

skillstringRequired

tierstringRequired

statusstringRequired

resultany ofOptional

stringOptional

or

nullOptional

errorany ofOptional

stringOptional

or

nullOptional

error_typeany ofOptional

stringOptional

or

nullOptional

duration_msany ofOptional

numberOptional

or

nullOptional

input_tokensintegerOptionalDefault: 0

output_tokensintegerOptionalDefault: 0

cached_tokensintegerOptionalDefault: 0

sub_tool_countintegerOptionalDefault: 0

progress_messageany ofOptional

stringOptional

or

nullOptional

progress_stepany ofOptional

integerOptional

or

nullOptional

dispatched_atany ofOptional

stringOptional

or

nullOptional

completed_atany ofOptional

stringOptional

or

nullOptional

404

Task not found or expired

422

Validation Error

application/json

get

/v1/{workspace_id}/tasks/{task_id}

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/tasks/{task_id} HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "task_id": "text",
  "call_sid": "text",
  "workspace_id": "text",
  "skill": "text",
  "tier": "text",
  "status": "text",
  "result": "text",
  "error": "text",
  "error_type": "text",
  "duration_ms": 1,
  "input_tokens": 0,
  "output_tokens": 0,
  "cached_tokens": 0,
  "sub_tool_count": 0,
  "progress_message": "text",
  "progress_step": 1,
  "dispatched_at": "text",
  "completed_at": "text"
}

List Tasks By Call

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/tasks/by-call/{call_sid}

List all tasks for a call. Only returns tasks matching the current workspace.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

workspace_idstringRequired

call_sidstringRequired

Responses

200

List of tasks (may be empty)

application/json

422

Validation Error

application/json

get

/v1/{workspace_id}/tasks/by-call/{call_sid}

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/tasks/by-call/{call_sid} HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "tasks": [
    {
      "task_id": "text",
      "call_sid": "text",
      "workspace_id": "text",
      "skill": "text",
      "tier": "text",
      "status": "text",
      "result": "text",
      "error": "text",
      "error_type": "text",
      "duration_ms": 1,
      "input_tokens": 0,
      "output_tokens": 0,
      "cached_tokens": 0,
      "sub_tool_count": 0,
      "progress_message": "text",
      "progress_step": 1,
      "dispatched_at": "text",
      "completed_at": "text"
    }
  ]
}