Skip to main content
GET
/
v2
/
agents
/
{agent_key}
/
tasks
/
{task_id}
Retrieve a specific agent task
curl --request GET \
  --url https://api.orq.ai/v2/agents/{agent_key}/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "contextId": "<string>",
  "kind": "task",
  "status": {
    "state": "submitted",
    "timestamp": "<string>",
    "message": {
      "kind": "message",
      "messageId": "<string>",
      "role": "user",
      "parts": [
        {
          "kind": "text",
          "text": "<string>"
        }
      ]
    }
  },
  "history": [
    {
      "kind": "message",
      "messageId": "<string>",
      "role": "user",
      "parts": [
        {
          "kind": "text",
          "text": "<string>"
        }
      ],
      "taskId": "<string>",
      "contextId": "<string>",
      "metadata": {}
    }
  ],
  "artifacts": [
    {
      "artifactId": "<string>",
      "name": "<string>",
      "description": "<string>",
      "parts": [
        {
          "kind": "text",
          "text": "<string>"
        }
      ],
      "extensions": [
        "<string>"
      ],
      "metadata": {}
    }
  ],
  "metadata": {}
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

agent_key
string
required
task_id
string
required

Response

Agent task retrieved

Agent task execution response format with full conversation history and artifacts. Used for API responses when retrieving task details.

id
string
required

Unique task execution identifier

contextId
string
required

Correlation ID for tracking

kind
enum<string>
required

A2A entity type

Available options:
task
status
object
required

Current task execution status

history
Extended A2A Message · object[]
required

Conversation history with all messages exchanged

artifacts
Task Artifact · object[]

Optional files or data produced during execution

metadata
object

Additional task metadata