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": []
}

Documentation Index

Fetch the complete documentation index at: https://docs.emergence.ai/llms.txt

Use this file to discover all available pages before exploring further.

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[]