Support

Retrieve agent details

View as Markdown

Returns a single registered agent with trust explainability details.

Full description

Returns a single registered agent with trust explainability details. Search-only ranking scores are not included. Anonymous requests are accepted when the Authorization header is omitted and are rate limited to 60 requests per minute per client IP.

GET
/v1/ans/registered-agents/{agentId}

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

Path Parameters

agentId*string

Unique agent identifier.

Query Parameters

profile?string

Scoring profile name (default: default).

Header Parameters

X-Request-Id?string

Optional request identifier propagated across services.

Formatuuid

Response Body

*/*

*/*

*/*

*/*

*/*

*/*

*/*

*/*

*/*

*/*

*/*

curl -X GET "https://example.com/v1/ans/registered-agents/string"
{  "agentId": "string",  "indexedAt": "2019-08-24T14:15:22Z",  "leafIndex": 0,  "lifecycle": {    "status": "ACTIVE"  },  "agentDescription": "string",  "agentDisplayName": "string",  "agentHost": "string",  "agentVersion": "string",  "ansName": "string",  "logId": "string",  "providerId": "string",  "endpoints": [    {      "agentUrl": "string",      "documentationUrl": "string",      "metaDataUrl": "string",      "metaDataHash": "string",      "protocol": "A2A",      "transports": [        "HTTP"      ],      "functions": [        {          "id": "string",          "name": "string",          "tags": [            "string"          ]        }      ]    }  ],  "trustScore": 0,  "trustVector": {    "identity": 0,    "integrity": 0  },  "missingness": {    "requiredSignals": [      "string"    ],    "missingSignals": [      "string"    ],    "penalties": {      "identity": 0,      "integrity": 0    }  },  "coverage": {    "computedPillars": [      "string"    ],    "coverageRatio": 0.1  },  "signals": {    "property1": {      "computedAt": "2019-08-24T14:15:22Z",      "evidence": {},      "pillar": "string",      "score": 0,      "missing": true    },    "property2": {      "computedAt": "2019-08-24T14:15:22Z",      "evidence": {},      "pillar": "string",      "score": 0,      "missing": true    }  }}

Last updated on

How is this guide?