Register a new agent with the ANS

Full description

Registers a new agent with the Agent Name Service. Supports GoDaddy domains (synchronous, CSR-based), external domains (async ACME), and bring-your-own-certificate (BYOC, server certificates only). Returns 202 with registration status and any validation requirements.

Request Body

application/json

Agent registration request

Registration request

agentDescription?string

Description of the agent

Lengthlength <= 150

agentDisplayName*string

Human-readable display name for the agent

Lengthlength <= 64

agentHost*string

The fully qualified domain name (FQDN) where the agent is hosted

Lengthlength <= 253

endpoints*array<>

Array of agent endpoints with protocol-specific configuration

Items1 <= items

identityCsrPEM*string

Base64 encoded PEM certificate signing request (CSR).

serverCertificateChainPEM?string

Optional - Base64 encoded PEMs of cert-chain of a server certificate. When this field is present, serverCertificatePEM must be specified. Both fields are used when client chooses BYOC for server certificate.

serverCertificatePEM?string

Base64 encoded PEM server certificate. Required when BYOC is used for server certificate.

serverCsrPEM?string

Base64 encoded PEM certificate signing request (CSR). Required when not using BYOC

version*string

Semantic Versioning format (major.minor.patch)

Match^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$

Response Body

`application/json`

curl -X POST "https://example.com/v1/agents/register" \  -H "Content-Type: application/json" \  -d '{    "agentDisplayName": "Sentiment Analyzer",    "agentHost": "myagent.example.com",    "endpoints": [      {        "agentUrl": "https://myagent.example.com/mcp",        "metaDataUrl": "https://myagent.example.com/.well-known/mcp.json",        "documentationUrl": "https://docs.myagent.example.com",        "protocol": "MCP",        "transports": [          "STREAMABLE-HTTP"        ],        "functions": [          {            "id": "domain_suggest",            "name": "Domain Suggest",            "tags": [              "domain",              "suggestion",              "availability"            ]          }        ]      }    ],    "identityCsrPEM": "string",    "version": "1.2.0"  }'

{  "agentId": "550e8400-e29b-41d4-a716-446655440000",  "ansName": "ans://v1.0.0.external-domain.com",  "challenge": {    "dnsRecord": {      "name": "_acme-challenge.external-domain.com",      "type": "TXT",      "value": "xyz123abc456"    },    "keyAuthorization": "xyz123abc456.thumbprint",    "token": "xyz123abc456",    "type": "DNS_01"  },  "expiresAt": "2025-11-13 16:30:00+00:00",  "links": [    {      "href": "https://api.godaddy.com/v1/agents/550e8400-e29b-41d4-a716-446655440000/challenge",      "rel": "challenge"    }  ],  "nextSteps": [    {      "action": "CONFIGURE_DNS",      "description": "Configure DNS TXT record for ACME validation",      "endpoint": "https://api.godaddy.com/v1/agents/550e8400-e29b-41d4-a716-446655440000/verify-acme"    }  ],  "status": "PENDING_VALIDATION"}

Last updated on

Register a new agent with the ANS

Request Body

Response Body

202application/json

401application/json

403application/json

409application/json

422application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`