v3

OpenAPI 3.1.2Apache 2.02026-07-31231237972.0 KB
Last Actor task run's default dataset

Store items in last task run's dataset

Appends an item or an array of items to the end of the last Actor task run's default dataset.

This endpoint is a shortcut that resolves the last task run's defaultDatasetId and proxies to the Store items endpoint.

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/actor-tasks/{actorTaskId}/runs/last/dataset/items

Path parameters

actorTaskIdstring required
Example:janedoe~my-task

Task ID or a tilde-separated owner's username and task's name.

Query parameters

statusstring
Example:SUCCEEDED

Filter for the run status.

origin'DEVELOPMENT' | 'WEB' | 'API' | 'SCHEDULER' | 'TEST' | 'WEBHOOK' | 'ACTOR' | 'CLI' | 'CI' | 'STANDBY' | 'MCP'

Filter for the run origin, i.e. the means by which the run was started.

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.

OR
PutItemsRequest[] required

Example request

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

Response

object required

Example response

{}