Skip to content

DNA_KEY_VALUE_API.md

Latest commit

 

History

History
39 lines (24 loc) · 1.93 KB

DNA_KEY_VALUE_API.md

File metadata and controls

39 lines (24 loc) · 1.93 KB

DNA Key-Value API (sdk.db.get / sdk.db.set)

Version: 0.1
Related: 8DNA, PHILOSOPHY_INDEX

Overview

The DNA API exposes a key-value interface for built apps: keys of the form project.data.<path> or user.data.<path> map to JSON stored in 8DNA tables data_projects_project and data_projects_user respectively. This corresponds to SDK usage: sdk.db.get(key) and sdk.db.set(key, value).

Endpoints

DNA API base path: /api/dna (no version in paths).

Method Full path Description
GET GET /api/dna/data Get value at key. Query: key (required), project_id (required for project.data.*).
POST POST /api/dna/data Set value at key. Body: { "key": "...", "value": <any>, "project_id": <optional> }.

Key format

  • project.data.<path> — Dot-separated path into the project entity’s data (e.g. project.data.config.theme). Requires project_id (query or body).
  • user.data.<path> — Dot-separated path into the current user’s project-scoped data (e.g. user.data.preferences.lang). Uses current user and project from session; project_id optional to override.

Permissions

  • project.data.* — Caller may only read/write data for their own project: current_user.project_id == project_id or current_user.is_ecosystem. Otherwise 403.
  • user.data.* — Caller may only read/write the authenticated user’s own data (user_id and project_id from session). No access to other users’ data.

Source of truth

  • Project key-value: data_projects_project.data (one row per project).
  • User key-value: data_projects_user.data (per project_id + user_id). Missing row is created on first set for user.data.

Philosophy

  • 8DNA: Single API for all project/user data; one source of truth per entity.
  • Decomposition: Key-value module is separate from other DNA endpoints; permissions checked at API boundary.