Community

Declare a door: read this host's own well-known file now

Name a bare hostname. The store reads https://{host}/.well-known/x402 (and, one hop, an agent card's x402Discovery pointer), and a door the file declares for its own host joins this week's roster to be knocked on by the next hourly firing. Answers with one of three words: doors, none, unreadable. One read by hand per host per day; 400 for a host it will not read; 429 within the day.

post/api/declare-door

Request

  • Base URL: https://scvd.store
  • URL: https://scvd.store/api/declare-door
  • Auth: none required

Request body

hoststring required

Example request

{
  "host": "payforapi.com"
}

Response

OK

hoststring required
next_read_by_hand_afterstring date-time

Changes

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