---
title: "Update Stores in Bulk"
method: PUT
path: "/v2/locations/stores"
---

# Update Stores in Bulk

`PUT /v2/locations/stores`

Update up to 100 stores in a single request.

## Query parameters

- `inheritLocale` boolean

## Headers

- `Authorization` string
- `X-CAP-API-OAUTH-TOKEN` string

## Request body

- object[]
  - `identifierName` string, required — Identifier type. Must be one of: ID, CODE, EXTERNAL_ID. Case-insensitive.
  - `identifierValue` string, required — The value for the given identifier type.
  - `name` string — Display name. Cannot be set to null or empty. Cannot equal ROOT (any case). Max 100 characters. Accepts letters, digits, underscores, and spaces.
  - `description` string, nullable — Free-text description. Set to null to clear.
  - `isAdmin` boolean
  - `isActive` boolean
  - `latitude` string, nullable
  - `longitude` string, nullable
  - `email` string, nullable
  - `mobile` string, nullable
  - `landline` string, nullable
  - `areaParentCode` string — Code of the parent zone. Cannot be set to null.
  - `groupParentCode` string — Code of the parent concept. Cannot be set to null.
  - `externalIds` object, nullable — Key-value map of external identifiers. Omit to preserve. Set to null to clear all. Set a key's value to null to remove that specific key. Pass {} to make no change. Maximum five entries. Keys and values must not exceed 200 characters each.
  - `customFields` object, nullable — Key-value map of custom field values. Omit to preserve. Set to null to clear all. Set a key's value to null to remove that specific key. Pass {} to make no change. Keys must match custom fields configured for the org.
  - `language` string — IETF BCP 47 language code.
  - `currency` string — ISO 4217 currency code.
  - `timezone` string — IANA timezone name.

## Response `200`

All stores updated successfully.

- BulkResponseList
  - `response` object[]
    - `entityId` integer — System ID of the updated concept. Present when the concept was identified, regardless of whether the update succeeded. Absent when the concept could not be identified, or when an unexpected error occurs.
    - `result` object — Echo of the submitted request object for this concept.
    - `errors` object[]
      - `status` boolean
      - `code` integer
      - `message` string
    - `warnings` object[]
      - `status` boolean
      - `code` integer
      - `message` string
  - `totalCount` integer — Total number of concept records in the request.
  - `failureCount` integer — Number of concepts that failed to update.

## Other responses

- `207` — Partial success — some stores updated, some failed.
- `400` — All items failed, batch exceeds 100 items, or empty request body.
- `401` — Authentication failed. The token is missing, expired, or invalid.

---

[API](https://skmtc.net/capillarytech/apis/sample-api.md) · [All operations](https://skmtc.net/capillarytech/apis/sample-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/capillarytech/sample-api/revisions/de241f2ed9b3/schema)