A2A Protocol Specification

This section organizes the A2A specification from the whole to the details across six reference pages: the layering and core operations first, then the fields of the data structures and how agents are discovered, then security, the details of each protocol binding, and worked request and response examples. The verbatim, authoritative text is the official specification and a2a.proto.

Reading order

PageContent
Core Protocol SpecificationThe three-layer model, the 11 core operations and their mapping across the three bindings, SendMessage behavior, multi-turn identifier rules, errors and error codes, service parameters, and version negotiation
Data StructuresField reference for Task, Message, Part, Artifact, streaming events, push notification configs, AgentCard, and security schemes
Agent Discovery and the Agent CardDiscovery mechanisms, supportedInterfaces selection and the tenant rule, Agent Card signing (JWS + JCS), and caching requirements
Authentication, Authorization, and Security ConsiderationsTLS and client authentication, authorization scoping, in-task authorization (TASK_STATE_AUTH_REQUIRED), push notification and extended Agent Card security, best practices
Protocol Bindings in DetailService parameters, errors, and streaming in the JSON-RPC, gRPC, and HTTP+JSON/REST bindings, and the application/a2a+json, A2A-Version, A2A-Extensions, and agent-card.json registration templates
Common Workflows and ExamplesRequest and response examples: basic tasks, streaming, multi-turn, task listing, push notifications, file and structured data exchange, the extended Agent Card

Versions and the normative source

  • The current stable version is v1.0, and the latest patch release is v1.0.1 (2026-05-28). The protocol version is identified only by Major.Minor; patch versions do not affect protocol compatibility.
  • a2a.proto is the single authoritative definition of all protocol objects and request/response messages. JSON Schema and the SDKs for each language are generated from it.
  • The full official text is the a2a-protocol.org specification . Earlier versions: v0.3.0 , v0.2.6 , v0.1.0 .
  • To upgrade from v0.3, read What Changed in v1.0 and How to Migrate .

Read alongside