Per-blob progress of a publish. Give exactly one of uri or domain. The top level describes the active revision, or the prepared record if nothing is active yet. A newer record prepared while another is active appears under preparation.
Parameters
Output
application/jsonactivatedAt
stringdatetime
Optional
An RFC 3339 formatted timestamp.
cid
stringcid
Optional
A content identifier (CID) referencing immutable data.
edge
refspace.highport.defs#edgeReachability
Optional
Whether the edge routes this site's hostname to bard. Present only for a domain-backed record. An active index state says nothing about routing: a fully indexed site can still have its requests answered by something else. Treat unknown as no opinion.
entryCount
integer
Optional
No description available.
errors
array
Required
No description available.
failed
array
Required
Blobs that could not be fetched. Each includes sourceDid and role, which makes it clear when re-uploading will not help, such as a BlobUnavailable on a tile blob.
fetched
integer
Optional
Blobs fetched and checked against their CIDs so far.
pending
integer
Optional
Blobs still to fetch.
preparation
refspace.highport.defs#preparationStatus
Optional
A validated record waiting to be committed, while the domain still serves an earlier revision.
rev
string
Optional
The commit revision of the indexed record.
state
refspace.highport.defs#indexState
Required
No description available.
Errors
RecordNotFound
Bard has no record at that URI or domain. NotOwner
The record does not belong to the caller. For a tile URI, the caller must be the tile's repo. SpaceNotFound
The URI is in space form and names a space bard does not serve, or one the caller is not in. Both cases get the same error, so it cannot be used to probe membership. Try It
Requests are sent directly from your browser. Some servers may block requests due to CORS.
View raw schema
{
"type": "query",
"errors": [
{
"name": "RecordNotFound",
"description": "Bard has no record at that URI or domain."
},
{
"name": "NotOwner",
"description": "The record does not belong to the caller. For a tile URI, the caller must be the tile's repo."
},
{
"name": "SpaceNotFound",
"description": "The URI is in space form and names a space bard does not serve, or one the caller is not in. Both cases get the same error, so it cannot be used to probe membership."
}
],
"output": {
"schema": {
"type": "object",
"required": [
"state",
"failed",
"errors"
],
"properties": {
"cid": {
"type": "string",
"format": "cid"
},
"rev": {
"type": "string",
"description": "The commit revision of the indexed record."
},
"edge": {
"ref": "space.highport.defs#edgeReachability",
"type": "ref",
"description": "Whether the edge routes this site's hostname to bard. Present only for a domain-backed record. An active index state says nothing about routing: a fully indexed site can still have its requests answered by something else. Treat unknown as no opinion."
},
"state": {
"ref": "space.highport.defs#indexState",
"type": "ref"
},
"errors": {
"type": "array",
"items": {
"ref": "space.highport.defs#validationError",
"type": "ref"
}
},
"failed": {
"type": "array",
"items": {
"ref": "space.highport.defs#blobFailure",
"type": "ref"
},
"description": "Blobs that could not be fetched. Each includes sourceDid and role, which makes it clear when re-uploading will not help, such as a BlobUnavailable on a tile blob."
},
"fetched": {
"type": "integer",
"description": "Blobs fetched and checked against their CIDs so far."
},
"pending": {
"type": "integer",
"description": "Blobs still to fetch."
},
"entryCount": {
"type": "integer"
},
"activatedAt": {
"type": "string",
"format": "datetime"
},
"preparation": {
"ref": "space.highport.defs#preparationStatus",
"type": "ref",
"description": "A validated record waiting to be committed, while the domain still serves an earlier revision."
}
}
},
"encoding": "application/json"
},
"parameters": {
"type": "params",
"properties": {
"uri": {
"type": "string",
"format": "at-uri",
"description": "The record's AT-URI, in public or space form. Mutually exclusive with domain."
},
"domain": {
"type": "string",
"maxLength": 253,
"description": "The site's hostname. Mutually exclusive with uri."
}
}
},
"description": "Per-blob progress of a publish. Give exactly one of uri or domain. The top level describes the active revision, or the prepared record if nothing is active yet. A newer record prepared while another is active appears under preparation."
}