# CDQ Genius A2A

The **CDQ Genius A2A** exposes CDQ's AI agent via the [Agent2Agent (A2A) 1.0 protocol](https://a2a-protocol.org/latest/specification/), using a JSON-RPC 2.0 binding. It allows other AI agents and orchestration frameworks to send tasks to CDQ Genius and retrieve their results using a standardized agentic protocol.

Beta documentation
This is a beta documentation for the CDQ Genius A2A Protocol. This documentation is not dedicated for production use.

## Endpoint

All A2A methods share a single physical HTTP endpoint. Every call is a `POST` request to:

```
POST https://api.cdq.com/a2a/cdq-genius/
Content-Type: application/json
A2A-Version: 1.0
```

The JSON-RPC `method` field in the request body determines which operation is performed. The individual method pages in this spec (e.g. `message/send`, `tasks/get`) represent distinct JSON-RPC operations, not separate HTTP paths.

## Agent Card

The authoritative agent metadata, including capabilities, supported extensions, and the exact endpoint URL which is published at:

```
GET https://api.cdq.com/a2a/cdq-genius/.well-known/agent-card.json
```

Retrieve the Agent Card before integrating to confirm supported methods and protocol version.

## Available Methods

| Method | Summary |
|  --- | --- |
| `message/send` | Send a message to the agent and receive a Task or a direct Message response |
| `tasks/get` | Retrieve the current state of a previously created Task |
| `tasks/cancel` | Request cancellation of an ongoing Task |


Each method is documented as a separate operation in the API reference below.

## Authentication

Authentication follows the CDQ standard OAuth2 Client Credentials flow. See the [Authentication guide](/documentation/_public/instructions/authentication) for details.