Error
A valid request URL is required to generate request examples{
"tasks": [
{
"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": {}
}
],
"totalSize": 123,
"pageSize": 123,
"nextPageToken": "<string>"
}{
"error": {
"code": 123,
"status": "<string>",
"message": "<string>",
"details": [
{}
]
}
}{
"error": {
"code": 123,
"status": "<string>",
"message": "<string>",
"details": [
{}
]
}
}{
"error": {
"code": 123,
"status": "<string>",
"message": "<string>",
"details": [
{}
]
}
}{
"error": {
"code": 123,
"status": "<string>",
"message": "<string>",
"details": [
{}
]
}
}{
"error": {
"code": 123,
"status": "<string>",
"message": "<string>",
"details": [
{}
]
}
}{
"error": {
"code": 123,
"status": "<string>",
"message": "<string>",
"details": [
{}
]
}
}Agent Gateway
List tasks
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
Error
A valid request URL is required to generate request examples{
"tasks": [
{
"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": {}
}
],
"totalSize": 123,
"pageSize": 123,
"nextPageToken": "<string>"
}{
"error": {
"code": 123,
"status": "<string>",
"message": "<string>",
"details": [
{}
]
}
}{
"error": {
"code": 123,
"status": "<string>",
"message": "<string>",
"details": [
{}
]
}
}{
"error": {
"code": 123,
"status": "<string>",
"message": "<string>",
"details": [
{}
]
}
}{
"error": {
"code": 123,
"status": "<string>",
"message": "<string>",
"details": [
{}
]
}
}{
"error": {
"code": 123,
"status": "<string>",
"message": "<string>",
"details": [
{}
]
}
}{
"error": {
"code": 123,
"status": "<string>",
"message": "<string>",
"details": [
{}
]
}
}Authorizations
VirtualKeyAuthVirtualKeyBearerAuthVirtualKeyApiKeyAuthVirtualKeyGoogleAuth
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 v1 only. Omit to use the SDK default, or provide a 1.x version.
A2A extension URIs requested by the client.
Path Parameters
Query Parameters
Was this page helpful?