Create Tag

Creates a new tag for the authenticated account, optionally nested under an existing parent tag. The submitted tag_name is normalized server-side before storage: each ~ is replaced with a space, runs of one or more commas are replaced with a single hyphen, Unicode control and format characters (newline, NUL, BOM, etc.) are stripped, and surrounding whitespace is trimmed. This keeps the stored name safe across the system's ~- and ,-delimited tag pipelines (click-tracked URLs, comma-separated tag-list inputs); a caller who submits foo,bar will see foo-bar in the response. A tag_name that is empty after this normalization (only whitespace or control characters) is rejected with 422.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length ≤ 255

The tag's display name. Will be normalized server-side; see endpoint description.

uuid | null

Optional. UUID of an existing tag in the authenticated account to use as parent. Unknown UUIDs return 422.

Responses

401

Missing or invalid bearer token.

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json