# Store items


```
POST 
https://api.apify.com/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](https://pr-2431.preview.docs.apify.com/api/v2/dataset-items-post.md) endpoint.

## Request

### Path Parameters

* **runId** string required

  Actor run ID.

  **Example:** `3KH8gEpp4d8uQSe8T`

### Body**required**

* 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.