space.highport.manage.listReservations

Names reserved under one of the caller's delegation bases, with who each is reserved for and whether it routes. The base's probe is not included.

Details · query
Kindquery
Authoritymanage.highport.space
Indexed

Query

query · GET

Parameters

query string

cursor

string

Pagination cursor from a previous response.

domain

requiredstring

The base domain.

  • maxLength: 253

limit

integer

Maximum entries to return.

  • minimum: 1
  • maximum: 100
  • default: 50

Output

application/json

cursor

string

Present when more entries exist.

reservations

requiredarray
itemsref
Reference

Errors

NotBaseOwner

No verified or active registration of that domain belongs to the caller.

#reservationView

object

One reserved name.

Properties

domain

requiredref

The reservation's registration. did is the identity it is reserved for, and delegatedBase is the base.

edge

ref

Whether the name still routes to this service's edge. A name can stop routing while its base still routes, if a record for that name in the base's zone overrides the wildcard.

Whether this name is serving the base's default tile. False when the base has set none, and false once the subject publishes a site of their own, which replaces it.

takenUpAt

string · datetime

When this service first saw the subject use the name as its handle (its DID document lists at://<domain> and the name resolves back). Set once, and kept even if the handle later changes or the check fails. Absent before then. Releasing the name clears it.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • Reserve a name directly under a delegation base for another identity. The name answers /.well-known/atproto-did with the subject right away, and the subject can then publish a site there. The caller must own the base. Any unproven claim on the name is replaced. Repeating the call for the same subject returns the existing reservation and does not count against maxNames. Reservations last as long as the base.

  • The caller's registrations: domains it registered itself, and domains registered to spaces it is the authority of.

  • Domains registered to a space, with each one's state. Available to the authority and viewers.

  • Release a name reserved under one of the caller's delegation bases. Bard stops answering for it and stops authorizing it for TLS, and any site the subject published there stops serving.