Object Store

Create or update a document in the Object Store (upsert)

Upserts a document identified by namespace + key. On update the payload is fully replaced and updatedAt is refreshed; createdAt is preserved. Optional CAS: callers may pass _rev. On revision mismatch, the action returns HTTP 409 OBJECT_OCC_CONFLICT.

put/api/objects/:namespace/:key

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/objects/:namespace/:key
  • Auth: none declared

Path parameters

namespacestring required
Example:znp_projects
keystring required
Example:a1b2c3d4

Query parameters

tokenstring

Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.

Request body

payloadobject required

Arbitrary JSON payload to store.

_revstring nullable

Optional PouchDB revision for CAS updates. Use null for create-if-not-exists CAS semantics.

tokenstring

Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

Example request

{
  "payload": {
    "name": "My Project",
    "status": "active"
  },
  "_rev": "2-4f8a63d0f9c94d97a0b5b6f8cdef1234"
}

Response

Document created or updated

namespacestring
keystring
payloadobject
_revstring

Current PouchDB document revision after upsert.

createdAtstring
updatedAtstring

Example response

{
  "namespace": "znp_projects",
  "key": "a1b2c3d4",
  "payload": {
    "name": "My Project"
  },
  "_rev": "2-4f8a63d0f9c94d97a0b5b6f8cdef1234",
  "createdAt": "2026-04-06T12:00:00.000Z",
  "updatedAt": "2026-04-06T12:00:00.000Z"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.