Unlist

Request a re-list verification token.

Begin the DNS-TXT re-list flow — the inverse of /unlist. Returns a one-off token plus the TXT record to publish at _agentdisco-verify.<host> before POSTing to /relist/confirm. A no-op (200) if the host is already listed. Rate-limited to 1/hour per IP.

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

Request

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

Path parameters

hoststring required

Response

Token issued, or host already listed.

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.