Skip to content
Optiwork API Docs

Delete a board tag

DELETE
/boards/{board}/tags/{tag}
curl --request DELETE \
  --url https://projects.work.optidata.cloud/api/boards/1/tags/1 \
  --header 'Authorization: Bearer <token>'

Deletes the tag and detaches it from every card of the board.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
board
required
integer

Board id.

tag
required
integer

Tag id.

Responses

Section titled “Responses”

200

Section titled “200”

The deleted tag.

Media typeapplication/json
object
tag

A label. board_id null means a common (tenant-wide) tag.

object
id
integer
board_id
integer | null
name
string
>= 2 characters <= 40 characters
description
string | null
>= 3 characters <= 250 characters
color

Hex color (e.g. #52eb00).

string
created_at
string format: date-time
updated_at
string format: date-time
Examplegenerated
{
  "tag": {
    "id": 1,
    "board_id": 1,
    "name": "example",
    "description": "example",
    "color": "example",
    "created_at": "2026-04-15T12:00:00Z",
    "updated_at": "2026-04-15T12:00:00Z"
  }
}

401

Section titled “401”

Missing, invalid or expired bearer passport.

Media typeapplication/json
object
error
string
Example
{
  "error": "JWT passport exception: Missing bearer token in request"
}

403

Section titled “403”

The authenticated user lacks the required board permission.

Media typeapplication/json
object
message
string
Example
{
  "message": "This action is unauthorized."
}

404

Section titled “404”

Resource not found, or a nested resource does not belong to its parent in the path.

Media typeapplication/json
object
message
string
Example
{
  "message": "Not found."
}