Update Revision - BlobHub

Change a revision’s comment.

PATCH `/revisions/:id`

Requires Write access to the revision’s blob. Allowed on a draft or managed revision whose status is ready — a commit revision is frozen, and neither axis is negotiable through this route.

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. No other field is accepted. An empty body is accepted and changes nothing.

Response

Returns {"status": "success"} — no body beyond the status.

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, the caller cannot reach its blob, or the row was deleted between the read and the write.
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 `commit`.
409	`revision_not_ready`	The revision’s status is not `ready` (`creating`, `committing`, `deleting` or `failed`).

Example

{
  "comment": "final version for release"
}

{
  "status": "success"
}