No description available.
Properties
A content identifier (CID) referencing immutable data.
One of BlobUnavailable, CidMismatch or FetchFailed.
No description available.
Known values: manifest, tile, parameter, notFound
A decentralized identifier (DID).
View raw schema
{
"type": "object",
"required": [
"cid",
"role",
"sourceDid",
"error"
],
"properties": {
"cid": {
"type": "string",
"format": "cid"
},
"role": {
"type": "string",
"knownValues": [
"manifest",
"tile",
"parameter",
"notFound"
]
},
"error": {
"type": "string",
"description": "One of BlobUnavailable, CidMismatch or FetchFailed."
},
"sourceDid": {
"type": "string",
"format": "did"
}
}
}
A base's default tile: what unclaimed names under it serve. The binding pins a CID, so a later version of the tile does not change what they serve.
Properties
How many names under the base are serving it now. Names whose subject has published their own site are not counted.
The tile's declared name, as it was when this was read.
When the base owner bound it.
The tile record's AT-URI.
View raw schema
{
"type": "object",
"required": [
"uri",
"cid"
],
"properties": {
"cid": {
"type": "string",
"format": "cid",
"description": "The pinned version."
},
"uri": {
"type": "string",
"format": "at-uri",
"description": "The tile record's AT-URI."
},
"name": {
"type": "string",
"description": "The tile's declared name, as it was when this was read."
},
"setAt": {
"type": "string",
"format": "datetime",
"description": "When the base owner bound it."
},
"appliedTo": {
"type": "integer",
"description": "How many names under the base are serving it now. Names whose subject has published their own site are not counted."
}
},
"description": "A base's default tile: what unclaimed names under it serve. The binding pins a CID, so a later version of the tile does not change what they serve."
}
Where a base's delegation stands. probing: the wildcard has not been shown to route yet. enabled: it has. routing-lapsed: the wildcard stopped routing for longer than the grace period, and names under the base are suspended until it routes again.
probing enabled routing-lapsed
View raw schema
{
"type": "string",
"description": "Where a base's delegation stands. probing: the wildcard has not been shown to route yet. enabled: it has. routing-lapsed: the wildcard stopped routing for longer than the grace period, and names under the base are suspended until it routes again.",
"knownValues": [
"probing",
"enabled",
"routing-lapsed"
]
}
What a base's owner has enabled and granted. Fields other than certMode are absent when they do not apply.
Properties
How names under the base get certificates. Every base starts as per-name.
Known values: per-name, wildcard
Where the base's _acme-challenge CNAME must point, exactly as the certificate issuer writes it. Present only while a wildcard grant is live.
The tile served on names under this base whose subject has not published a site. Absent when the base has set none.
When the live wildcard grant was made.
The most names the base can reserve.
A random name under the base, used to prove the wildcard routes.
maxLength: 253 bytes
Absent if the base has not enabled delegation.
When the base's wildcard certificate first appeared in certificate storage.
View raw schema
{
"type": "object",
"required": [
"certMode"
],
"properties": {
"state": {
"ref": "#delegationState",
"type": "ref",
"description": "Absent if the base has not enabled delegation."
},
"certMode": {
"type": "string",
"description": "How names under the base get certificates. Every base starts as per-name.",
"knownValues": [
"per-name",
"wildcard"
]
},
"maxNames": {
"type": "integer",
"description": "The most names the base can reserve."
},
"grantedAt": {
"type": "string",
"format": "datetime",
"description": "When the live wildcard grant was made."
},
"defaultTile": {
"ref": "#defaultTileView",
"type": "ref",
"description": "The tile served on names under this base whose subject has not published a site. Absent when the base has set none."
},
"probeHostname": {
"type": "string",
"maxLength": 253,
"description": "A random name under the base, used to prove the wildcard routes."
},
"challengeTarget": {
"type": "string",
"description": "Where the base's _acme-challenge CNAME must point, exactly as the certificate issuer writes it. Present only while a wildcard grant is live."
},
"wildcardObservedAt": {
"type": "string",
"format": "datetime",
"description": "When the base's wildcard certificate first appeared in certificate storage."
}
},
"description": "What a base's owner has enabled and granted. Fields other than certMode are absent when they do not apply."
}
No description available.
Properties
No description available.
An RFC 3339 formatted timestamp.
No description available.
Known values: domain, did, uri, cid, pattern, space
No description available.
No description available.
View raw schema
{
"type": "object",
"required": [
"subject",
"kind",
"createdAt"
],
"properties": {
"kind": {
"type": "string",
"knownValues": [
"domain",
"did",
"uri",
"cid",
"pattern",
"space"
]
},
"actor": {
"type": "string"
},
"reason": {
"type": "string"
},
"subject": {
"type": "string"
},
"createdAt": {
"type": "string",
"format": "datetime"
}
}
}
No description available.
Properties
Fully-qualified record name.
No description available.
Known values: ownership, certificate, traffic
No description available.
No description available.
No description available.
Known values: TXT, CNAME, ALIAS, ANAME, A, AAAA
No description available.
View raw schema
{
"type": "object",
"required": [
"type",
"name",
"value"
],
"properties": {
"ttl": {
"type": "integer"
},
"name": {
"type": "string",
"description": "Fully-qualified record name."
},
"type": {
"type": "string",
"knownValues": [
"TXT",
"CNAME",
"ALIAS",
"ANAME",
"A",
"AAAA"
]
},
"value": {
"type": "string"
},
"purpose": {
"type": "string",
"knownValues": [
"ownership",
"certificate",
"traffic"
]
},
"required": {
"type": "boolean"
}
}
}
No description available.
Properties
No description available.
An RFC 3339 formatted timestamp.
No description available.
No description available.
View raw schema
{
"type": "object",
"required": [
"event",
"createdAt"
],
"properties": {
"actor": {
"type": "string"
},
"event": {
"type": "string"
},
"detail": {
"type": "unknown"
},
"createdAt": {
"type": "string",
"format": "datetime"
}
}
}
No description available.
pending verifying verified active failed suspended released
View raw schema
{
"type": "string",
"knownValues": [
"pending",
"verifying",
"verified",
"active",
"failed",
"suspended",
"released"
]
}
No description available.
Properties
An RFC 3339 formatted timestamp.
A content identifier (CID) referencing immutable data.
No description available.
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
An RFC 3339 formatted timestamp.
For a name reserved under a delegation base: that base. In this case did is the identity the name was reserved for, not the base's owner.
For a base: what its owner has enabled and granted. Absent on any other domain.
A decentralized identifier (DID).
No description available.
No description available.
A validated record waiting to be committed, if there is one.
No description available.
Known values: preparing, pending-publication
No description available.
Known values: inline, tile
The space the domain is registered to. Absent for a domain registered to a DID. The record served is the space authority's.
No description available.
A content identifier (CID) referencing immutable data.
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
No description available.
No description available.
An RFC 3339 formatted timestamp.
View raw schema
{
"type": "object",
"required": [
"domain",
"did",
"status",
"createdAt"
],
"properties": {
"did": {
"type": "string",
"format": "did"
},
"tls": {
"ref": "#tlsStatus",
"type": "ref"
},
"space": {
"type": "string",
"format": "at-uri",
"description": "The space the domain is registered to. Absent for a domain registered to a DID. The record served is the space authority's."
},
"domain": {
"type": "string"
},
"status": {
"ref": "#domainStatus",
"type": "ref"
},
"tileCid": {
"type": "string",
"format": "cid"
},
"tileUri": {
"type": "string",
"format": "at-uri"
},
"activeCid": {
"type": "string",
"format": "cid"
},
"activeRev": {
"type": "string"
},
"activeUri": {
"type": "string",
"format": "at-uri"
},
"createdAt": {
"type": "string",
"format": "datetime"
},
"delegation": {
"ref": "#delegationView",
"type": "ref",
"description": "For a base: what its owner has enabled and granted. Absent on any other domain."
},
"entryCount": {
"type": "integer"
},
"pendingCid": {
"type": "string",
"format": "cid",
"description": "A validated record waiting to be committed, if there is one."
},
"sourceKind": {
"type": "string",
"knownValues": [
"inline",
"tile"
]
},
"totalBytes": {
"type": "integer"
},
"verifiedAt": {
"type": "string",
"format": "datetime"
},
"activatedAt": {
"type": "string",
"format": "datetime"
},
"pendingState": {
"type": "string",
"knownValues": [
"preparing",
"pending-publication"
]
},
"delegatedBase": {
"type": "string",
"description": "For a name reserved under a delegation base: that base. In this case did is the identity the name was reserved for, not the base's owner."
}
}
}
Whether bard's edge routes a serving hostname to this deployment. unknown: not probed yet, which is not a fault. routed: the probe reached this deployment's bard-origin. foreign: something else answered. unreachable: nothing answered. other-deployment: a different bard deployment answered. unproven: the answer looked like this deployment's but failed the reachability challenge, so something may be imitating it.
unknown routed foreign unreachable other-deployment unproven
View raw schema
{
"type": "string",
"description": "Whether bard's edge routes a serving hostname to this deployment. unknown: not probed yet, which is not a fault. routed: the probe reached this deployment's bard-origin. foreign: something else answered. unreachable: nothing answered. other-deployment: a different bard deployment answered. unproven: the answer looked like this deployment's but failed the reachability challenge, so something may be imitating it.",
"knownValues": [
"unknown",
"routed",
"foreign",
"unreachable",
"other-deployment",
"unproven"
]
}
What this deployment's edge answered for a hostname, probed over the network. A site can be indexed and active while the edge has nowhere to send it, and only this field shows that.
Properties
When the probe was made. Absent when status is unknown.
What answered, as a status line or a transport error. Meant for people; do not branch on it.
The hostname that was probed.
maxLength: 253 bytes
No description available.
View raw schema
{
"type": "object",
"required": [
"status",
"domain"
],
"properties": {
"detail": {
"type": "string",
"description": "What answered, as a status line or a transport error. Meant for people; do not branch on it."
},
"domain": {
"type": "string",
"maxLength": 253,
"description": "The hostname that was probed."
},
"status": {
"ref": "#edgeReachStatus",
"type": "ref"
},
"checkedAt": {
"type": "string",
"format": "datetime",
"description": "When the probe was made. Absent when status is unknown."
}
},
"description": "What this deployment's edge answered for a hostname, probed over the network. A site can be indexed and active while the edge has nowhere to send it, and only this field shows that."
}
No description available.
preparing pending-publication expired queued fetching materializing active superseded rejected failed
View raw schema
{
"type": "string",
"knownValues": [
"preparing",
"pending-publication",
"expired",
"queued",
"fetching",
"materializing",
"active",
"superseded",
"rejected",
"failed"
]
}
No description available.
Properties
No description available.
No description available.
An RFC 3339 formatted timestamp.
No description available.
No description available.
An RFC 3339 formatted timestamp.
An RFC 3339 formatted timestamp.
No description available.
No description available.
View raw schema
{
"type": "object",
"required": [
"id",
"uri",
"action",
"state",
"attempts",
"scheduledAt"
],
"properties": {
"id": {
"type": "integer"
},
"uri": {
"type": "string"
},
"state": {
"type": "string"
},
"action": {
"type": "string"
},
"attempts": {
"type": "integer"
},
"lastError": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "datetime"
},
"finishedAt": {
"type": "string",
"format": "datetime"
},
"scheduledAt": {
"type": "string",
"format": "datetime"
}
}
}
One malware detection. It is recorded before anything is denied or deleted, because quarantine destroys the sample.
Properties
The content address, or `-` for a detection at upload, when nothing was stored.
`unwanted` is a PUA match. Under the default policy, the response stops short of the publishing identity.
Known values: malware, unwanted
The repository the bytes came from. For a tile resource, that is the tile's author, not the site owner. Absent for content bard authored.
The hostname the content would have been served at.
An RFC 3339 formatted timestamp.
The finding's ID. The matching denylist entry's reason refers to it.
The manifest path the bytes were mapped to, which identifies the file. Absent when there is no path: the notFound resource, an upload refused before any record referenced it, or a rescan.
When the response finished. Absent while it is still underway: the content is denied but may still be served.
The signature name, exactly as the scanner reported it.
Where the detection happened. `rescan`: the content was clean on arrival and a newer signature caught it. `admin`: an operator asked for this CID to be scanned.
Known values: fetch, upload, rescan, admin
The record that referenced the content.
View raw schema
{
"type": "object",
"required": [
"id",
"cid",
"signature",
"class",
"source",
"foundAt"
],
"properties": {
"id": {
"type": "integer",
"description": "The finding's ID. The matching denylist entry's reason refers to it."
},
"cid": {
"type": "string",
"description": "The content address, or `-` for a detection at upload, when nothing was stored."
},
"did": {
"type": "string",
"format": "did",
"description": "The repository the bytes came from. For a tile resource, that is the tile's author, not the site owner. Absent for content bard authored."
},
"uri": {
"type": "string",
"format": "at-uri",
"description": "The record that referenced the content."
},
"path": {
"type": "string",
"description": "The manifest path the bytes were mapped to, which identifies the file. Absent when there is no path: the notFound resource, an upload refused before any record referenced it, or a rescan."
},
"class": {
"type": "string",
"description": "`unwanted` is a PUA match. Under the default policy, the response stops short of the publishing identity.",
"knownValues": [
"malware",
"unwanted"
]
},
"domain": {
"type": "string",
"description": "The hostname the content would have been served at."
},
"source": {
"type": "string",
"description": "Where the detection happened. `rescan`: the content was clean on arrival and a newer signature caught it. `admin`: an operator asked for this CID to be scanned.",
"knownValues": [
"fetch",
"upload",
"rescan",
"admin"
]
},
"foundAt": {
"type": "string",
"format": "datetime"
},
"signature": {
"type": "string",
"description": "The signature name, exactly as the scanner reported it."
},
"quarantinedAt": {
"type": "string",
"format": "datetime",
"description": "When the response finished. Absent while it is still underway: the content is denied but may still be served."
}
},
"description": "One malware detection. It is recorded before anything is denied or deleted, because quarantine destroys the sample."
}
No description available.
Properties
A content identifier (CID) referencing immutable data.
No description available.
Known values: manifest, tile, parameter, notFound
A decentralized identifier (DID).
View raw schema
{
"type": "object",
"required": [
"cid",
"role",
"sourceDid"
],
"properties": {
"cid": {
"type": "string",
"format": "cid"
},
"role": {
"type": "string",
"knownValues": [
"manifest",
"tile",
"parameter",
"notFound"
]
},
"sourceDid": {
"type": "string",
"format": "did"
}
}
}
No description available.
Properties
A content identifier (CID) referencing immutable data.
An RFC 3339 formatted timestamp.
No description available.
No description available.
No description available.
No description available.
Known values: preparing, pending-publication, expired
View raw schema
{
"type": "object",
"required": [
"state",
"cid",
"fetched",
"pending",
"failed"
],
"properties": {
"cid": {
"type": "string",
"format": "cid"
},
"state": {
"type": "string",
"knownValues": [
"preparing",
"pending-publication",
"expired"
]
},
"failed": {
"type": "array",
"items": {
"ref": "#blobFailure",
"type": "ref"
}
},
"fetched": {
"type": "integer"
},
"pending": {
"type": "integer"
},
"expiresAt": {
"type": "string",
"format": "datetime"
}
}
}
No description available.
Properties
An RFC 3339 formatted timestamp.
A content identifier (CID) referencing immutable data.
A decentralized identifier (DID).
No description available.
No description available.
No description available.
Known values: inline, tile
Present for a site published from a space.
No description available.
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
View raw schema
{
"type": "object",
"required": [
"domain",
"did",
"uri",
"cid",
"rev",
"activatedAt",
"sourceKind"
],
"properties": {
"cid": {
"type": "string",
"format": "cid"
},
"did": {
"type": "string",
"format": "did"
},
"rev": {
"type": "string"
},
"uri": {
"type": "string",
"format": "at-uri"
},
"tile": {
"ref": "#tileView",
"type": "ref"
},
"space": {
"type": "string",
"format": "at-uri",
"description": "Present for a site published from a space."
},
"domain": {
"type": "string"
},
"sourceKind": {
"type": "string",
"knownValues": [
"inline",
"tile"
]
},
"activatedAt": {
"type": "string",
"format": "datetime"
}
}
}
No description available.
Properties
A decentralized identifier (DID).
An RFC 3339 formatted timestamp.
A content identifier (CID) referencing immutable data.
No description available.
Known values: record.created, record.updated, record.deleted, site.activated, site.deactivated, tile.ready, tile.incomplete, tile.deleted, access.granted, access.expired, registration.renewed, registration.lapsed, app-not-allowed, space.deleted
No description available.
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
No description available.
View raw schema
{
"type": "object",
"required": [
"seq",
"space",
"kind",
"at"
],
"properties": {
"at": {
"type": "string",
"format": "datetime"
},
"cid": {
"type": "string",
"format": "cid"
},
"seq": {
"type": "integer"
},
"kind": {
"type": "string",
"knownValues": [
"record.created",
"record.updated",
"record.deleted",
"site.activated",
"site.deactivated",
"tile.ready",
"tile.incomplete",
"tile.deleted",
"access.granted",
"access.expired",
"registration.renewed",
"registration.lapsed",
"app-not-allowed",
"space.deleted"
]
},
"actor": {
"type": "string",
"format": "did"
},
"space": {
"type": "string",
"format": "at-uri"
},
"subject": {
"type": "string"
}
}
}
No description available.
connecting syncing synced credential-expired registration-lapsed app-not-allowed authority-unreachable deleted disconnected
View raw schema
{
"type": "string",
"knownValues": [
"connecting",
"syncing",
"synced",
"credential-expired",
"registration-lapsed",
"app-not-allowed",
"authority-unreachable",
"deleted",
"disconnected"
]
}
No description available.
Properties
When bard's current credential for the space expires. Absent if bard holds none.
A decentralized identifier (DID).
No description available.
Known values: open, allow-list, unknown
A decentralized identifier (DID).
An RFC 3339 formatted timestamp.
No description available.
No description available.
An RFC 3339 formatted timestamp.
An RFC 3339 formatted timestamp.
No description available.
Known values: public, member-list, managing-app, unknown
Notification receipts waiting for a credential.
An RFC 3339 formatted timestamp.
No description available.
No description available.
No description available.
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
View raw schema
{
"type": "object",
"required": [
"uri",
"authority",
"skey",
"syncState",
"connectedAt"
],
"properties": {
"uri": {
"type": "string",
"format": "at-uri"
},
"skey": {
"type": "string"
},
"policy": {
"type": "string",
"knownValues": [
"public",
"member-list",
"managing-app",
"unknown"
]
},
"headRev": {
"type": "string"
},
"appAccess": {
"type": "string",
"knownValues": [
"open",
"allow-list",
"unknown"
]
},
"authority": {
"type": "string",
"format": "did"
},
"syncState": {
"ref": "#spaceSyncState",
"type": "ref"
},
"tileCount": {
"type": "integer"
},
"connectedAt": {
"type": "string",
"format": "datetime"
},
"domainCount": {
"type": "integer"
},
"lastCheckedAt": {
"type": "string",
"format": "datetime"
},
"lastNotifiedAt": {
"type": "string",
"format": "datetime"
},
"accessExpiresAt": {
"type": "string",
"format": "datetime",
"description": "When bard's current credential for the space expires. Absent if bard holds none."
},
"accessGrantedBy": {
"type": "string",
"format": "did"
},
"queuedNotifications": {
"type": "integer",
"description": "Notification receipts waiting for a credential."
},
"registrationExpiresAt": {
"type": "string",
"format": "datetime"
}
}
}
No description available.
Properties
A content identifier (CID) referencing immutable data.
No description available.
A decentralized identifier (DID).
No description available.
The author's handle, present only if it resolves back to did. Often absent, for example right after a handle change or when DNS is unreachable. Show did instead.
https://highport.space/xrpc/space.highport.sites.getTileIcon?cid={cid}; absent if the tile has no icon.
An RFC 3339 formatted timestamp.
The newest indexed version at this URI, when it differs from cid.
No description available.
No description available.
Present for a space tile. Never shown on the public surface.
No description available.
Known values: indexing, ready, incomplete, rejected, suspended, deleted
No description available.
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
View raw schema
{
"type": "object",
"required": [
"uri",
"cid",
"did",
"name",
"state",
"indexedAt"
],
"properties": {
"cid": {
"type": "string",
"format": "cid"
},
"did": {
"type": "string",
"format": "did"
},
"uri": {
"type": "string",
"format": "at-uri"
},
"name": {
"type": "string"
},
"space": {
"type": "string",
"format": "at-uri",
"description": "Present for a space tile. Never shown on the public surface."
},
"state": {
"type": "string",
"knownValues": [
"indexing",
"ready",
"incomplete",
"rejected",
"suspended",
"deleted"
]
},
"handle": {
"type": "string",
"format": "handle",
"description": "The author's handle, present only if it resolves back to did. Often absent, for example right after a handle change or when DNS is unreachable. Show did instead."
},
"params": {
"type": "array",
"items": {
"ref": "space.highport.sites.tile#param",
"type": "ref"
}
},
"iconUrl": {
"type": "string",
"format": "uri",
"description": "https://highport.space/xrpc/space.highport.sites.getTileIcon?cid={cid}; absent if the tile has no icon."
},
"indexedAt": {
"type": "string",
"format": "datetime"
},
"latestCid": {
"type": "string",
"format": "cid",
"description": "The newest indexed version at this URI, when it differs from cid."
},
"entryCount": {
"type": "integer"
},
"totalBytes": {
"type": "integer"
},
"description": {
"type": "string"
}
}
}
No description available.
none pending issued renewing failed
View raw schema
{
"type": "string",
"knownValues": [
"none",
"pending",
"issued",
"renewing",
"failed"
]
}
No description available.
Properties
An RFC 3339 formatted timestamp.
An RFC 3339 formatted timestamp.
No description available.
No description available.
View raw schema
{
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"ref": "#tlsStatus",
"type": "ref"
},
"issuedAt": {
"type": "string",
"format": "datetime"
},
"expiresAt": {
"type": "string",
"format": "datetime"
},
"lastError": {
"type": "string"
}
}
}
No description available.
Properties
No description available.
A validation error name, such as DuplicatePath, RedirectTargetNotFound or ParameterTypeMismatch.
JSON Pointer to the field or entry the error is about, if there is one.
View raw schema
{
"type": "object",
"required": [
"name",
"message"
],
"properties": {
"name": {
"type": "string",
"description": "A validation error name, such as DuplicatePath, RedirectTargetNotFound or ParameterTypeMismatch."
},
"path": {
"type": "string",
"description": "JSON Pointer to the field or entry the error is about, if there is one."
},
"message": {
"type": "string"
}
}
}
No description available.
Properties
An RFC 3339 formatted timestamp.
No description available.
No description available.
Known values: ownership, traffic, conflict, certificate
No description available.
View raw schema
{
"type": "object",
"required": [
"name",
"passed",
"checkedAt"
],
"properties": {
"name": {
"type": "string",
"knownValues": [
"ownership",
"traffic",
"conflict",
"certificate"
]
},
"detail": {
"type": "string"
},
"passed": {
"type": "boolean"
},
"checkedAt": {
"type": "string",
"format": "datetime"
}
}
}
No description available.
Properties
No description available.
An RFC 3339 formatted timestamp.
No description available.
View raw schema
{
"type": "object",
"required": [
"status",
"checks"
],
"properties": {
"checks": {
"type": "array",
"items": {
"ref": "#verificationCheck",
"type": "ref"
}
},
"status": {
"ref": "#domainStatus",
"type": "ref"
},
"lastCheckedAt": {
"type": "string",
"format": "datetime"
}
}
}