Get Tag

Retrieve a single tag by ID.

GET /api/tags/{tag_id}

Returns the full details of a single tag. Any authenticated user can call this endpoint.

Authentication

Requires a valid Bearer access token.

Authorization: Bearer <access_token>

Path Parameters

tag_id · integer · required

The ID of the tag to retrieve.

Response

success · boolean

true when the request succeeds.

data · object

Show data

id · integer

Unique identifier for the tag.

name · string

The unique tag name.

color · string

Hex color code associated with the tag (e.g. #FF5733).

description · string

Optional description of the tag’s purpose.

task_count · integer

Number of tasks currently associated with this tag.

created_at · string

ISO 8601 timestamp of when the tag was created.

updated_at · string

ISO 8601 timestamp of the last update to the tag.

Errors

Status	Description
401	Missing or invalid access token.
404	No tag exists with the given tag_id.

Example

curl -X GET "https://task-forge-gbd6h8gtg8hchve9.chilecentral-01.azurewebsites.net/api/tags/3" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

{
  "success": true,
  "data": {
    "id": 3,
    "name": "Backend",
    "color": "#3B82F6",
    "description": "Backend development tasks",
    "task_count": 12,
    "created_at": "2024-01-10T09:00:00",
    "updated_at": "2024-02-20T11:30:00"
  }
}