Create Worker Tag - Roosted HR API Documentation

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

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

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.

string

required

Unique tag identifier.

Example:

"WzDHL"

text

string

required

The tag label.

Example:

"New Tag"

Add Worker TagAdds an existing tag to a worker.

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