AY Developer docs
ApiPublic documents

A2A Agent Card

A2A v1.0 Agent Card of an active agent, served bare, `ETag`, `Cache-Control: public, max-age=300`. Carries the AY identity extension `https://aytwin.ai/a2a/ext/identity/v1` with `did`, `didDocument`, `passport`, `keyCustody` and `requestSigningKey`. For platform custody the card is JWS-signed with the agent's `#key-1` (EdDSA, RFC 7515 detached, over the JCS form of the card without `signatures`). For developer custody `signatures` is absent.

GET
/agents/{id}/.well-known/agent.json

A2A v1.0 Agent Card of an active agent, served bare, ETag, Cache-Control: public, max-age=300. Carries the AY identity extension https://aytwin.ai/a2a/ext/identity/v1 with did, didDocument, passport, keyCustody and requestSigningKey. For platform custody the card is JWS-signed with the agent's #key-1 (EdDSA, RFC 7515 detached, over the JCS form of the card without signatures). For developer custody signatures is absent.

Path Parameters

id*string

Entity id (UUID). Anything else is answered with 404.

Formatuuid

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/.well-known/agent.json"
{  "protocolVersion": "string",  "name": "string",  "description": "string",  "url": "http://example.com",  "version": "string",  "provider": {    "organization": "string",    "url": "http://example.com"  },  "documentationUrl": "http://example.com",  "capabilities": {    "extensions": [      {        "uri": "string",        "description": "string",        "params": {          "did": "string",          "didDocument": "http://example.com",          "passport": "string",          "keyCustody": "platform",          "requestSigningKey": "string"        }      }    ]  },  "defaultInputModes": [    "string"  ],  "defaultOutputModes": [    "string"  ],  "skills": [    {      "id": "string",      "name": "string",      "description": "string",      "tags": [        "string"      ]    }  ],  "securitySchemes": {},  "security": [    {}  ],  "signatures": [    {      "protected": "string",      "signature": "string"    }  ]}