---
title: "Tag erstellen"
description: "Erstellt einen neuen Tag in deiner Organisation. Readonly-Mitglieder können Tags erstellen, die nur für sie selbst sichtbar sind."
---

`POST /api/tags`

## Body

```json
{
  "name": "Produktion",
  "color": "red"
}
```

- `name` (erforderlich): Anzeigename des Tags (max. 50 Zeichen).
- `color` (erforderlich): Einer der Palette-Schlüssel: `slate` | `red` | `amber` | `green` | `teal` | `blue` | `indigo` | `violet` | `pink` | `gray`.

## Beispiel (cURL)

```bash
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X POST "$BASE_URL/api/tags" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Produktion","color":"red"}'
```

## Antwort (Response)

```json
{
  "id": 1,
  "publicId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
  "organizationId": 10,
  "name": "Produktion",
  "color": "red",
  "createdBy": 42,
  "createdAt": "2026-06-29T10:00:00.000Z",
  "updatedAt": "2026-06-29T10:00:00.000Z"
}
```

## Häufige Fehler

- `400 invalidTagColor` wenn `color` kein gültiger Palette-Schlüssel ist
- `400 Bad Request` wenn `name` fehlt oder das Zeichenlimit überschreitet
- `401 Unauthorized` wenn du nicht angemeldet bist
- `403 Forbidden` wenn du keinen Zugriff auf die Organisation hast