Page metadata

​

What you get

• Values are any JSON: 0.92, true, ["a","b"], {"due":"2026-08-01"}.
• Merge-patch writes: send only the keys you’re changing.
  • set upserts (JSON null deletes)
  • append extends arrays atomically
  • appendUnique skips duplicates so re-run agents are idempotent
• Per-key audit trail: who set what, when, with previous values.
• Queryable: eq, neq, exists, missing, gt/gte/lt/lte (numbers and ISO-date strings), contains (array containment), and in / not-in (the value is any, or none, of a list of candidates). Filters are AND-ed together, with orderBy ranking.
• Discoverable: GET /search/metadata/keys lists the key namespace with usage counts so writers converge on existing keys, and GET /search/metadata/values lists the values in use for one key.

​

Patch example

curl -X PATCH "https://api.coconut.md/pages/demo/customer-acme/metadata" \
  -H "Authorization: Bearer $COCO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"set":{"stage":"diligence","conviction-score":0.8},
       "appendUnique":{"sources":["https://news.example/acme"]}}'

​

Query example

curl -G "https://api.coconut.md/search/metadata" \
  -H "Authorization: Bearer $COCO_API_KEY" \
  --data-urlencode 'filters=[{"key":"stage","op":"eq","value":"diligence"},{"key":"conviction-score","op":"gte","value":0.7}]' \
  --data-urlencode 'orderBy=conviction-score' --data-urlencode 'order=desc'

​

Keeping keys consistent