space.highport.manage.releaseReservation

Release a name reserved under one of the caller's delegation bases: stop answering for it, and stop authorizing it at the TLS permission endpoint. The subject's site, if it published one, stops serving.

Details · procedure
Kindprocedure
Authoritymanage.highport.space
Indexed

Showing version bafyreidskmcl7bm54nmv74fkfih4d3ie6bdzddxenqoeeopww3ih3fhweq. Show the latest

Procedure

procedure · POST

Input

application/json

hostname

requiredstring

The reserved name.

  • maxLength: 253

Output

application/json

released

requiredboolean

Errors

NotBaseOwner

The name is not under a base whose verified or active registration belongs to the caller.

ReservationNotFound

No reservation exists at that hostname. An ordinary registration, and the base's probe, are not reservations.

Similar lexicons

semantic match

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

  • Stop a base handing out names: remove its probe and clear its delegation state. Refused while any reservation remains; release each one with releaseReservation. A certificate grant on the base is left in place.

  • Release a domain: deactivate its site and stop authorizing it for TLS. Certificates already issued for it stay valid until they expire. If the domain is a base with a wildcard grant, the grant ends and the wildcard is revoked and deleted; no account can take the domain until that finishes. Stored blobs are left for garbage collection.

  • 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.

  • Forget a space: release its domains, purge them after the usual grace period, discard the credential and key, and stop renewing. Authority only.

  • 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.