{
"id": "space.highport.manage.listReservations",
"defs": {
"main": {
"type": "query",
"errors": [
{
"name": "NotBaseOwner",
"description": "No verified or active registration of that domain belongs to the caller."
}
],
"output": {
"schema": {
"type": "object",
"required": [
"reservations"
],
"properties": {
"cursor": {
"type": "string",
"description": "Present when more entries exist."
},
"reservations": {
"type": "array",
"items": {
"ref": "#reservationView",
"type": "ref"
}
}
}
},
"encoding": "application/json"
},
"parameters": {
"type": "params",
"required": [
"domain"
],
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1,
"description": "Maximum entries to return."
},
"cursor": {
"type": "string",
"description": "Pagination cursor from a previous response."
},
"domain": {
"type": "string",
"maxLength": 253,
"description": "The base."
}
}
},
"description": "The names reserved under one of the caller's delegation bases, with the identity each is reserved for and whether it routes. The base's probe is not listed."
},
"reservationView": {
"type": "object",
"required": [
"domain"
],
"properties": {
"edge": {
"ref": "space.highport.defs#edgeReachability",
"type": "ref",
"description": "Whether the name still routes to this service's edge. A name can stop routing while its base does not, when a record for that name in the base's zone takes it out of wildcard coverage."
},
"domain": {
"ref": "space.highport.defs#domainView",
"type": "ref",
"description": "The reservation's registration. did is the subject, and delegatedBase is the base."
},
"takenUpAt": {
"type": "string",
"format": "datetime",
"description": "When this service first observed the subject holding the name as its handle: the subject's DID document names at://<domain> as its handle, and the name resolves back to the subject. Recorded once for this reservation and kept when the subject later changes its handle or the check stops passing. Absent until then, which is also what a name looks like before this service has checked it. Releasing the name ends it, so a later reservation of the same name, for any subject, starts without it."
}
},
"description": "One reserved name."
}
},
"$type": "com.atproto.lexicon.schema",
"lexicon": 1
}