Home

Approve a version (or withdraw approval)

Changed on

Records that the caller approved a version — the live one unless versionId is given. Approvals are a record shown in History and Details, not a publish gate. Needs comment access (owner, collaborator, internal member of a workspace- or public-visible artifact, or a comment grant). The only REST path for approvals; session cookie or Bearer token.

post/v1/home/approvals

Request

  • Base URL
    https://shareout.site
  • URL
    https://shareout.site/v1/home/approvals
  • Auth
    HTTP bearer

Request body

artifactIdstring required
versionIdstring

A version id (ver_…); defaults to the live version.

approvedboolean

false withdraws the caller's approval.

Response

Review state after the change

live_version_idstring nullable
live_version_nointeger nullable
can_reviewboolean

Caller may resolve, assign and approve.

my_approvalsstring[]

Version ids the caller (any linked account) approved.

Changes