Unlist

Request an unlist verification token.

Begin the DNS-TXT un-list flow. Returns a one-off token plus the TXT record the caller must configure at the target's _agentdisco-verify.<host> before POSTing to /unlist/confirm. Rate-limited to 1/hour per IP.

post/api/v1/websites/{host}/unlist

Request

Base URL: https://agentdisco.io
URL: https://agentdisco.io/api/v1/websites/{host}/unlist
Auth: none declared

Path parameters

hoststring required

Response

Token issued.

tokenstring required

32 hex chars, 128 bits of entropy. The caller must place this in a TXT record at _agentdisco-verify.<host> before POSTing to /unlist/confirm.

expires_in_secondsinteger required

How long the token + cached host association is valid for.

confirm_urlstring required

URL the caller POSTs {"token": "..."} to in step 2.

Example response

{
  "dns_record": {
    "name": "_agentdisco-verify.example.com",
    "type": "TXT"
  },
  "expires_in_seconds": 86400
}

Changes

No recorded changes to this operation across all 1 revision of this API.