CustomDomain™ docs
API referenceAgents

Read a pending agent authorization, for the consent screen

GET
/agent/consent-request/{id}

What the console shows a signed in owner before they approve an agent: the client's name, where its authorization code would go (redirect_host), whether that destination is a known assistant's own (verified, verified_as) or the person's own computer (local), whether the name imitates a brand it does not belong to (imitates; such a request cannot be approved), how the client identified itself, and the scopes asked for. The unguessable request id is the capability: it needs no other credential and reveals only this.

Path Parameters

id*string

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/agent/consent-request/string"
{  "client_id": "string",  "client_name": "string",  "redirect_uri": "string",  "scopes": [    "domains:read"  ],  "state": "string",  "redirect_host": "string",  "verified": true,  "verified_as": "string",  "local": true,  "imitates": "string",  "registration": "dynamic",  "registered_at": "2019-08-24T14:15:22Z",  "client_id_host": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}