StreamResponse
The stream response for a message. The stream should be one of the following sequences: If the response is a message, the stream should contain one, and only one, message and then close If the response is a task lifecycle, the first response should be a Task object followed by zero or more TaskStatusUpdateEvents and TaskArtifactUpdateEvents. The stream should complete when the Task if in an interrupted or terminal state. A stream that ends before these conditions are met are
Properties
| Name | Type | Description |
|---|---|---|
| task | object | |
| message | object | |
| statusUpdate | object | |
| artifactUpdate | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/google-cloud-platform/json-schema/google-cloud-platform-stream-response-schema.json",
"title": "StreamResponse",
"description": "The stream response for a message. The stream should be one of the following sequences: If the response is a message, the stream should contain one, and only one, message and then close If the response is a task lifecycle, the first response should be a Task object followed by zero or more TaskStatusUpdateEvents and TaskArtifactUpdateEvents. The stream should complete when the Task if in an interrupted or terminal state. A stream that ends before these conditions are met are",
"x-generated": "2026-11-12",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/google-cloud-platform-cloudbilling-message-api-openapi.yml#/components/schemas/StreamResponse",
"properties": {
"task": {
"$ref": "#/$defs/Task"
},
"message": {
"$ref": "#/$defs/Message"
},
"statusUpdate": {
"$ref": "#/$defs/TaskStatusUpdateEvent"
},
"artifactUpdate": {
"$ref": "#/$defs/TaskArtifactUpdateEvent"
}
},
"type": "object",
"$defs": {
"Artifact": {
"description": "Artifacts are the container for task completed results. These are similar to Messages but are intended to be the product of a task, as opposed to point-to-point communication.",
"properties": {
"artifactId": {
"description": "Unique identifier (e.g. UUID) for the artifact. It must be at least unique within a task.",
"type": "string"
},
"metadata": {
"description": "Optional metadata included with the artifact.",
"type": "object",
"additionalProperties": {
"description": "Properties of the object."
}
},
"parts": {
"type": "array",
"items": {
"$ref": "#/$defs/Part"
},
"description": "The content of the artifact."
},
"name": {
"type": "string",
"description": "A human readable name for the artifact."
},
"extensions": {
"items": {
"type": "string"
},
"type": "array",
"description": "The URIs of extensions that are present or contributed to this Artifact."
},
"description": {
"type": "string",
"description": "A human readable description of the artifact, optional."
}
},
"type": "object"
},
"DataPart": {
"properties": {
"data": {
"additionalProperties": {
"description": "Properties of the object."
},
"type": "object"
}
},
"description": "DataPart represents a structured blob. This is most commonly a JSON payload.",
"type": "object"
},
"FilePart": {
"properties": {
"name": {
"type": "string"
},
"fileWithBytes": {
"type": "string",
"format": "byte"
},
"mimeType": {
"type": "string"
},
"fileWithUri": {
"type": "string"
}
},
"description": "FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.",
"type": "object"
},
"Message": {
"type": "object",
"properties": {
"content": {
"items": {
"$ref": "#/$defs/Part"
},
"description": "protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.",
"type": "array"
},
"extensions": {
"items": {
"type": "string"
},
"type": "array",
"description": "The URIs of extensions that are present or contributed to this Message."
},
"role": {
"enum": [
"ROLE_UNSPECIFIED",
"ROLE_USER",
"ROLE_AGENT"
],
"description": "A role for the message.",
"type": "string"
},
"taskId": {
"description": "The task id of the message. This is optional and if set, the message will be associated with the given task.",
"type": "string"
},
"messageId": {
"description": "The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.",
"type": "string"
},
"contextId": {
"description": "The context id of the message. This is optional and if set, the message will be associated with the given context.",
"type": "string"
},
"metadata": {
"description": "protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.",
"type": "object",
"additionalProperties": {
"description": "Properties of the object."
}
}
},
"description": "Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id."
},
"Part": {
"description": "Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).",
"type": "object",
"properties": {
"text": {
"type": "string"
},
"metadata": {
"description": "Optional metadata associated with this part.",
"type": "object",
"additionalProperties": {
"description": "Properties of the object."
}
},
"file": {
"$ref": "#/$defs/FilePart"
},
"data": {
"$ref": "#/$defs/DataPart"
}
}
},
"Task": {
"type": "object",
"properties": {
"id": {
"description": "Unique identifier (e.g. UUID) for the task, generated by the server for a new task.",
"type": "string"
},
"status": {
"$ref": "#/$defs/TaskStatus",
"description": "The current status of a Task, including state and a message."
},
"metadata": {
"additionalProperties": {
"description": "Properties of the object."
},
"type": "object",
"description": "protolint:enable REPEATED_FIELD_NAMES_PLURALIZED A key/value object to store custom metadata about a task."
},
"contextId": {
"description": "Unique identifier (e.g. UUID) for the contextual collection of interactions (tasks and messages). Created by the A2A server.",
"type": "string"
},
"artifacts": {
"description": "A set of output artifacts for a Task.",
"type": "array",
"items": {
"$ref": "#/$defs/Artifact"
}
},
"history": {
"items": {
"$ref": "#/$defs/Message"
},
"description": "protolint:disable REPEATED_FIELD_NAMES_PLURALIZED The history of interactions from a task.",
"type": "array"
}
},
"description": "Task is the core unit of action for A2A. It has a current status and when results are created for the task they are stored in the artifact. If there are multiple turns for a task, these are stored in history."
},
"TaskArtifactUpdateEvent": {
"type": "object",
"properties": {
"append": {
"description": "Whether this should be appended to a prior one produced",
"type": "boolean"
},
"taskId": {
"description": "The id of the task for this artifact",
"type": "string"
},
"artifact": {
"$ref": "#/$defs/Artifact",
"description": "The artifact itself"
},
"contextId": {
"type": "string",
"description": "The id of the context that this task belongs too"
},
"lastChunk": {
"description": "Whether this represents the last part of an artifact",
"type": "boolean"
},
"metadata": {
"type": "object",
"description": "Optional metadata associated with the artifact update.",
"additionalProperties": {
"description": "Properties of the object."
}
}
},
"description": "TaskArtifactUpdateEvent represents a task delta where an artifact has been generated."
},
"TaskStatus": {
"description": "A container for the status of a task",
"type": "object",
"properties": {
"timestamp": {
"type": "string",
"format": "google-datetime",
"description": "Timestamp when the status was recorded. Example: \"2023-10-27T10:00:00Z\""
},
"state": {
"enum": [
"TASK_STATE_UNSPECIFIED",
"TASK_STATE_SUBMITTED",
"TASK_STATE_WORKING",
"TASK_STATE_COMPLETED",
"TASK_STATE_FAILED",
"TASK_STATE_CANCELLED",
"TASK_STATE_INPUT_REQUIRED",
"TASK_STATE_REJECTED",
"TASK_STATE_AUTH_REQUIRED"
],
"type": "string",
"description": "The current state of this task"
},
"message": {
"$ref": "#/$defs/Message",
"description": "A message associated with the status."
}
}
},
"TaskStatusUpdateEvent": {
"properties": {
"metadata": {
"description": "Optional metadata to associate with the task update.",
"additionalProperties": {
"description": "Properties of the object."
},
"type": "object"
},
"status": {
"$ref": "#/$defs/TaskStatus",
"description": "The new status of the task."
},
"taskId": {
"description": "The id of the task that is changed",
"type": "string"
},
"final": {
"description": "Whether this is the last status update expected for this task.",
"type": "boolean"
},
"contextId": {
"description": "The id of the context that the task belongs to",
"type": "string"
}
},
"type": "object",
"description": "TaskStatusUpdateEvent is a delta even on a task indicating that a task has changed."
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
curl "https://apis.io/api/v1/json-schemas/google-cloud-platform-stream-response"
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.