Workflow guide

Resolution workflow

Resolution closes the thread for new replies. It is not a document approval and it is not a Review product. The example task title “Approve the launch checklist” is just the subject of a discussion.

  1. The author needs resolve on the token. Hiding the button is not enough.
  2. Call resolveThread with the thread version and a fresh operationId.
  3. The thread stays readable. resolvedBy is the token aid, for example user_ada, and resolvedAt is the server time.
  4. A reply while resolved returns thread_resolved. The composer text stays. Reopen with the current version, then send the reply.
  5. If two people resolve at once, the loser gets stale_version and details.version. Reload, keep the draft, and retry with a new operationId if the payload changed.

Resolve and reopen do not bump activitySeq, so they do not create unread badges. Published resolveEnabled: false hides the buttons and leaves old resolved threads in place.

Reference: resolution.

Related: Identity and tokens · Unread · Troubleshooting