Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Vings OAuth access token or personal access token (vng_pat_…). Use Authorization: Bearer ….

Body

application/json
name
string
required

Display name: 1–50 Unicode code points, no control characters. NFC-normalized, trimmed and whitespace-collapsed; uniqueness uses locale-independent lowercase.

color
enum<string>
default:blue
Available options:
gray,
red,
orange,
yellow,
green,
blue,
purple,
pink

Response

Created or existing tag

id
string<uuid>
required
name
string
required
color
enum<string>
required
Available options:
gray,
red,
orange,
yellow,
green,
blue,
purple,
pink