Resolve Revision - BlobHub

Retrieve one revision, scoped to a specific blob. This is the route to follow a blob’s default revision without first reading the blob record for its pointer.

GET `/blobs/:org_id/:blob_id/revisions/:ref`

Requires Read access to the blob.

Path Parameters

Parameter	Type	Required	Description
`org_id`	string	Yes	The unique ID of the organization.
`blob_id`	string	Yes	The unique ID or alias of the blob.
`ref`	string	Yes	A revision id, or the literal `default` for whatever the blob’s `default_revision_id` currently names.

Response

Parameter	Type	Description
`revision`	object	The revision, in the same shape as List Revisions.

ref is resolved against this blob_id specifically: a revision id belonging to another blob answers the same revision_not_found as one that does not exist at all, so this route cannot be used to read a revision through a blob the caller merely has access to.

Errors

Status	Error	Cause
403	`forbidden`	The blob is absent or not visible to this key.
409	`blob_not_ready`	The blob is being created or deleted.
404	`revision_not_found`	`ref` is `default` and the blob has no `default_revision_id` yet, `ref` names an unknown revision, or it names a revision belonging to a different blob.

Example

curl -X GET https://api.blobhub.io/v1/blobs/org_123/blob_789/revisions/default

{
  "status": "success",
  "revision": {
    "id": "rev_002",
    "blob_id": "blob_789",
    "parent_id": "rev_001",
    "comment": "add the refund branch",
    "user_id": "usr_a1b2c3d4",
    "created_at": "2026-07-14T09:12:03Z",
    "updated_at": "2026-07-14T09:12:05Z",
    "status": "ready",
    "phase": "draft"
  }
}

See also

Get Revision — the id-only equivalent, for when the blob is not at hand.
List Revisions — every revision of the blob, paged.