Skip to main content
POST
Store a knowledge cell

Authorizations

x-hyphae-key
string
header
required

The API key issued for the calling agent. Required on every endpoint except GET /healthz.

Body

application/json

The body for POST /v1/store.

content
string
required

The cell's text content.

cell_type
enum<string>
required

The nine cell types the energy and promotion models are calibrated against.

Available options:
Decision,
Constraint,
Risk,
Pattern,
Lesson,
Fact,
Preference,
Context,
Task
salience
number<float>
default:0.5

Importance hint in [0.0, 1.0]; the server clamps out-of-range values.

Required range: 0 <= x <= 1
scene_id
string<uuid>

An optional owning scene id.

source_ref
object

A reference back to the source of a cell's content (e.g. file:line, url).

metadata
object

Arbitrary JSON metadata; defaults to an empty object.

idempotency_key
string

An optional key to deduplicate retried stores.

Response

The stored cell's node id.

node_id
string<uuid>
required

The stored cell's node id.