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

API ManagementCloud ComputingInfrastructurePlatform-as-a-ServiceA2A

Properties

Name Type Description
task object
message object
statusUpdate object
artifactUpdate object
View JSON Schema on GitHub

JSON Schema

google-cloud-platform-stream-response-schema.json Raw ↑
{
  "$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.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/google-cloud-platform-stream-response"
All schemas
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.