Collections

Update the contents of a collection

Changed on

Replace the contents of a collection (the data from when you created or updated a collection). The request is a free-form object containing the keys you want to reference from the collection and the corresponding values. This request replaces the current contents of the collection entirely.

If you don't want to update the contents directly—you want to change the name or data url for your collection, use the update a collection endpoint.

Note: A collection can't be larger than 10 MB, and each top-level field in a row can hold up to 10,000 characters. The total size of all collections in your account can't exceed 5 GB. Customer.io rejects a request that would take your account over that limit.

put/v1/collections/{collection_id}/content

Request

  • Base URL
    https://api.customer.io
  • URL
    https://api.customer.io/v1/collections/{collection_id}/content
  • Auth
    HTTP bearer

Request body

object required

Response

Returns your collection metadata and the updated schema.

Example response

{
  "collection": {
    "bytes": 296,
    "created_at": 1552341937,
    "updated_at": 1552341937,
    "id": 1,
    "name": "upcoming events",
    "rows": 2,
    "schema": [
      "eventDate",
      "eventName",
      "presents"
    ]
  }
}

Changes