Skip to main content
This guide walks through the recommended v1 flow: discover the Agent Card, fetch the authenticated extended card, execute a task, inspect the request ID, stream updates, and register a task webhook.

Prerequisites

  • A Clix project created at console.clix.so
  • A Secret API Key prefixed with clix_sk_
  • An HTTP client that can send JSON and read SSE
/a2a accepts only Secret API Keys. Public keys and browser-exposed keys are rejected.

Base URL

Step 1: Read the Public Agent Card

The public Agent Card requires no authentication.
Look for these v1 fields in the response:

Step 2: Fetch the Authenticated Extended Card

GetExtendedAgentCard is an authenticated JSON-RPC method on /a2a.
The current Clix implementation returns the same v1 Agent Card schema as the public card, with a project-aware description.

Step 3: Send Your First Task

This example runs the create-user skill synchronously with SendMessage.
Important request fields: Important response header: Example response excerpt:

Step 4: Stream Status Updates with SSE

Use SendStreamingMessage when you want task progress over Server-Sent Events.
Current built-in Clix skills emit JSON-RPC SSE envelopes like:

Step 5: Read the Task Later

You can re-read the task directly or list tasks for a context.
ListTasks returns tasks, nextPageToken, pageSize, and totalSize. On follow-up cursor requests, the current Clix implementation returns totalSize: 0, so capture the first page if you need the total count.

Step 6: Register a Task Webhook

Task push notifications are webhooks for task lifecycle events.
Clix will call your webhook with a JSON-RPC request whose method is tasks/pushNotification and whose event payload is inside params.result.

Authentication Errors

If authentication fails, /a2a returns HTTP errors instead of a JSON-RPC method result.

Next Steps

API Reference

Review every method, data type, and error code

Advanced Features

See webhook payloads, SSE behavior, and idempotency details

Skills

Pick the exact payload shape for each built-in skill