Get A2A Agent Card | Runtype Documentation

{
  "authentication": {
    "type": "none"
  },
  "capabilities": {
    "canHandleMultipleSessions": true,
    "supportsRichResponses": true,
    "maxConcurrentRequests": 5
  },
  "defaultInputModes": [
    "text",
    "voice"
  ],
  "defaultOutputModes": [
    "text",
    "audio"
  ],
  "description": "Runtype AI assistant surface enabling seamless integration with AI-driven automation capabilities.",
  "name": "Runtype AI Assistant",
  "protocolVersion": "1.0",
  "skills": [
    {
      "id": "skill-translate",
      "name": "Language Translation",
      "description": "Translate text between multiple languages in real-time.",
      "version": "2.3.1"
    },
    {
      "id": "skill-summarize",
      "name": "Text Summarization",
      "description": "Generate concise summaries of long documents.",
      "version": "1.4.0"
    }
  ],
  "url": "https://api.runtype.com/v1/products/ai-assistant/surfaces/web/a2a",
  "version": "1.0.0",
  "iconUrl": "https://runtype.com/assets/icons/agent-icon.png",
  "provider": {
    "organization": "Runtype Inc.",
    "url": "https://runtype.com"
  }
}

Public A2A Protocol Agent Card discovery endpoint describing an A2A surface and its skills. No authentication required.

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

$	curl https://api.runtype.com/v1/products/productId/surfaces/surfaceId/a2a/.well-known/agent-card.json \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json"