List Tags

Retrieve all available tags with pagination and sorting.

GET /api/tags

Returns a paginated list of all tags available in the system. Any authenticated user can call this endpoint.

Authentication

Requires a valid Bearer access token.

Authorization: Bearer <access_token>

Query Parameters

page · integer · default: "1"

The page number to retrieve.

per_page · integer · default: "50"

Number of tags to return per page. Maximum value is 100.

sort_by · string · default: "name"

Field to sort results by. Allowed values: id, name, created_at, updated_at.

sort_order · string · default: "asc"

Sort direction. Allowed values: asc, desc.

Response

success · boolean

true when the request succeeds.

data · object

Show data

tags · array

Array of tag objects.

Show Tag object

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.

pagination · object

Show pagination

page · integer

Current page number.

per_page · integer

Number of items per page.

total · integer

Total number of tags across all pages.

total_pages · integer

Total number of pages.

has_next · boolean

Whether a next page exists.

has_prev · boolean

Whether a previous page exists.

Errors

Status	Description
401	Missing or invalid access token.

Example

curl -X GET "https://task-forge-gbd6h8gtg8hchve9.chilecentral-01.azurewebsites.net/api/tags?page=1&per_page=50&sort_by=name&sort_order=asc" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

{
  "success": true,
  "data": {
    "tags": [
      {
        "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"
      },
      {
        "id": 1,
        "name": "Bug",
        "color": "#EF4444",
        "description": "Confirmed bugs requiring a fix",
        "task_count": 5,
        "created_at": "2024-01-08T08:00:00",
        "updated_at": "2024-01-08T08:00:00"
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 50,
      "total": 2,
      "total_pages": 1,
      "has_next": false,
      "has_prev": false
    }
  }
}