GoDaddy
Support
API ReferenceIntegrationANS APIResolve an ANSName to an endpoint POST

Resolve an ANSName to an endpoint

View as Markdown

Resolves an ANSName to an actionable endpoint reference.

Full description

| Resolves an ANSName to an actionable endpoint reference. The query includes the ANSName of the target agent and can optionally incorporate capability filters to refine the search. The ANS service queries the Agent Registry, which returns a digitally signed endpoint record if found.

POST
/v1/agents/resolution

Authorization

AuthorizationBearer <token>

GoDaddy OAuth 2.0 access token sent as Authorization: Bearer <token>. The scope(s) listed on each operation are enforced per-operation. A token requires at least one of the scopes listed for that operation; ans.agent-registration:write implies ans.agent-registration:read on every ANS operation. Scopes do not apply to API key authentication.

In: header

Scope: ans.agent-registration:read

Request Body

application/json

ANSName resolution request

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/agents/resolution" \  -H "Content-Type: application/json" \  -d '{    "agentHost": "myagent.example.com",    "version": "1.0.0"  }'
{  "ansName": "ans://v1.0.0.myagent.example.com",  "links": [    {      "href": "https://api.godaddy.com/v1/agents/550e8400-e29b-41d4-a716-446655440000",      "rel": "agent-details"    },    {      "href": "https://myagent.example.com/api/v1",      "rel": "agent-endpoint"    }  ]}

Last updated on

How is this guide?