ApprovalItem

Object

docxDocumentVersionId

approver

ID of the approver (user, placeholder, external user, or team). Use this value as the approvalItemId when calling changeApprovalStageApprover to replace this approver with someone else.

status

Current approval status.

type

Type of approver (user, placeholder, external, or team).

note

Optional note from the approver when requesting changes or providing feedback.

customEmailMessage

Optional message from the requester to include in proof-link emails to this external approver (persisted on the approval).

changedAt

Timestamp when the approval status was last changed.

approvalFiles

Files associated with this approval (used in proofing workflows).

documentCheckpoint

JSON checkpoint created for this individual's terminal response.

agentReview

Buzz's review settings and latest run, for agent approvals.

currentUserApproval

Whether this approval belongs to the currently authenticated user.

userId

User ID if a specific user has claimed this approval.

approverUser

Resolved user document if approver is a user.

approverPlaceholder

Resolved placeholder document if approver is a placeholder.

approverTeam

Resolved team document if approver is a team.