Benutzerdefiniertes Feld aktualisieren

PUT https://app.sendapp.ai/api/contact-fields/{id}

Ändert ein benutzerdefiniertes Feld. Die Aktualisierung ist partiell: Nicht gesendete Schlüssel bleiben unverändert. PATCH wird ebenfalls akzeptiert. Bereits auf Kontakten gespeicherte Werte bleiben erhalten.

Du kannst auch den type ändern, mit denselben Regeln wie beim Erstellen: Für select/multiselect braucht es options (hatte das Feld schon welche, bleiben sie), für ai braucht es ai_prompt und das Feld ist dann kein Pflichtfeld mehr.

Antworten: 200 mit dem Feld und der Liste changed der geänderten Einstellungen — 404, wenn das Feld nicht zu deinem Konto gehört — 409, wenn der neue Name schon von einem anderen Feld verwendet wird — 422, wenn ein Wert ungültig ist.

Häufige Fehler: 401, wenn der API-Schlüssel fehlt oder falsch ist — 403, wenn der Tarif abgelaufen ist oder keinen API-Zugang enthält — 429, wenn du in kurzer Zeit zu viele Anfragen sendest oder gerade eine andere Änderung an den benutzerdefinierten Feldern deines Kontos läuft: versuche es nach ein paar Sekunden erneut.

Parameter

9 · 2 Pflichtfelder

apikey erforderlich

Ihr API Key (der Header X-API-Key funktioniert ebenfalls).

id erforderlich

Feld-ID (Ganzzahl, im Pfad). Verwende GET /api/contact-fields, um sie zu finden.

name optional

Neuer Name (eindeutig in deinem Konto).

type optional

Feldtyp: input, textarea, number, date, select, multiselect, boolean, url, phone, email oder ai.

options optional

Die vollständige Liste der neuen Auswahlwerte (ersetzt die aktuelle).

ai_prompt optional

Neuer Prompt (ai-Felder).

show_in_list optional

true, um es als Spalte in der Kontaktliste anzuzeigen, false, um es zu entfernen. Wenn du es nicht sendest, bleibt es, wie es ist.

visible_to_ai optional

true, wenn der KI-Assistent den Wert lesen darf, sonst false. Wenn du es nicht sendest, bleibt es, wie es ist.

is_required optional

true, um es im Kontaktformular zum Pflichtfeld zu machen, false, um das aufzuheben. Wenn du es nicht sendest, bleibt es, wie es ist. Nicht erlaubt für ai-Felder.

Brauchen Sie Hilfe bei der Integration? info@sendapp.live

curl -X PATCH 'https://app.sendapp.ai/api/contact-fields/13' \ -H 'X-API-Key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "options": ["S", "M", "L", "XL"], "show_in_list": true }'

<?php $ch = curl_init('https://app.sendapp.ai/api/contact-fields/13'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'PATCH', CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY', 'Content-Type: application/json'], CURLOPT_POSTFIELDS => json_encode(['options' => ['S', 'M', 'L', 'XL'], 'show_in_list' => true]), ]); echo curl_exec($ch); curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/contact-fields/13', { method: 'PATCH', headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ options: ['S', 'M', 'L', 'XL'], show_in_list: true }) }); console.log(await res.json());

{ "status": "success", "message": "Field updated.", "changed": ["options", "show_in_list"], "field": { "id": 13, "name": "Size", "type": "select", "options": ["S", "M", "L", "XL"], "show_in_list": true, "...": "..." } }