Search documentation
karat

+

K

User Documentation ↗
Version 2.0

Load Target Board

GET/api/v2/targetWorkbench/targetBoards/{targetBoardRid}/load

Load Target Board by RID.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:target-read.

Path parameters

targetBoardRid
string

The unique identifier for a Target Board

Response body

LoadTargetBoardResponse
object

Success response with the requested Target Board.

Hide child attributes

Hide child attributes

targetBoard
object
Show child attributes

Show child attributes

baseRevisionId
string

The current version of the Target Board to be modified. The archive 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.

Examples

Request

Copied!
1 2 3 curl \ \t-H "Authorization: Bearer $TOKEN" \ "https://$HOSTNAME/api/v2/targetWorkbench/targetBoards/ri.gotham-artifact.0-0.target-board.example/load"

Response

Copied!
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 { "targetBoard": { "targetColumnIds": { "bi.2a46fbf6-ff93-4710-951a-015ed5c92441*ri.gotham-artifact.0-0.target.1": { "columnId": "EXECUTION" }, "bi.8a66fbf3-ff93-4710-951a-015ee5c92441*ri.gotham-artifact.0-0.target.2": { "columnId": "EXECUTION" } }, "highPriorityTargetList": "ri.gotham-artifact.0-0.hptl.example", "configuration": { "columns": [ { "id": "EXECUTION", "name": "IN PROGRESS", "color": "RED" } ], "targetIdentifiers": [ "CUSTOM" ] }, "name": "Example target board name.", "description": "Example target board description.", "rid": "ri.gotham-artifact.0-0.target-board.example", "targets": [ "bi.2a46fbf6-ff93-4710-951a-015ed5c92441*ri.gotham-artifact.0-0.target.1", "bi.8a66fbf3-ff93-4710-951a-015ee5c92441*ri.gotham-artifact.0-0.target.2" ] }, "baseRevisionId": 1 }

Error responses

Error Name
TargetBoardNotFoundError CodeINVALID_ARGUMENT
Status Code400
DescriptionCannot find target board from provided rid.
ParameterstargetBoardRid
LoadTargetBoardPermissionDeniedError CodePERMISSION_DENIED
Status Code403
DescriptionCould not load the TargetBoard.
ParameterstargetBoardRid