---
title: "Changes to POST /api/v1/{context_id}/documents"
method: POST
path: "/api/v1/{context_id}/documents"
---

# Changes to POST /api/v1/{context_id}/documents

`POST /api/v1/{context_id}/documents`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 5 revisions.

- **2026-08-24** `9f1598713067` — 3 info
- **2026-06-16** `52b41ab517b6` — 3 info
- **2026-06-16** `6ad06b1fefc4` — 1 breaking
- **2026-06-08** `741d58b9ef89` — 1 breaking, 2 info

## Changes

- **2026-08-24** `9f1598713067` — 3 info
  - added the new optional request property `metadata/observedAtHeader`
  - added the non-success response with the status `503`
  - added the optional property `observedAt` to the response with the `202` status
- **2026-06-16** `52b41ab517b6` — 3 info
  - added the new optional request property `metadata/observedAt`
  - added the non-success response with the status `403`
  - added the non-success response with the status `409`
- **2026-06-16** `6ad06b1fefc4` — 1 breaking
  - added required request body
- **2026-06-08** `741d58b9ef89` — 1 breaking, 2 info
  - removed the request body
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `409`

---

[Operation](https://skmtc.dev/surrealdb/apis/spectron/docs/api/v1/:context_id/documents/post.md) · [API](https://skmtc.dev/surrealdb/apis/spectron.md) · [Page](https://skmtc.dev/surrealdb/apis/spectron/changes/api/v1/:context_id/documents/post)