Object Store

Query documents in a namespace (Mango selector)

Searches for documents within a namespace using PouchDB Mango query syntax. The ns namespace guard is injected automatically into every selector — callers cannot escape their namespace. Use dotted paths to filter on payload fields: { "payload.status": "active" }.

post/api/object-store/:namespace/query

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/object-store/:namespace/query
  • Auth: none declared

Path parameters

namespacestring required
Example:znp_projects

Namespace to search within.

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

selectorobject

Mango selector for payload fields (namespace guard injected automatically).

limitinteger

Maximum results to return (1–1000).

skipinteger

Number of documents to skip (for pagination).

tokenstring

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

Example request

{
  "selector": {
    "payload.status": "active"
  },
  "limit": 50
}

Response

Query results

totalDocsinteger

Example response

{
  "docs": [
    {
      "namespace": "znp_projects",
      "key": "a1b2c3d4",
      "createdAt": "2026-04-06T12:00:00.000Z",
      "updatedAt": "2026-04-06T12:00:00.000Z"
    }
  ],
  "totalDocs": 3
}

Changes

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