Docs
API Reference
Tags
Create a tag

Create a tag

Creates a new tag in the active project. Tag names are unique per project and case-insensitive.

POST /api/v1/tags

Body parameters

Name	Type	Required	Description
name	string	Required	A short label for the tag. May be up to 64 characters. Tag names are unique per project and case-insensitive, so `Branded` and `branded` will collide.
color	string	Required	The color you would like to assign to the tag. One of `gray`, `red`, `orange`, `amber`, `green`, `teal`, `blue`, `indigo`, `violet`, or `pink`.

Response

The tag object

Field	Type	Description
id	integer	The unique ID of the tag.
project_id	integer	The ID of the project this tag belongs to.
name	string	The display label of the tag.
color	string	The tag's color. One of `gray`, `red`, `orange`, `amber`, `green`, `teal`, `blue`, `indigo`, `violet`, or `pink`.
created_at	datetime	When the tag was created.
updated_at	datetime	When the tag was last updated.

curl -X POST https://pineprompt.com/api/v1/tags \ -H "Authorization: Bearer $PINEPROMPT_TOKEN" \ -H "Pineprompt-Project-Id: 1" \ -H "Content-Type: application/json" \ -d '{ "name": "non-branded", "color": "blue" }'

import os import requests response = requests.post( "https://pineprompt.com/api/v1/tags", headers={ "Authorization": f"Bearer {os.environ['PINEPROMPT_TOKEN']}", "Pineprompt-Project-Id": "1", "Content-Type": "application/json", }, json={ "name": "non-branded", "color": "blue", }, ) response.raise_for_status() payload = response.json()

use GuzzleHttp\Client; $response = (new Client())->post('https://pineprompt.com/api/v1/tags', [ 'headers' => [ 'Authorization' => 'Bearer '.getenv('PINEPROMPT_TOKEN'), 'Pineprompt-Project-Id' => '1', ], 'json' => [ 'name' => 'non-branded', 'color' => 'blue', ], ]); // Guzzle throws on 4xx/5xx by default, so no manual check needed. $payload = json_decode((string) $response->getBody(), true);