Resolve an ANSName to an endpoint

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.

Request Body

application/json

ANSName resolution request

agentHost*string

Target agent host domain

Lengthlength <= 253

version*string

A Semantic Version range, which is defined to match a set of allowable versions for a software package, following the rules of Semantic Versioning (SemVer). It uses specific operators and formats to express dependencies, - like ^1.2.3 (allowing compatible updates within major version 1) - or ~1.2.3 (allowing compatible patch updates). - wildcard '*' or empty string '' means any version can be matched, it will resolve to the latest version available.

Response Body

`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

Resolve an ANSName to an endpoint

Request Body

Response Body

200application/json

401application/json

403application/json

404application/json

422application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`