Skip to main content
POST
/
workers
/
{id}
/
tags
Create Worker Tag
curl --request POST \
  --url https://api.roostedhr.com/api/1_12/workers/{id}/tags \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "text": "New Tag"
}
'
{
  "id": "WzDHL",
  "text": "New Tag"
}

Documentation Index

Fetch the complete documentation index at: https://docs.roostedhr.com/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint creates a new global tag and assigns it to the specified worker. Once created, the tag is available to assign to any worker via the Add Worker Tag endpoint.

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
id
string
required

Worker ID

Body

application/json
​
text
string
required

The label for the new tag.

Example:

"New Tag"

Response

Created

A tag that can be assigned to workers.

​
id
string
required

Unique tag identifier.

Example:

"WzDHL"

​
text
string
required

The tag label.

Example:

"New Tag"