Place a preview comment's card on the Tasks board
Stores where the comment’s card sits on the Tasks board: a canonical fractional index the client computed between the card’s new neighbours, so moving one card rewrites only that card, or null to take it out of the order. Positions follow the fractional-indexing format (the first character gives the integer part’s length and the fraction never ends in 0), which always leaves room between two keys; a key that is not canonical is refused. They order the whole board, in the same order work items keep, and equal positions are ordered by id.
Its own operation because it is its own register, resolved exactly as
priority is. board_position_at_ms is compared only against the
stored position’s stamp, and placing a card never changes the
comment’s lock_version, so placing a card and moving its status in
the same moment both land. A write carrying an older stamp is discarded
and answered 200 with the comment unchanged; an equal stamp is taken by
the incoming write. A null still carries its stamp, so a cleared
position is not restored by a later write holding an older one.
A thread that belongs to a work item is not writable workflow here.
This returns 409 with the current comment in
error.details.preview_comment; the work item holds the card’s
position instead.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Id of the theme the comment belongs to.
Client-generated id of the comment.
Body
Response
The comment, with the position stored or left as it was.