Skip to main content
method
POST
/signal
Authentication: Required (if enabled) Ingest a signal representing a grounded observation: Entity | Attribute | Value.

Request Body

{
  "entity_id": 1,
  "attribute": "name",
  "value": "Alice"
}
FieldTypeRequiredConstraintsDescription
entity_idinteger (u64)YesEntity identifier.
attributestringYesMax 256 bytes, non-emptyAttribute name.
valuestringYesMax 64 KB, non-emptyAttribute value.

Response

{
  "success": true,
  "node_id": 0,
  "error": null
}
FieldTypeDescription
successbooleanWhether ingestion succeeded.
node_idinteger or nullCreated/existing node ID (if successful).
errorstring or nullError message (if failed).

Example

curl -X POST http://localhost:8080/signal \
     -H "Authorization: Bearer your-api-key" \
     -H "Content-Type: application/json" \
     -d '{"entity_id": 1, "attribute": "name", "value": "Alice"}'
Last modified on February 19, 2026