Update a Collection | Prolific API

curl -X PUT https://api.prolific.com/api/v1/data-collection/collections/collection_id \
     -H "Authorization: Token <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Updated Skin Type Assessment",
  "task_details": {
    "task_name": "Assess Your Skin Type",
    "task_introduction": "<p>Please answer the following questions about your skin.</p>",
    "task_steps": "<ol><li>Read each question carefully</li><li>Select the most accurate answer</li></ol>"
  },
  "collection_items": [
    {
      "page_items": [
        {
          "id": "01924850-9e29-744a-811c-b26612812346",
          "type": "rich_text",
          "content": "## Section 1: Basic Information"
        },
        {
          "id": "01924850-9e29-744a-811c-b26612812347",
          "type": "multiple_choice",
          "content": "What is your skin type? Select the option that best describes your skin condition throughout the day. This will help us recommend suitable skincare products for you."
        }
      ],
      "id": "01924850-9e29-744a-811c-b26612812345"
    }
  ]
}'

{
  "id": "a3f1c9d2-7b4e-4f8a-9d3e-2b7f6a1c9e4d",
  "schema_version": 1,
  "created_at": "2024-01-15T09:30:00Z",
  "created_by": "jane.doe@example.com",
  "workspace_id": "workspace-1234",
  "name": "Updated Skin Type Assessment",
  "task_details": {
    "task_name": "Assess Your Skin Type",
    "task_introduction": "<p>Please answer the following questions about your skin.</p>",
    "task_steps": "<ol><li>Read each question carefully</li><li>Select the most accurate answer</li></ol>"
  },
  "collection_items": [
    {
      "id": "01924850-9e29-744a-811c-b26612812345",
      "created_at": "2024-01-15T09:30:00Z",
      "created_by": "jane.doe@example.com",
      "schema_version": 1,
      "page_items": [
        {
          "id": "01924850-9e29-744a-811c-b26612812346",
          "created_at": "2024-01-15T09:30:00Z",
          "type": "rich_text",
          "collection_id": "01924850-9e29-744a-811c-b26612812345",
          "created_by": "jane.doe@example.com",
          "description": "Section header for basic information",
          "order": 0,
          "answer_limit": 0,
          "disable_dropdown": false,
          "options": [],
          "last_modified_at": "2024-01-15T09:30:00Z",
          "last_modified_by": "jane.doe@example.com"
        },
        {
          "id": "01924850-9e29-744a-811c-b26612812347",
          "created_at": "2024-01-15T09:30:00Z",
          "type": "multiple_choice",
          "collection_id": "01924850-9e29-744a-811c-b26612812345",
          "created_by": "jane.doe@example.com",
          "description": "What is your skin type?",
          "order": 1,
          "answer_limit": 1,
          "disable_dropdown": false,
          "options": [
            {
              "label": "Oily",
              "value": "oily"
            },
            {
              "label": "Dry",
              "value": "dry"
            },
            {
              "label": "Combination",
              "value": "combination"
            },
            {
              "label": "Normal",
              "value": "normal"
            }
          ],
          "last_modified_at": "2024-01-15T09:30:00Z",
          "last_modified_by": "jane.doe@example.com"
        }
      ],
      "last_modified_at": "2024-01-15T09:30:00Z",
      "last_modified_by": "jane.doe@example.com"
    }
  ],
  "last_modified_at": "2024-01-15T09:30:00Z",
  "last_modified_by": "jane.doe@example.com"
}

Update an existing AI Task Builder Collection. This is a full replacement — all fields must be provided.

To preserve existing entities (collection items, page items) when updating, include their id fields in the request. Entities without IDs will be created as new, and existing entities not included in the request will be deleted.

Authentication

AuthorizationToken

Header authentication of the form Token <token>

Path parameters

collection_idstringRequired

Request

This endpoint expects an object.

namestringRequired

The name of the collection

task_detailsobjectRequired

Task metadata displayed to participants

collection_itemslist of objectsRequired

Pages within the collection. Include id to preserve existing items.

Response

idstringformat: "uuid"

schema_versionenum

Allowed values:

created_atdatetime

ISO-8601 formatted creation timestamp in UTC

created_bystring

User ID of the Prolific user that created the collection

workspace_idstring

The ID of the Prolific workspace

namestring

The name of the collection

task_detailsobject

Task metadata displayed to participants

collection_itemslist of objects

Pages within the collection. Each collection item represents a page.

last_modified_atdatetime or null

ISO-8601 formatted last modification timestamp in UTC

last_modified_bystring or null

User ID of the Prolific user that last modified the collection

Authentication

Path parameters

Request

Response

Errors