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
| Page | Content |
|---|---|
| Core Protocol Specification | The 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 Structures | Field reference for Task, Message, Part, Artifact, streaming events, push notification configs, AgentCard, and security schemes |
| Agent Discovery and the Agent Card | Discovery mechanisms, supportedInterfaces selection and the tenant rule, Agent Card signing (JWS + JCS), and caching requirements |
| Authentication, Authorization, and Security Considerations | TLS and client authentication, authorization scoping, in-task authorization (TASK_STATE_AUTH_REQUIRED), push notification and extended Agent Card security, best practices |
| Protocol Bindings in Detail | Service 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 Examples | Request 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.protois 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
- Build the big picture first: What is A2A? and Key Concepts .
- See how to implement it: the Python Quickstart and SDKs and Tools .
- How A2A divides the work with MCP and cooperates with it: A2A and MCP .