---
title: "Bulk write datastore items"
method: POST
path: "/api/v2/actions-datastores/{datastore_id}/items/bulk"
tags: ["Actions Datastores"]
---

# Bulk write datastore items

`POST /api/v2/actions-datastores/{datastore_id}/items/bulk`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/actions-datastores/{datastore_id}/items/bulk`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

Creates or replaces multiple items in a datastore by their keys in a single operation.

## Path parameters

- `datastore_id` string, required

## Request body

- BulkPutAppsDatastoreItemsRequest: Request to insert multiple items into a datastore in a single operation.
  - `data` BulkPutAppsDatastoreItemsRequestData: Data wrapper containing the items to insert and their configuration for the bulk insert operation.
    - `attributes` BulkPutAppsDatastoreItemsRequestDataAttributes: Configuration for bulk inserting multiple items into a datastore.
      - `conflict_mode` 'fail_on_conflict' | 'overwrite_on_conflict': How to handle conflicts when inserting items that already exist in the datastore.
      - `values` object[], required: An array of items to add to the datastore, where each item is a set of key-value pairs representing the item's data. Up to 100 items can be updated in a single request.
    - `type` 'items', required: The resource type for datastore items.

## Response `200`

OK

- PutAppsDatastoreItemResponseArray: Response after successfully inserting multiple items into a datastore, containing the identifiers of the created items.
  - `data` PutAppsDatastoreItemResponseData[], required: An array of data objects containing the identifiers of the successfully inserted items.
    - `id` string: The unique identifier assigned to the inserted item.
    - `type` 'items', required: The resource type for datastore items.

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)