# @sanity/mutate
> [!NOTE]
> Experimental. Use at your own risk.
A TypeScript toolkit for [Sanity](https://sanity.io) mutations:
- Declarative, composable mutation creators
- A pure, in-memory apply engine
- An optimistic local store with rebase semantics
## Install
```sh
npm install @sanity/mutate
```
## Example
```ts
import {
at,
create,
createIfNotExists,
patch,
SanityEncoder,
set,
setIfMissing,
} from '@sanity/mutate'
const projectId = ''
const dataset = ''
const mutations = [
create({_type: 'dog', name: 'Fido'}),
createIfNotExists({_id: 'document-1', _type: 'someType'}),
patch('other-document', [
at('published', set(true)),
at('address', setIfMissing({_type: 'address'})),
at('address.city', set('Oslo')),
]),
]
await fetch(
`https://${projectId}.api.sanity.io/v2026-05-12/data/mutate/${dataset}`,
{
method: 'POST',
mode: 'cors',
credentials: 'include',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify(SanityEncoder.encodeAll(mutations)),
},
)
```
## Documentation
Full reference and guides at **** (sources in [`docs/`](./docs); run the site locally with `pnpm docs:dev`):
- [Getting Started](https://mutate.sanity.dev/guide/getting-started)
- [Applying Mutations](https://mutate.sanity.dev/guide/applying-mutations) — in-memory apply
- [Optimistic Store](https://mutate.sanity.dev/guide/optimistic-store) — local replica with rebase
- [Recipes](https://mutate.sanity.dev/guide/recipes)
- [Differences from the Sanity API](https://mutate.sanity.dev/guide/differences-from-sanity-api)
- API reference: [mutations](https://mutate.sanity.dev/api/mutations), [patches](https://mutate.sanity.dev/api/patches), [operations](https://mutate.sanity.dev/api/operations), [encoders](https://mutate.sanity.dev/api/encoders)
## License
MIT
