Collections

Update a collection

Changed on

Update the name or replace the contents of a collection. Updating the data or url for your collection fully replaces the contents of the collection.

Note:

  • If you reference your collection by name in active automation messages, changing the name of the collection will cause references to the previous name to return an empty data set.
  • 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}

Request

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

Request body

OR

Response

The collection was created successfully.

Example response

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

Changes