Search documentation
karat

+

K

User Documentation ↗
Version 2.0

Delete Target Board

DELETE/api/v2/targetWorkbench/targetBoards/{targetBoardRid}
Warning

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.

Archive a Target Board by RID. The user is required to have OWN permissions on the target.

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

Path parameters

targetBoardRid
string

The unique identifier for a Target Board

Query parameters

preview
boolean
optional

Enables the use of preview functionality.

Examples

Request

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

Error responses

Error Name
UserHasNoOwnerPermsError CodeINVALID_ARGUMENT
Status Code400
DescriptionThe user is required to have owner permissions on the artifact.
ParametersartifactId
DeleteTargetBoardPermissionDeniedError CodePERMISSION_DENIED
Status Code403
DescriptionCould not delete the TargetBoard.
ParameterstargetBoardRid