For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
User GuideDeveloper GuidesAPI Reference
User GuideDeveloper GuidesAPI Reference
    • Overview
  • Runtype API
      • STREAMA2A JSON-RPC endpoint
      • GETGet A2A Agent Card
      • GETGet A2A surface info
Dashboard
LogoLogo
Runtype APIA2a

Get A2A Agent Card

GET
/v1/products/:productId/surfaces/:surfaceId/a2a/.well-known/agent-card.json
GET
/v1/products/:productId/surfaces/:surfaceId/a2a/.well-known/agent-card.json
$curl https://api.runtype.com/v1/products/productId/surfaces/surfaceId/a2a/.well-known/agent-card.json \
>     -H "Authorization: <apiKey>" \
>     -H "Content-Type: application/json"
1{
2  "authentication": {
3    "type": "none"
4  },
5  "capabilities": {
6    "canHandleMultipleSessions": true,
7    "supportsRichResponses": true,
8    "maxConcurrentRequests": 5
9  },
10  "defaultInputModes": [
11    "text",
12    "voice"
13  ],
14  "defaultOutputModes": [
15    "text",
16    "audio"
17  ],
18  "description": "Runtype AI assistant surface enabling seamless integration with AI-driven automation capabilities.",
19  "name": "Runtype AI Assistant",
20  "protocolVersion": "1.0",
21  "skills": [
22    {
23      "id": "skill-translate",
24      "name": "Language Translation",
25      "description": "Translate text between multiple languages in real-time.",
26      "version": "2.3.1"
27    },
28    {
29      "id": "skill-summarize",
30      "name": "Text Summarization",
31      "description": "Generate concise summaries of long documents.",
32      "version": "1.4.0"
33    }
34  ],
35  "url": "https://api.runtype.com/v1/products/ai-assistant/surfaces/web/a2a",
36  "version": "1.0.0",
37  "iconUrl": "https://runtype.com/assets/icons/agent-icon.png",
38  "provider": {
39    "organization": "Runtype Inc.",
40    "url": "https://runtype.com"
41  }
42}
Public A2A Protocol Agent Card discovery endpoint describing an A2A surface and its skills. No authentication required.
Was this page helpful?
Previous

Get A2A surface info

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

productIdstringRequired
surfaceIdstringRequired

Response

Agent Card
authenticationobject
capabilitiesobject
defaultInputModeslist of strings
defaultOutputModeslist of strings
descriptionstring
namestring
protocolVersionstring
skillslist of objects
urlstring
versionstring
iconUrlstring
providerobject

Errors

404
Not Found Error
500
Internal Server Error