Store items

POST 
/v2/actor-runs/:runId/dataset/items

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

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

Request

Path Parameters

runId string required
Actor run ID.

Example: 3KH8gEpp4d8uQSe8T

Bodyrequired

oneOf
• PutItemsRequest
• object[]
object
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.

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

Status 201

Response Headers

• Location

{}

Schema

• object object
  Example: {}

Status 400

Response Headers

{
  "error": {
    "type": "schema-validation-error",
    "message": "Schema validation failed",
    "data": {
      "invalidItems": [
        {
          "itemPosition": 2,
          "validationErrors": [
            {
              "instancePath": "/1/stringField",
              "schemaPath": "/items/properties/stringField/type",
              "keyword": "type",
              "params": {
                "type": "string"
              },
              "message": "must be string"
            }
          ]
        }
      ]
    }
  }
}

Schema

• error object required

  • type string

    The type of the error.

    
    Example: schema-validation-error
  • message string

    A human-readable message describing the error.

    
    Example: Schema validation failed
  • data object

    • invalidItems object[] required

      A list of invalid items in the received array of items.

      • itemPosition integer

        The position of the invalid item in the array.

        
        Example: 2
      • validationErrors object[]

        A complete list of AJV validation error objects for the invalid item.

        • instancePath string

          The path to the instance being validated.

        • schemaPath string

          The path to the schema that failed the validation.

        • keyword string

          The validation keyword that caused the error.

        • message string

          A message describing the validation error.

        • params object

          Additional parameters specific to the validation error.

Status 403

Forbidden - insufficient permissions to perform this action.

{
  "error": {
    "type": "permission-denied",
    "message": "You do not have permission to perform this action."
  }
}

Schema

• error object required

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [actor-memory-limit-exceeded, actor-not-found, invalid-input, method-not-allowed, page-not-found, permission-denied, rate-limit-exceeded, record-not-found, record-not-unique, record-or-token-not-found, request-id-invalid, request-too-large, run-failed, run-timeout-exceeded, schedule-actor-not-found, schedule-actor-task-not-found, token-not-valid, unknown-build-tag, unsupported-content-encoding, user-not-found]

  • message string

    Human-readable error message describing what went wrong.

Status 404

Not found - the requested resource does not exist.

{
  "error": {
    "type": "record-not-found",
    "message": "The requested resource was not found."
  }
}

Schema

• error object required

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [actor-memory-limit-exceeded, actor-not-found, invalid-input, method-not-allowed, page-not-found, permission-denied, rate-limit-exceeded, record-not-found, record-not-unique, record-or-token-not-found, request-id-invalid, request-too-large, run-failed, run-timeout-exceeded, schedule-actor-not-found, schedule-actor-task-not-found, token-not-valid, unknown-build-tag, unsupported-content-encoding, user-not-found]

  • message string

    Human-readable error message describing what went wrong.