Actor builds6

Actor runs10

Actor tasks15

Actors9

Actors/Actor builds6

Actors/Actor runs11

Actors/Actor versions13

Actors/Webhook collection1

Default dataset6

Default key-value store9

Default request queue15

Last Actor run's abort1

Last Actor run's default dataset6

Last Actor run's default key-value store9

Last Actor run's default request queue15

Last Actor run's log1

Last Actor run's metamorph1

Last Actor run's reboot1

Last Actor task run's abort1

Last Actor task run's default dataset6

Last Actor task run's default key-value store9

Last Actor task run's default request queue15

Last Actor task run's log1

Last Actor task run's metamorph1

Last Actor task run's reboot1

Logs1

Schedules7

Storage/Datasets9

Storage/Key-value stores12

Storage/Request queues7

Storage/Request queues/Requests5

Storage/Request queues/Requests locks5

Store1

Tools4

Tools/Encoding2

Users5

Users/Usage6

Webhooks/Webhook dispatches2

Webhooks/Webhooks7

Storage/Datasets

Store items in dataset

Changed on Oct 27, 2026

Appends an item or an array of items to the end of the dataset. The POST payload is a JSON object or a JSON array of objects to save into the dataset.

If the data you attempt to store in the dataset is invalid (meaning any of the items received by the API fails the validation), the whole request is discarded and the API will return a response with status code 400. For more information about dataset schema validation, see Dataset schema.

IMPORTANT: The limit of request payload size for the dataset is 5 MB. If the array exceeds the size, you'll need to split it into a number of smaller arrays.

To save bandwidth and speed up your upload, you can send the request payload compressed and set the Content-Encoding header accordingly.

Below is a list of supported Content-Encoding types.

Brotli: Content-Encoding: br
Gzip: Content-Encoding: gzip
Deflate: Content-Encoding: deflate

post/v2/datasets/{datasetId}/items

Request

Base URL
https://api.apify.com
Auth
- HTTP bearer
- or API key in query parameter token

Path parameters

datasetIdstring required

Example:WkzbQMuFYuamGv3YF

Dataset ID or username~dataset-name.

Headers

Content-Encoding'br' | 'gzip' | 'deflate' | 'identity'

Compression encoding of the request body.

Request body

PutItemsRequest required

The request body containing the item(s) to add to the dataset. Can be a single object or an array of objects. Each object represents one dataset item.

PutItemsRequest[] required

Example request

{
  "title": "Example Item",
  "url": "https://example.com",
  "price": 19.99
}

Response

object required

Example response

{}

Changes

Oct 27, 2026ec76185eb934 Revision changes
- info
  added the optional property // to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
Oct 20, 202616b486b0397a Revision changes
- warning
  added the new full-permissions-require-verified-owner enum value to the // response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the // response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the // response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the // response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the // response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the // response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the // response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the // response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the // response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status

Operation history (5 revisions)