Create Tag
POST {{baseUrl}}/api/tags/
Create a tag. An account cannot have more than 500 unique tags.
A tag belongs to a single tag group. If the tag_group_id
is not specified, the tag is added to the account's default tag group.
Rate limits:
Burst: 3/s
Steady: 60/m
Scopes:
Tags Read
Tags Write
Request Body
{"data"=>{"type"=>"tag", "attributes"=>{"name"=>"My Tag", "tag_group_id"=>"zyxw9876-vu54-ts32-rq10-zyxwvu654321"}}}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
revision | string | (Required) API endpoint revision (format: YYYY-MM-DD[.suffix]) | |
Content-Type | string | ||
Accept | string |
RESPONSES
status: Created
{"data":{"type":"tag","id":"abcd1234-ef56-gh78-ij90-abcdef123456","attributes":{"name":"My Tag"},"links":{"self":"http://eGVnfHyXqVAWuBDEAlrhpICjyLSS.ajMYdx1WefnPUn,5N"}}}