Skip to main content
POST
/
assets
/
agents:validate
Validate Agent Card
curl --request POST \
  --url https://api.example.com/assets/agents:validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "version": "<string>",
  "description": "<string>",
  "url": "<string>",
  "protocolVersion": "<string>",
  "supportedInterfaces": [
    {
      "url": "<string>",
      "protocolVersion": "<string>",
      "protocolBinding": "<string>",
      "transportType": "<string>"
    }
  ],
  "provider": {},
  "capabilities": {},
  "skills": [
    {}
  ],
  "defaultInputModes": [
    "<string>"
  ],
  "defaultOutputModes": [
    "<string>"
  ],
  "securitySchemes": {},
  "security": [
    {}
  ],
  "extensions": [
    {}
  ],
  "signatures": [
    {}
  ]
}
'
{
  "valid": true,
  "errors": [],
  "warnings": []
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-Project-ID
string | null

Body

application/json

A2A Agent Card JSON — supports both v0.3 and v1.0 formats.

v0.3 cards have a required top-level url and optional supportedInterfaces. v1.0 cards have required supportedInterfaces and no top-level url. The validator ensures at least one transport declaration is present.

​
name
string
required
Required string length: 1 - 255
​
version
string
required
​
description
string | null
Maximum string length: 2000
​
url
string | null
​
protocolVersion
string | null
​
supportedInterfaces
A2AInterface · object[] | null
​
provider
Provider · object
​
capabilities
Capabilities · object
​
skills
Skills · object[] | null
​
defaultInputModes
string[] | null
​
defaultOutputModes
string[] | null
​
securitySchemes
Securityschemes · object
​
security
Security · object[] | null
​
extensions
Extensions · object[] | null
​
signatures
Signatures · object[] | null

Response

Successful Response

Response from dry-run validation endpoint.

​
valid
boolean
required
​
errors
Errors · object[]
​
warnings
Warnings · object[]