diff --git a/agent-os/interfaces/a2a/introduction.mdx b/agent-os/interfaces/a2a/introduction.mdx
index 2de62555f..af98cde6e 100644
--- a/agent-os/interfaces/a2a/introduction.mdx
+++ b/agent-os/interfaces/a2a/introduction.mdx
@@ -75,9 +75,15 @@ For each available agent, team and workflow, the following A2A-compatible endpoi
   See [API reference](/reference-api/schema/a2a/stream-message-agent) and [A2A protocol docs](https://a2a-protocol.org/v0.3.0/specification/#356-method-mapping-reference-table).
 
 - `/a2a/agents/{id}/v1/message:send`:
-  Runs the agen, returning the response in A2A format (non-streaming).
+  Runs the agent, returning the response in A2A format (non-streaming).
   See [A2A protocol docs](https://a2a-protocol.org/v0.3.0/specification/#356-method-mapping-reference-table).
 
+- `/a2a/agents/{id}/v1/tasks:get`:
+  Retrieves task status by ID. See [API reference](/reference-api/schema/a2a/get-agent-task).
+
+- `/a2a/agents/{id}/v1/tasks:cancel`:
+  Cancels a running task. See [API reference](/reference-api/schema/a2a/cancel-agent-task).
+
 
 ### Teams
 
@@ -90,6 +96,12 @@ For each available agent, team and workflow, the following A2A-compatible endpoi
 - `/a2a/teams/{id}/v1/message:send`:
   Runs the team, returning the response in A2A format (non-streaming). See [API reference](/reference-api/schema/a2a/run-message-agent).
 
+- `/a2a/teams/{id}/v1/tasks:get`:
+  Retrieves task status by ID. See [API reference](/reference-api/schema/a2a/get-team-task).
+
+- `/a2a/teams/{id}/v1/tasks:cancel`:
+  Cancels a running task. See [API reference](/reference-api/schema/a2a/cancel-team-task).
+
 ### Workflows
 
 - `/a2a/workflows/{id}/.well-known/agent-card.json`:
diff --git a/reference-api/schema/a2a/send-message.mdx b/reference-api/schema/a2a/send-message.mdx
index a2914c8c0..5d65a8014 100644
--- a/reference-api/schema/a2a/send-message.mdx
+++ b/reference-api/schema/a2a/send-message.mdx
@@ -1,3 +1,9 @@
 ---
 openapi: post /a2a/message/send
----
\ No newline at end of file
+---
+
+<Warning>
+This generic endpoint is deprecated. Use the per-resource endpoints instead:
+`/a2a/agents/{id}/v1/message:send`, `/a2a/teams/{id}/v1/message:send`, or
+`/a2a/workflows/{id}/v1/message:send`.
+</Warning>
diff --git a/reference-api/schema/a2a/stream-message.mdx b/reference-api/schema/a2a/stream-message.mdx
index e204992f1..a520c0809 100644
--- a/reference-api/schema/a2a/stream-message.mdx
+++ b/reference-api/schema/a2a/stream-message.mdx
@@ -1,3 +1,9 @@
 ---
 openapi: post /a2a/message/stream
----
\ No newline at end of file
+---
+
+<Warning>
+This generic endpoint is deprecated. Use the per-resource endpoints instead:
+`/a2a/agents/{id}/v1/message:stream`, `/a2a/teams/{id}/v1/message:stream`, or
+`/a2a/workflows/{id}/v1/message:stream`.
+</Warning>
diff --git a/reference/clients/a2a-client.mdx b/reference/clients/a2a-client.mdx
index 32da6b31f..ee5e61fe1 100644
--- a/reference/clients/a2a-client.mdx
+++ b/reference/clients/a2a-client.mdx
@@ -86,6 +86,7 @@ print(f"Context ID: {result.context_id}")
 | `videos` | `Optional[List[Video]]` | `None` | Videos to include |
 | `files` | `Optional[List[File]]` | `None` | Files to include |
 | `metadata` | `Optional[Dict[str, Any]]` | `None` | Additional metadata |
+| `headers` | `Optional[Dict[str, str]]` | `None` | Extra HTTP headers to send with the request |
 
 **Returns:** `TaskResult`
 
@@ -129,6 +130,12 @@ if card:
     print(f"Capabilities: {card.capabilities}")
 ```
 
+**Parameters:**
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `headers` | `Optional[Dict[str, str]]` | `None` | Extra HTTP headers to send with the request |
+
 **Returns:** `AgentCard` if available, `None` otherwise
 
 ---
@@ -144,6 +151,12 @@ if card:
     print(f"Capabilities: {card.capabilities}")
 ```
 
+**Parameters:**
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `headers` | `Optional[Dict[str, str]]` | `None` | Extra HTTP headers to send with the request |
+
 **Returns:** `AgentCard` if available, `None` otherwise
 
 ## Response Types