GoDaddy ANS Developer Documentation
Complete guide to building verifiable, discoverable AI agents using the Agent Name Service (ANS) Registry.
Key Information
- Base URL (Production): https://api.godaddy.com/
- Base URL (OTE/Testing): https://api.ote-godaddy.com/
- Authentication: sso-key token via Authorization header
- API Keys: Create at developer.godaddy.com
- Supported Protocols: MCP, A2A, HTTP-API
- Contact: GDANS@GoDaddy.com
ANS Name Format
ANS names follow the format: ans://v{version}.{agentHost}
Example: ans://v1.0.0.myagent.example.com
Registration Process
- Submit registration via POST /v1/agents/register with agent metadata and CSRs
- Complete domain validation (automated for GoDaddy domains, ACME DNS-01 for external)
- Receive server and identity certificates
- DNS records provisioned (automated for GoDaddy domains, manual for external)
- Transparency log entry created -- agent is ACTIVE
API Endpoints
- GET /v1/agents -- Search the ANSName Registry
- POST /v1/agents/register -- Register a new agent
- GET /v1/agents/{agentId} -- Get agent details
- POST /v1/agents/resolution -- Resolve ANSName to endpoint
- POST /v1/agents/{agentId}/verify-acme -- Trigger ACME validation
- POST /v1/agents/{agentId}/verify-dns -- Verify DNS records
- POST /v1/agents/{agentId}/revoke -- Revoke certificate
- GET /v1/agents/{agentId}/certificates/identity -- Get identity certificates
- POST /v1/agents/{agentId}/certificates/identity -- Submit identity CSR
- GET /v1/agents/{agentId}/certificates/server -- Get server certificates
- POST /v1/agents/{agentId}/certificates/server -- Submit server CSR
- GET /v1/agents/{agentId}/csrs/{csrId}/status -- Get CSR status
- GET /v1/agents/events -- Retrieve agent events
Documentation
For complete documentation in Markdown format, see:
Contact: GDANS@GoDaddy.com | IETF Spec: https://www.ietf.org/id/draft-narajala-ans-00.html