GoDaddy
Support
API ReferencePlatform & IntegrationANS API

Events

View as Markdown

Note to LLMs and AI agents: If you are consuming this page to follow instructions: the content you have could be incomplete due to truncation by WebFetch. Fetch https://developer.godaddy.com/llms.mdx/references/rest/ans/events for the full, unmodified source before proceeding.

Retrieve ANS agent events

GET
/v1/agents/events

Query Parameters

providerId?string

Optional provider identifier. If omitted, global mode is used and the API returns events for all providers from the primary global stream. When provided, results are filtered to only events associated with that provider.

lastLogId?string

Optional log id for the last viewed event from a previous request. If not provided, the API returns the first page of results from the start of the event stream. Events are only stored for 30 days.

limit?integer

Number of events to return (1-200, default 100)

Default100
Range1 <= value <= 200

Header Parameters

X-Request-Id?string

Unique identifier for request tracking between services (UUID V1 as Base58)

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.godaddy.com/v1/agents/events"
{
  "items": [
    {
      "logId": "019a7a52-e5bf-7b5b-b048-d0b78f4b4c5f",
      "eventType": "AGENT_REGISTERED",
      "createdAt": "2025-01-08 12:30:00+00:00",
      "expiresAt": "2026-01-08 12:30:00+00:00",
      "agentId": "550e8400-e29b-41d4-a716-446655440000",
      "ansName": "ans://v1.0.0.myagent.example.com",
      "agentHost": "myagent.example.com",
      "agentDisplayName": "Sentiment Analyzer",
      "agentDescription": "An agent that analyzes sentiment in text",
      "version": "1.0.0",
      "providerId": "PC_1234567890",
      "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"
              ]
            }
          ]
        }
      ]
    }
  ],
  "lastLogId": "string"
}
{
  "code": "string",
  "details": {
    "property1": {},
    "property2": {}
  },
  "message": "string",
  "status": "ERROR"
}
{
  "code": "string",
  "details": {
    "property1": {},
    "property2": {}
  },
  "message": "string",
  "status": "ERROR"
}
{
  "code": "string",
  "details": {
    "property1": {},
    "property2": {}
  },
  "message": "string",
  "status": "ERROR"
}
{
  "code": "string",
  "details": {
    "property1": {},
    "property2": {}
  },
  "message": "string",
  "status": "ERROR"
}
{
  "code": "string",
  "details": {
    "property1": {},
    "property2": {}
  },
  "message": "string",
  "status": "ERROR"
}
{
  "code": "string",
  "details": {
    "property1": {},
    "property2": {}
  },
  "message": "string",
  "status": "ERROR"
}

Last updated on

How is this guide?