API Reference
  1. Alloy API
  2. Custom Lists

Append Entries to a Custom List Version

post
https://sandbox.alloy.co/v1/custom-lists//append

Append entries to the latest minor version of a major version in place, without creating a new version. The entries are added to the existing version and the version string is unchanged. This differs from POST /custom-lists/{customListToken}/versions with an added body, which creates a new minor version. Appends always target the latest minor version of the specified major version.

Path Params
string
required
^CI-[\dA-Za-z]{20}$

Custom List Token of the list

Body Params
base_version
object
required

The major version to append entries to. Entries are always appended to the latest minor version of this major version, in place, without creating a new version. Optionally provide 'minor_version' to assert the target; it must match the latest minor version of the major version or the request is rejected.

added
array of objects
required
length ≥ 1

Array of data entries to append to the latest minor version. Must contain at least one entry.

added*
Responses

400

Bad request - Invalid Input Data, or the target version is not the latest minor version of the major version

403

Forbidden - Insufficient Permissions

404

Custom List or Major Version Not Found

409

Conflict - An append is already in progress for this version

Updated 4 days ago

Did this page help you?
Language
Credentials
LoadingLoading…
Response
Choose an example:
application/json

Updated 4 days ago

Did this page help you?