org.tangled.repo.listRecordVersions

tangled.org

Documentation

Every version of a record this knot hosts, oldest first unless order says otherwise. A version's bytes are fetched by content id through com.atproto.sync.getBlocks.

main query

Every version of a record this knot hosts, oldest first unless order says otherwise. A version's bytes are fetched by content id through com.atproto.sync.getBlocks.

Parameters

cursor string Optional

Pagination cursor

limit integer Optional

No description available.

order string Optional

asc lists the oldest version first, desc the newest.

uri string at-uri Required

Record in a repo this knot hosts

Output

Encodingapplication/json
cursor string Optional

Cursor for the next page, left out when the page already reaches the newest version

uri stringat-uri Required

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

versions array Required

No description available.

Errors

InvalidRequest The uri isn't an at-uri, or the collection isn't versioned
NotFound No such record on this knot
ProjectionWarming The record's change history is still being folded; retry shortly
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Pagination cursor
asc lists the oldest version first, desc the newest.
Record in a repo this knot hosts
View raw schema
{
  "description": "Every version of a record this knot hosts, oldest first unless order says otherwise. A version's bytes are fetched by content id through com.atproto.sync.getBlocks.",
  "errors": [
    {
      "description": "The uri isn't an at-uri, or the collection isn't versioned",
      "name": "InvalidRequest"
    },
    {
      "description": "No such record on this knot",
      "name": "NotFound"
    },
    {
      "description": "The record's change history is still being folded; retry shortly",
      "name": "ProjectionWarming"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "cursor": {
          "description": "Cursor for the next page, left out when the page already reaches the newest version",
          "type": "string"
        },
        "uri": {
          "format": "at-uri",
          "type": "string"
        },
        "versions": {
          "items": {
            "ref": "#version",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "required": [
        "uri",
        "versions"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "cursor": {
        "description": "Pagination cursor",
        "type": "string"
      },
      "limit": {
        "default": 100,
        "maximum": 500,
        "minimum": 1,
        "type": "integer"
      },
      "order": {
        "default": "asc",
        "description": "asc lists the oldest version first, desc the newest.",
        "knownValues": [
          "asc",
          "desc"
        ],
        "type": "string"
      },
      "uri": {
        "description": "Record in a repo this knot hosts",
        "format": "at-uri",
        "type": "string"
      }
    },
    "required": [
      "uri"
    ],
    "type": "params"
  },
  "type": "query"
}
version object

No description available.

Properties

changeId string Required

Object ID of the git change that produced this version

cid string cid Optional

Content id of this version. Missing when the version was removed or the change is a deletion.

createdAt string datetime Required

When this knot wrote the commit this version rides in. Not the record's own `createdAt`.

editor string did Required

The account that authored the change

View raw schema
{
  "properties": {
    "changeId": {
      "description": "Object ID of the git change that produced this version",
      "type": "string"
    },
    "cid": {
      "description": "Content id of this version. Missing when the version was removed or the change is a deletion.",
      "format": "cid",
      "type": "string"
    },
    "createdAt": {
      "description": "When this knot wrote the commit this version rides in. Not the record's own `createdAt`.",
      "format": "datetime",
      "type": "string"
    },
    "editor": {
      "description": "The account that authored the change",
      "format": "did",
      "type": "string"
    }
  },
  "required": [
    "changeId",
    "editor",
    "createdAt"
  ],
  "type": "object"
}

Lexicon Garden

@