Create a tag.

POST

/api/tags

const url = 'https://api.tradr.cloud/api/tags';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"category":"setup","color":"tag-1","name":"example"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.tradr.cloud/api/tags \
  --header 'Content-Type: application/json' \
  --data '{ "category": "setup", "color": "tag-1", "name": "example" }'

Authed. Names are unique per user case-insensitively across every category, so the same name cannot exist twice even under different categories. Colour is optional. Subject to a per-user cap.

Request Body^required

application/json

object

category

required

string

Allowed values: setup emotion mistake general

color

string

nullable

Allowed values: tag-1 tag-2 tag-3 tag-4 tag-5 tag-6

name

required

string

>= 1 characters <= 40 characters

Responses

201

The created tag.

400

Validation error.

401

No valid session.

409

TAG_NAME_TAKEN — a tag with this name already exists for the user (case-insensitive, across categories); or TAG_LIMIT_REACHED — the per-user tag cap has been reached.

Create a tag.

Request Bodyrequired

Responses

201

400

401

409

Request Body^required