Get a common tag

GET

/tags/common/{tag}

curl --request GET \
  --url https://projects.work.optidata.cloud/api/tags/common/1 \
  --header 'Authorization: Bearer <token>'

• Optiwork Projects API

Returns a single common tag.

Authorizations

• bearerAuth

Parameters

Path Parameters

tag

required

integer

Tag id.

Responses

200

The 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

Example^generated

{
  "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

Missing, invalid or expired bearer passport.

Media typeapplication/json

object

error

string

Example

{
  "error": "JWT passport exception: Missing bearer token in request"
}

403

The authenticated user lacks the required board permission.

Media typeapplication/json

object

message

string

Example

{
  "message": "This action is unauthorized."
}

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."
}