Edit a tag.

PUT

/api/tags/{id}

const url = 'https://api.tradr.cloud/api/tags/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';
const options = {
  method: 'PUT',
  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 PUT \
  --url https://api.tradr.cloud/api/tags/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Content-Type: application/json' \
  --data '{ "category": "setup", "color": "tag-1", "name": "example" }'

Authed. Every field is optional but at least one must be present. Names stay unique per user case-insensitively across every category; a case-only self-rename is allowed.

Parameters

Path Parameters

required

string format: uuid

Request Body^required

application/json

object

>= 1 properties

category

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

string

>= 1 characters <= 40 characters

Responses

200

The updated tag.

400

Validation error.

401

No valid session.

404

No such tag for this user.

409

TAG_NAME_TAKEN — a tag with this name already exists for the user (case-insensitive, across categories).

Edit a tag.

Parameters

Path Parameters

Request Bodyrequired

Responses

200

400

401

404

409

Request Body^required