This endpoint is in preview and may be modified or removed at any time.
To use this endpoint, add preview=true to the request query parameters.
Move a Target into a TargetBoardColumn from an old column.
booleanRepresents a boolean value that restricts an endpoint to preview mode when set to true.
objectMove a Target into a TargetBoardColumn, either from an old column or no column (newly created Target).
stringThe unique resource identifier of a Target Board. This is equivalent to a collection RID.
stringEquivalent to a collection column ID. The ID of a TargetCollectionColumn, default values are: DRAFT (Identified target), PLAN_DEVELOPMENT (Prioritized target), PLANNED (In coordination), EXECUTION (In execution), CLOSED (Complete).
stringThe version of Target Board you are working with. The set operation will be transformed against any concurrent operations made since this version. If there are any conflicting edits that result in changes to these operations when they're applied, that will be noted in the response.
stringThe client id is used to identify conflicting edits made by the same client, typically due to retries, and discard them. Clients should choose an arbitrary random identifier to distinguish themselves. There is no need persist and re-use the same client id over multiple sessions.
The client id is also used to avoid broadcasting operations to the client who submitted them.
1
2
3
4
5
curl -X PUT \
-H "Content-type: application/json" \
-H "Authorization: Bearer $TOKEN" \
"https://$HOSTNAME/api/gotham/v1/twb/setTargetColumn/ri.gotham-artifact.0-0.target.example?preview=true" \
-d '{"boardRid":"ri.gotham-artifact.0-0.target-board.example","newColumnId":"CLOSED"}'