Skip to navigation

Veld wijzigen

Wijzigt een veld. Je stuurt alleen mee wat anders moet worden. De keuzemogelijkheden van een keuzeveld vervang je in hun geheel via options_full. You will only have to include the parts that need to be modified. Parts that are not mentioned will keep their current values. As soon as a part is mentioned it does get checked, and thus can cause an error message. This error message contains a code with a message. See above under ‘Error messages’ what these codes stand for. Pass options_full as a complete replacement for the option list. The key of each entry determines the operation: You may also pass options_full as an array of value objects — the same shape as the response. The API will handle both formats. Ändert ein Feld. Du schickst nur mit, was anders werden soll. Die Auswahlmöglichkeiten eines Auswahlfeldes ersetzt du komplett über options_full. Modifica un campo. Solo envías lo que debe cambiar. Las opciones de un campo de selección se sustituyen en su totalidad mediante options_full.

Authentication

AuthorizationBasic
Vul je API-sleutel in bij api_key en laat leave_empty leeg. De API gebruikt basic auth, waarbij je sleutel de plaats van de gebruikersnaam inneemt. In curl schrijf je dat als -u JOUW_SLEUTEL:, met een dubbele punt en niets erachter. Enter your API key at api_key and leave leave_empty empty. The API uses basic auth, with your key in place of the username. In curl that reads -u YOUR_KEY:, with a colon and nothing after it. Trage deinen API-Schlüssel bei api_key ein und lass leave_empty leer. Die API nutzt Basic Auth, wobei dein Schlüssel an die Stelle des Benutzernamens tritt. In curl schreibst du das als -u DEIN_SCHLUESSEL:, mit einem Doppelpunkt und nichts dahinter. Introduce tu clave API en api_key y deja leave_empty vacío. La API usa basic auth, con tu clave en lugar del nombre de usuario. En curl se escribe como -u TU_CLAVE:, con dos puntos y nada después.

Path parameters

field_idstringRequired

Request

This endpoint expects an object.
list_idstringRequired
Het id van de lijst. Dat vind je in het antwoord van Alle lijsten opvragen, en in de applicatie in de URL van de lijst. The id of the list. You find it in the response of Get all lists, and in the application in the URL of the list. Die ID der Liste. Du findest sie in der Antwort von Alle Listen abrufen und in der Anwendung in der URL der Liste. El id de la lista. Lo encuentras en la respuesta de Obtener todas las listas y en la aplicación, en la URL de la lista.
requiredbooleanRequired
Is dit een verplicht veld? Is this a mandatory field? Ist dies ein Pflichtfeld? ¿Es este un campo obligatorio?
namestringOptional
Een naam voor dit veld. A name for this field Ein Name für dieses Feld. Un nombre para este campo.
datatypeenumOptional
Het datatype van dit veld (text, numeric, date, select_single, select_multiple) The data type of this field (text, numeric, date, select_single, select_multiple) Der Datentyp dieses Feldes (text, numeric, date, select_single, select_multiple) El tipo de dato de este campo (text, numeric, date, select_single, select_multiple)
Allowed values:
datatype_displayenumOptional
Alleen voor select_single: de gewenste weergave (select, radio) Only applicable for select_single: the desired display (select, radio) Nur für select_single: die gewünschte Darstellung (select, radio) Solo para select_single: la visualización deseada (select, radio)
Allowed values:
options_fulllist of stringsOptional

<span class=“lp-taal lp-nl”>De volledige lijst met opties van een select_single of select_multiple veld, als een key/value map van id → label. De key bepaalt wat er met elke optie gebeurt: Bestaand numeriek id (bijv. “2”), behoudt of wijzigt de optie. Als het label verandert wordt het bijgewerkt; het id blijft hetzelfde, zodat bestaande ledendata behouden blijft. Niet-numerieke key (bijv. “new-0”), voegt een nieuwe optie toe; een nieuw id wordt automatisch toegekend. Een bestaand id weglaten, verwijdert die optie. Stuur altijd alle opties mee die je wilt behouden. Verstuur als JSON. Alternatief formaat: in plaats van een key/value map mag je ook een array van objecten meegeven in dezelfde vorm als de response: [{“id”: “1”, “value”: “Rood”}, {“id”: “new-0”, “value”: “Oranje”}]. De API normaliseert dit automatisch.</span><span class=“lp-taal lp-en”>The full set of options for a select_single or select_multiple field, as a key/value map of id → label. The key controls what happens to each option: Existing numeric ID (e.g. “2”) — keeps or modifies the option. Changing the label updates it in-place; the ID stays the same, so existing member data is preserved. Non-numeric key (e.g. “new-0”) — adds a new option; a fresh ID is assigned automatically. Omitting an existing ID — deletes that option. Always include every option you want to keep. Must be sent as JSON. Alternative format: instead of a key/value map you may also pass an array of objects in the same shape as the response: [{“id”: “1”, “value”: “Red”}, {“id”: “new-0”, “value”: “Orange”}]. The API will normalise this automatically.</span><span class=“lp-taal lp-de”>Die vollständige Liste der Optionen eines select_single- oder select_multiple-Feldes, als key/value-Map von id → label. Der key bestimmt, was mit jeder Option passiert: Bestehende numerische ID (z. B. “2”), behält oder ändert die Option. Ändert sich das Label, wird es aktualisiert; die ID bleibt gleich, sodass bestehende Abonnentendaten erhalten bleiben. Nicht-numerischer key (z. B. “new-0”), fügt eine neue Option hinzu; eine neue ID wird automatisch vergeben. Eine bestehende ID weglassen, löscht diese Option. Schicke immer alle Optionen mit, die du behalten willst. Als JSON versenden. Alternatives Format: statt einer key/value-Map darfst du auch ein Array von Objekten in derselben Form wie die Response mitgeben: [{“id”: “1”, “value”: “Rot”}, {“id”: “new-0”, “value”: “Orange”}]. Die API normalisiert das automatisch.</span><span class=“lp-taal lp-es”>La lista completa de opciones de un campo select_single o select_multiple, como un mapa key/value de id → label. La key determina lo que ocurre con cada opción: un id numérico existente (por ejemplo “2”), mantiene o modifica la opción. Si el label cambia, se actualiza; el id sigue siendo el mismo, de modo que se conservan los datos existentes de los contactos. Una key no numérica (por ejemplo “new-0”), añade una opción nueva; se asigna automáticamente un id nuevo. Omitir un id existente, elimina esa opción. Envía siempre todas las opciones que quieras conservar. Envíalo como JSON. Formato alternativo: en lugar de un mapa key/value también puedes enviar un array de objetos con la misma forma que la respuesta: [{“id”: “1”, “value”: “Rojo”}, {“id”: “new-0”, “value”: “Naranja”}]. La API lo normaliza automáticamente.</span>

defaultvaluestringOptional
Standaardwaarde (wordt gebruikt bij afwezigheid van dit veld) The default value (will be used in the absence of this field) Standardwert (wird verwendet, wenn dieses Feld fehlt) Valor predeterminado (se usa cuando este campo no se envía)
in_formbooleanOptional
Is het veld te zien in het aanmeldformulier? (boolean) Does this field occur in the subscription form? (boolean) Ist das Feld im Anmeldeformular zu sehen? (boolean) ¿El campo se ve en el formulario de registro? (boolean)
in_listbooleanOptional
Is het veld te zien in het overzicht in Laposta? (boolean) Is this field visible in Laposta’s overview? (boolean) Ist das Feld in der Übersicht in Laposta zu sehen? (boolean) ¿El campo se ve en la vista general de Laposta? (boolean)

Response

De aanvraag is gelukt. The request succeeded. Die Anfrage war erfolgreich. La solicitud se ha realizado correctamente.
fieldobjectOptional
Het field-object The field object Das field-Objekt El objeto field

Errors

400
Bad Request Error
401
Unauthorized Error
429
Too Many Requests Error