Create Revision

Create a new draft revision for a blob. The blob’s default revision moves to it immediately.

POST `/blobs/:org_id/:blob_id/revisions`

Requires Write access to the blob. The default revision must be in commit phase — a blob with a draft already default has nothing to branch from, since a blob has at most one draft.

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.

Request Body

Parameter	Type	Required	Description
`comment`	string	Yes	1–200 characters. No other field is accepted.

Response

Parameter	Type	Description
`revision_id`	string	The unique ID of the new revision.

The row is created before the org’s revisions_per_blob limit is charged, so a request that fails after the row exists — the limit check, or handing the row to the async worker that provisions its content — deletes it or marks it failed rather than leaving a charged, unusable slot.

Errors

Status	Error	Cause
400	`invalid_request_body`	`comment` is missing, empty, over 200 characters, or an extra field was sent.
403	`forbidden`	The blob is absent, not visible to this key, or the key lacks Write access.
409	`blob_not_ready`	The blob is being created or deleted.
409	`default_revision_not_committed`	The default revision is not in `commit` phase — most often because it is already the draft.
400	`limit_exceeded`	The blob already holds the maximum number of revisions.

Example

curl -X POST https://api.blobhub.io/v1/blobs/org_123/blob_789/revisions \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"comment": "add the refund branch"}'

{
  "status": "success",
  "revision_id": "rev_002"
}

REST API

WebSocket API

Create Revision

POST `/blobs/:org_id/:blob_id/revisions`

Path Parameters

Request Body

Response

Errors

Example

See also

​POST /blobs/:org_id/:blob_id/revisions

​Path Parameters

​Request Body

​Response

​Errors

​Example

​See also

POST `/blobs/:org_id/:blob_id/revisions`

Path Parameters

Request Body

Response

Errors

Example

See also