Aggiorna campo personalizzato

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

Modifica un campo personalizzato. L'aggiornamento è parziale: le chiavi che non invii restano come sono. Accetta anche PATCH. I valori già salvati sui contatti restano.

Puoi cambiare anche il type, con le stesse regole della creazione: passando a select/multiselect servono le options (se il campo le aveva già, restano), passando ad ai serve ai_prompt e il campo smette di essere obbligatorio.

Risposte: 200 con il campo e l'elenco changed delle impostazioni cambiate — 404 se il campo non è del tuo account — 409 se il nuovo nome è già usato da un altro campo — 422 se un dato non è valido.

Errori comuni: 401 se la chiave API manca o è sbagliata — 403 se il piano è scaduto o non include l'accesso API — 429 se fai troppe richieste in poco tempo oppure se un'altra modifica ai campi personalizzati del tuo account è in corso: riprova dopo qualche secondo.

Parametri

9 · 2 obbligatori

apikey obbligatorio

La tua API Key (anche header X-API-Key).

id obbligatorio

ID del campo (intero, nel path). Usa GET /api/contact-fields per trovarlo.

name opzionale

Nuovo nome (unico nel tuo account).

type opzionale

Tipo del campo: input, textarea, number, date, select, multiselect, boolean, url, phone, email o ai.

options opzionale

L'elenco completo delle nuove scelte (sostituisce quello attuale).

ai_prompt opzionale

Nuovo prompt (campi ai).

show_in_list opzionale

true per mostrarlo come colonna nell'elenco dei contatti, false per toglierlo. Se non lo invii resta com'è.

visible_to_ai opzionale

true se l'assistente AI può leggerne il valore, false se no. Se non lo invii resta com'è.

is_required opzionale

true per renderlo obbligatorio nel modulo del contatto, false per toglierlo. Se non lo invii resta com'è. Non ammesso per i campi ai.

Serve aiuto con l'integrazione? 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, "...": "..." } }