Tags

Create a tag

Creates a tag in the workspace.

Idempotent by name. Tag names are unique per workspace, case-insensitively, so creating a name that already exists returns the existing tag with 200 rather than a 409. A fresh create returns 201. Either way the response carries the tag you asked for, so a caller can create-then-use without checking first.

Example:

curl -X POST 'https://partner-api.nooks.in/v1/tags' \
  -H "Authorization: Bearer nooks-api-..." \
  -H "Content-Type: application/json" \
  -d '{"data": {"name": "cold"}}'
post/tags

Request

  • Base URL: https://partner-api.nooks.in/v1
  • URL: https://partner-api.nooks.in/v1/tags
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://oauth.nooks.in/oauth/authorize, token URL https://oauth.nooks.in/oauth/token)

Request body

Response

A tag with that name already existed (any casing) and is returned unchanged

Example response

{
  "data": {
    "id": "770e8400-e29b-41d4-a716-446655440010",
    "name": "cold",
    "createdAt": "2026-01-12T09:30:00Z",
    "updatedAt": "2026-01-12T09:30:00Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.