Get task

Accepts a Bifrost virtual key in x-bf-vk, Authorization: Bearer, x-api-key, or x-goog-api-key. Authentication is required when enforce_auth_on_inference is enabled. An explicitly supplied invalid key is rejected even when authentication is optional. Access remains subject to agent grants and governance policy. A2A v1 HTTP+JSON binding. Errors use the A2A REST error envelope. Unknown or disabled agents return an empty 404.

GET /agents/a2a/{name}/rest/tasks/{taskId}

Error

A valid request URL is required to generate request examples

200

{
  "id": "<string>",
  "contextId": "<string>",
  "status": {
    "state": "TASK_STATE_UNSPECIFIED",
    "message": {
      "messageId": "<string>",
      "parts": [
        {
          "text": "<string>",
          "raw": "<string>",
          "url": "<string>",
          "data": "<unknown>",
          "filename": "<string>",
          "mediaType": "<string>",
          "metadata": {}
        }
      ],
      "role": "ROLE_USER",
      "contextId": "<string>",
      "extensions": [
        "<string>"
      ],
      "metadata": {},
      "referenceTaskIds": [
        "<string>"
      ],
      "taskId": "<string>"
    },
    "timestamp": "2023-11-07T05:31:56Z"
  },
  "artifacts": [
    {
      "artifactId": "<string>",
      "parts": [
        {
          "text": "<string>",
          "raw": "<string>",
          "url": "<string>",
          "data": "<unknown>",
          "filename": "<string>",
          "mediaType": "<string>",
          "metadata": {}
        }
      ],
      "description": "<string>",
      "extensions": [
        "<string>"
      ],
      "metadata": {},
      "name": "<string>"
    }
  ],
  "history": [
    {
      "messageId": "<string>",
      "parts": [
        {
          "text": "<string>",
          "raw": "<string>",
          "url": "<string>",
          "data": "<unknown>",
          "filename": "<string>",
          "mediaType": "<string>",
          "metadata": {}
        }
      ],
      "role": "ROLE_USER",
      "contextId": "<string>",
      "extensions": [
        "<string>"
      ],
      "metadata": {},
      "referenceTaskIds": [
        "<string>"
      ],
      "taskId": "<string>"
    }
  ],
  "metadata": {}
}

Authorizations

VirtualKeyAuthVirtualKeyBearerAuthVirtualKeyApiKeyAuthVirtualKeyGoogleAuth

x-bf-vk · string · header · required

Bifrost Virtual Key for governance, routing, and access control. Supported on all inference endpoints (/v1/*, /openai/*, /anthropic/*, /bedrock/*, /cohere/*, /genai/*, /langchain/*, /litellm/*, /pydanticai/*, /mcp), not on management APIs (/api/*) - with the single exception of the self-service GET /api/governance/virtual-keys/quota, where the virtual key is the credential. Example: sk-bf-* prefixed keys.

Headers

A2A-Version · string

A2A v1 only. Omit to use the SDK default, or provide a 1.x version.

A2A-Extensions · string

A2A extension URIs requested by the client.

Path Parameters

name · string · required

taskId · string · required

Query Parameters

historyLength · integer

Response

200

application/json

Success

id · string · required

contextId · string · required

status · object · required

Show child attributes

artifacts · object[]

Show child attributes

history · object[]

Show child attributes

metadata · object

Show child attributes