Skip to content

Create a Tag

Request

Adds a tag to the organization's tag list so it can be applied to people, projects, or clients. If the tag's category does not exist yet, it is created automatically. Tags are compared case-insensitively, so creating a tag that already exists leaves the existing tag untouched.

Security
ApiKey
Body
tagstringrequired

The tag to create.

Tag names are structured as CATEGORY::TAG_NAME, with a :: separating the category and tag name. Category names will be returned with :: in their name.

Example: Skills:: would indicate a category named skills. Further, Skills::ActionScript would indicate a tag named ActionScript within the Skills category.

New category and tag names may not start or end with whitespace, so creating Skills:: ActionScript is rejected. Whitespace within a name is allowed: Front End::Dust Bringer is valid.

curl -i -X POST \
  https://developer.getparallax.com/_mock/api-documentation/swagger/v1/tags \
  -H 'Content-Type: application/json-patch+json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "tag": "string"
  }'

Responses

Created

Bodyapplication/json
tagstring

The tag.

Tag names are structured as CATEGORY::TAG_NAME, with a :: separating the category and tag name. Category names will be returned with :: in their name.

Example: Skills:: would indicate a category named skills. Further, Skills::ActionScript would indicate a tag named ActionScript within the Skills category.

New category and tag names may not start or end with whitespace, so creating Skills:: ActionScript is rejected. Whitespace within a name is allowed: Front End::Dust Bringer is valid.

Response
{ "tag": "string" }