POST /encode

Request

POST https://api.spectralmemory.com/encode
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Field	Type	Required	Description
`user_id`	string	✅	Your user identifier
`label`	string	✅	Channel label (e.g. `USER.gpu`)
`value`	string	✅	Value to encode (max 4 chars effective)
`session_id`	string	—	Optional session identifier for research logging

{
  "user_id": "alice",
  "label": "USER.gpu",
  "value": "RTX5090",
  "session_id": "sess_001"
}

{
  "status": "ok",
  "label": "USER.gpu",
  "value": "RTX5090",
  "channel": 3,
  "channel_count": 1
}

Field	Description
`status`	`"ok"` on success
`label`	The label that was encoded
`value`	The value as provided
`channel`	Carrier channel index (0–39)
`channel_count`	Total number of facts currently encoded for this user

Code	Reason
`400`	Unknown label — see available channels
`401`	Invalid or missing API key
`429`	Monthly encode limit reached

Each call re-encodes the full composite signal. All previously stored facts are preserved.
Values longer than 4 characters are silently truncated to 4 bytes.
This call increments your monthly usage counter.