Get Team Task

Runtime contract

The generated OpenAPI operation omits the JSON request body. Send the body shown here; an empty body is not a valid request. The generated response example also does not fully reflect the current A2A envelope.

Start the example A2A server and set the same OS_SECURITY_KEY in the client terminal. These examples target reference-team on port 7777. On deployments using scoped bearer authorization, this operation requires teams:read (or a matching broader grant). The authenticated principal determines user identity; X-User-ID is only anonymous attribution and cannot override it.

First send a message and retain result.id and result.contextId. Substitute those real values for params.id and params.contextId below. Polling requires both IDs even without scoped authentication, plus a persisted local component run. RemoteTeam targets do not support this operation.

Request

curl -X POST "http://localhost:7777/a2a/teams/reference-team/v1/tasks:get" \
  -H "Authorization: Bearer $OS_SECURITY_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "jsonrpc": "2.0",
  "id": "request-1",
  "method": "tasks/get",
  "params": {
    "id": "returned-run-id",
    "contextId": "team-session"
  }
}'

Response

The response result is the Task itself: use result.id for the Agno run ID, result.contextId for its session, and result.status.state for status. There is no result.task wrapper. JSON field names use camelCase. A representative envelope is:

{
  "jsonrpc": "2.0",
  "id": "request-1",
  "result": {
    "id": "returned-run-id",
    "contextId": "team-session",
    "kind": "task",
    "status": {
      "state": "completed"
    },
    "history": [
      {
        "role": "agent",
        "messageId": "returned-message-id",
        "kind": "message",
        "contextId": "team-session",
        "taskId": "returned-run-id",
        "parts": [
          {
            "kind": "text",
            "text": "Example answer"
          }
        ]
      }
    ]
  }
}

Text output is carried in result.history[*].parts; media can also appear in result.artifacts. Optional fields may be absent or null.

curl --request POST 'https://example.com/a2a/teams/string/v1/tasks:get'

null

{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string",      "input": null,      "ctx": {}    }  ]}