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
The ID of the tag to retrieve.
Response
true when the request succeeds.
Unique identifier for the tag.
Hex color code associated with the tag (e.g. #FF5733).
Optional description of the tag’s purpose.
Number of tasks currently associated with this tag.
ISO 8601 timestamp of when the tag was created.
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"
}
}