Benutzerdefiniertes Feld aktualisieren
Aktualisiert die Definition eines benutzerdefinierten Feldes. Alle Felder sind optional.
PATCH /api/custom-fields/:id
Erfordert die Rolle admin (oder einen globalen Admin). Editoren und Nur-Lese-Benutzer erhalten 403.
Anfrage (Request Body) (alle optional)
| Feld | Typ | Beschreibung |
|---|---|---|
name | string | Anzeigename, 1 bis 100 Zeichen |
fieldType | string | Einer von text, number, email, url, select |
isRequired | boolean | Ob das Feld erforderlich ist |
displayOrder | number | Sortierreihenfolge, Ganzzahl 0 bis 10000 |
options | string[] | Optionen für den Typ select, max. 50 Einträge mit je max. 100 Zeichen |
placeholder | string|null | Platzhaltertext, max. 200 Zeichen |
helpText | string|null | Hilfetext, max. 500 Zeichen |
showInTable | boolean | In Tabellenansichten anzeigen |
isActive | boolean | Soft-Delete (auf false setzen) |
Beispiel (cURL)
curl -X PATCH "$BASE_URL/api/custom-fields/1" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{ "name": "Environment", "options": ["production", "staging", "development", "qa"] }'Häufige Fehler
400 Bad Requestwenn der Body die Validierung nicht besteht (unbekannterfieldType,namemit mehr als 100 Zeichen, mehr als 50options)403 Forbiddenwenn deine Rolle nichtadminist404 Not Foundwenn das Feld in deiner Organisation nicht existiert
Antwort (Response)
Gibt das aktualisierte benutzerdefinierte Feld-Objekt zurück. Siehe Fehlercodes für Fehlerantworten.