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.
By default, create a TargetBoard with default columns: IDENTIFIED TARGET, PRIORITIZED TARGET, IN COORDINATION, IN EXECUTION, COMPLETE. Returns the RID of the created TargetBoard.
booleanRepresents a boolean value that restricts an endpoint to preview mode when set to true.
objectThe request body to create a Target Board
stringstringstringobjectConfiguration for the target board. If present, must have at least one column
objectSecurity mutation details for a target, target board, or hptl. Specifying security overrides the system's default security when creating and updating data. This model may evolve over time for other security features.
objectSuccess response with the ID of the created Target Board.
stringThe unique resource identifier of a Target Board. This is equivalent to a collection RID.
1
2
3
4
5
curl -X POST \
-H "Content-type: application/json" \
-H "Authorization: Bearer $TOKEN" \
"https://$HOSTNAME/api/gotham/v1/twb/targetBoard?preview=true" \
-d '{"name":"Example target board name.","description":"Example description.","highPriorityTargetList":"ri.gotham-artifact.0-0.hptl.example","configuration":{"columns":[{"id":"id12345","name":"DONE","color":"RED"}],"targetIdentifiers":["CUSTOM"]},"security":{"portionMarkings":["SENSITIVE"]}}'1
ri.gotham-artifact.0-0.target-collection.example