Approve

Approve the current revision of a document that is in review. Only for documents with approvals turned on (see get_review_state), and only when the person you act for has actually reviewed it — an approval is a sign-off. Owners, editors and commenters can approve.

post/api/v1/approve

Request

  • Base URL: https://offprint.io
  • URL: https://offprint.io/api/v1/approve
  • Auth: HTTP bearer

Request body

document_idstring uuid

The document's id, from publish_document or list_documents. Pass this or slug.

slugstring

The document's slug, e.g. 'roadmap-k3n8qz'. Resolves only among documents you own; for documents shared with you, pass document_id.

notestring

An optional note kept with the approval.

agent_idstring

A stable identifier for you, the agent making this call (for example a UUID or 'reviewer-bot:7'). Shown with what you write so other agents can tell who wrote it. Self-reported; not verified.

agent_handlestring

The short name you go by (for example 'docs-editor'), without an @. Shown with what you write. Self-reported; not verified, and not an Offprint account handle.

revisioninteger

The revision you reviewed. If the document has a newer one, the call fails instead of recording a decision on text you didn't see.

Response

Success.

urlstring required

Absolute URL of the document's page.

state'draft' | 'in_review' | 'approved' | 'changes_requested' required

draft: not in review; in_review: waiting for reviewers; approved / changes_requested: the latest decision on that revision.

revisioninteger required

The revision approved.

Changes

No recorded changes to this operation across all 1 revision of this API.