Commit Revision

Seal a draft: its content and its runtime both become frozen. Every open session on the revision is closed, which drains its running executions, before the revision lands at commit / ready. From that point the phase is enforced on the write path itself, not only at this edge, so nothing already running can land in it.

POST `/revisions/:id/commit`

Requires Write access to the revision’s blob. Allowed only on the draft phase, status ready — there is no retry for a failed commit. A commit that failed left the revision draft / failed; recover it with Reset back to ready and call Commit again, rather than calling Commit on a failed revision directly.

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	The unique ID of the revision.

Request Body

Parameter	Type	Required	Description
`comment`	string	No	1–200 characters. Replaces the revision’s comment in the same write; omit it to keep the existing one.

Response

Returns {"status": "success"} — no body beyond the status. The revision moves to committing synchronously and finishes asynchronously; poll Get Revision for status to return to ready (committed) or failed.

Errors

Status	Error	Cause
400	`invalid_request_body`	`comment` is present and empty, over 200 characters, or an extra field was sent.
404	`revision_not_found`	The id is unknown, or the caller cannot reach its blob.
403	`forbidden`	The revision’s blob is not visible to this key, or the key lacks Write access.
409	`blob_not_ready`	The blob is being created or deleted.
409	`revision_not_writable`	The revision’s phase is not `draft` (already `commit`, or `managed`).
409	`revision_not_ready`	The revision’s status is not `ready` — including `failed`: reset first.

Example

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

{
  "status": "success"
}

REST API

WebSocket API

Commit Revision

POST `/revisions/:id/commit`

Path Parameters

Request Body

Response

Errors

Example

See also

​POST /revisions/:id/commit

​Path Parameters

​Request Body

​Response

​Errors

​Example

​See also

POST `/revisions/:id/commit`

Path Parameters

Request Body

Response

Errors

Example

See also