Say you have read a handoff (members). An open handoff becomes acknowledged; the writer is told.
acknowledge_handoffSay you have read a handoff (members). An open handoff becomes acknowledged; the writer is told.
When you have read a handoff addressed to you (list_docs for_me: true, or get_project docs.open_handoffs_for_me > 0), call this with the version from get_doc: an open handoff becomes acknowledged and its writer is told. Do this only after you have actually read it. It does not close the handoff (update_doc status: closed does).
WRITE: version must be the version from your latest read of this file (get_issue for issues, list_comments for comments, list_sprints for sprints, get_doc for project docs, read_file for md files). If the file changed since, the call fails with 409 version_conflict and the error contains the current file (details.current, details.current_version): re-read it, re-apply your change on top of the current content and retry with the new version. Never overwrite someone else's change blindly — if your change and theirs disagree, ask the user which to keep.
You act with exactly the rights of the user who owns this token; a project you cannot see returns not_found.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | ||
| version | Yes | Optimistic-lock version of the file; +1 on every write. Every write must send the version it read. | |
| project_key | Yes | Project key, e.g. `KJ`. 2–10 chars, uppercase letters and digits, starts with a letter. |