> For the complete documentation index, see [llms.txt](https://docs.vomevolunteer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vomevolunteer.com/resources/schedule/shift-locations/write-operations.md).

# Write Operations

Shift locations can be created and updated in bulk.

* **Create shift locations** adds new addresses.
* **Update shift locations** changes existing ones, matched by ID.

Both answer with the same shape, where `errors` is keyed by the position of the entry in your request, starting at `1`.

```json
{
  "success": true,
  "processed": 1,
  "shift_locations": [
    { "id": "6f3b1c2a-...", "title": "Downtown Branch" }
  ],
  "errors": {}
}
```

<mark style="color:red;">By default, nothing is written unless every entry is valid, and the response is</mark> <mark style="color:red;">**400**</mark><mark style="color:red;">. Set</mark> <mark style="color:red;">**allow\_partial**</mark> <mark style="color:red;">to</mark> <mark style="color:red;">**true**</mark> <mark style="color:red;">to write the valid entries and have the rest reported back.</mark>

A request may carry at most 500 shift locations.
