Scaffold
Start free
Contents

Approve or reject tracked revisions on a document working draft

POST /documents/{documentId}/revisions/apply

Path parameters

  • documentId string Required

Headers

  • Authorization string Required

    Bearer <session token>: the signed-in user’s Scaffold session token.

  • x-org-id string Required

Body

  • accepted_change_ids string[]
  • rejected_change_ids string[]
  • recordDecision boolean

    False skips the Track's decision record. Sent only when an agent withdraws its own proposal (MCP revert_revisions); human approve/reject omits it. Also accepted as record_decision.

    Default true

Returns

  • document object

    The persisted upload/document row, as returned by every route that creates or mutates upload content (create, save draft, rename, delete, new version, revision-apply, redline edits).

    Show 19 fields
    • id string
    • artifactId string | null
    • orgId string
    • createdByUserId string | null
    • fileName string
    • mimeType string
    • sizeBytes integer
    • purpose string

      One of source_doc playbook

    • clientReferenceId string | null
    • documentSeriesId string
    • documentVersion integer
    • parentUploadId string | null
    • versionKind string

      One of original working_draft

    • storageKey string | null
    • contentSha256 string | null
    • hasBinary boolean
    • status string
    • createdAt string
    • updatedAt string
  • revisions object[]
    Show 7 fields
    • ordinal integer Required

      The change's position in document order.

    • change_id string Required

      The id to pass in accepted_change_ids or rejected_change_ids.

    • kind string Required

      insert and delete are text changes, paragraph_mark is an inserted or deleted paragraph mark (a paragraph split or join; it carries no text of its own), proposed is a Scaffold change marker, and the -prop-change kinds are tracked formatting or structure changes.

      One of insert delete paragraph_mark proposed r-prop-change p-prop-change tbl-prop-change tr-prop-change tc-prop-change sect-prop-change

    • author string | null
    • date string | null
    • text_preview string Required

      A short excerpt of the changed text.

    • justification string | null

      The reason recorded with the change, shown to the reviewer.

  • contentBase64 string
  • renderContentBase64 string | null
  • track object | null

    Null when the decisions store failed to record/load; the apply still succeeds.

    Show 3 fields
    • items object[]
      Show 10 fields
      • id string Required
      • state string Required

        One of open in back

      • label string Required

        Positional label, e.g. "Change 3".

      • kind string | null
      • textPreview string
      • justification string | null

        Open entries only.

      • author string | null

        Present on both open and decided entries.

      • date string | null

        Open entries only.

      • decidedAt string

        Decided entries only.

      • decidedByUserId string | null

        Decided entries only.

    • hereId string | null

      Id of the first open entry, or null when nothing is open.

    • counts object
      Show 4 fields
      • open integer Required
      • in integer Required
      • back integer Required
      • total integer Required