---
title: "PUT /api/databases/{database_pk}/records/{key}/"
method: PUT
path: "/api/databases/{database_pk}/records/{key}/"
tags: ["databases"]
---

# PUT /api/databases/{database_pk}/records/{key}/

`PUT /api/databases/{database_pk}/records/{key}/`

Replace or merge a record in the database (creating it if it does not yet exist), targeting a single record when a key is provided in the path or one or more records supplied in the request body.

## Path parameters

- `database_pk` string, required
- `key` string, required

## Request body

- Record
  - `id` string, required
  - `data` object, required
  - `merge_strategy` 'replace' | 'deep' | 'deep_append' | 'shallow' | ''
  - `created_at` string, date-time

## Response `200`

---

[API](https://skmtc.dev/pixiebrix/apis/pixiebrix-api.md) · [All operations](https://skmtc.dev/pixiebrix/apis/pixiebrix-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pixiebrix/pixiebrix-api/revisions/941ab9eb01d6/schema)