Lexicon Garden

space.highport.manage.setDelegationDefaultTile

Set or clear the tile served on every name reserved under a delegation base whose subject has not yet published a site. The tile is pinned by CID and takes no parameters, so a tile with a required parameter is refused. It never answers /.well-known/atproto-did, which keeps returning the DID the name is reserved for. The base owner pays for the traffic. The caller must own the base, which must have delegation enabled.

Repository @lexicons.highport.space did:plc:ciygg5hma4q7ah2kxaszkyob namespace authority
Details · procedure
Kindprocedure
Authoritymanage.highport.space
Indexed
Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

domain

requiredstring

The base: a domain registered to the caller, with delegation enabled.

  • maxLength: 253

tile

ref

The tile to serve, pinning the exact version. Absent clears the default, and the names go back to answering only /.well-known/atproto-did.

Reference

Output

application/json

defaultTile

ref

The stored binding. Absent when the default was cleared.

Reference

domain

requiredstring

queued

requiredinteger

How many reserved names the change was queued for. Names whose subject has already published are not included; their own site keeps serving.

Errors

InvalidDomain

Not a syntactically valid domain.

NotBaseOwner

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

DelegationNotEnabled

The domain is not a delegation base. Enable delegation before setting a default tile.

DefaultTilesUnsupported

This deployment does not offer default tiles.

TileNotFound

No tile is known at that URI and CID. A tile is bindable once this service has indexed it.

TileNotReady

The tile is known but not ready: it is still indexing, its resources are incomplete, or it has been suspended.

TileNotPublic

The tile belongs to a space. A space's tiles are private to it and cannot be served on a reserved name.

TileRequiresParameters

The tile declares a required parameter. A default tile is bound with no parameters and nothing can supply one, so only a tile whose parameters are all optional can be a default. The error message names the parameters.

TileClaimsReservedPath

The tile's content defines an entry at /.well-known/atproto-did. That path resolves the handle of the identity the name is reserved for, and a default tile may not answer it.

Similar lexicons

semantic match

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

  • space.highport.manage.reserveDomain

    procedure

    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.

  • space.highport.manage.enableDelegation

    procedure

    Make a registered domain a delegation base, so its owner can reserve names directly under it for other identities. Returns the wildcard record that routes those names. The caller must own the base, and it must be verified or active.