API Reference

Agent

Tasks

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get task status

agent.tasks.retrieve_status(strid) -> TaskRetrieveStatusResponse

GET/agent/tasks/{id}

Returns the current status/result for a task.

ParametersExpand Collapse

id: str

ReturnsExpand Collapse

class TaskRetrieveStatusResponse: …

status: str

task_id: str

exit_code: Optional[int]

Get task status

Python

HTTP

TypeScript

Python

import os
from tzafon import Lightcone

client = Lightcone(
    api_key=os.environ.get("TZAFON_API_KEY"),  # This is the default and can be omitted
)
response = client.agent.tasks.retrieve_status(
    "id",
)
print(response.task_id)

200 example

{
  "status": "status",
  "task_id": "task_id",
  "exit_code": 0
}

Returns Examples

200 example

{
  "status": "status",
  "task_id": "task_id",
  "exit_code": 0
}