EmemoX · Developer documentation

API reference

This reference includes operations available on this hosted deployment. Engine-only probes and administration are documented in the engine distribution.

Base URL

https://www.ememox.com/api/v1

Authentication

Authorization: Bearer YOUR_API_KEY

scope.robot_id: Your API key's project ID; not a robot device ID.
scope.subject_id: The memory subject in your application.
scope.session_id: The conversation within that project and subject.

Save conversation
Send scope and request_id; keep tracking_event_id. Acceptance and persistence are reported separately. Neither confirms memory formation.
Check processing
Check ordinary memory and cognition independently. SUCCEEDED confirms that task finished. Diagnose failed or missing tasks; recall requires formed, relevant memories.
Recall memory
Keep the same project and scope.subject_id in a new session. Set across_sessions to true to recall earlier conversations.

Get a project API keySign in to create a key for your app.

Run the complete example

Replace the URL, project ID and project API key, then run python3 ememox-quickstart.py. Requires Python 3; no packages needed. Expected: an accepted event, processing status, then matching memories. Keep the request_id unchanged when retrying this sample.

Download Python exampleCopy entire file

Endpoint reference

1 endpoint found. Paths below are relative to your site origin.

GET`/api/v1/event/{event_id}`

Check independent ordinary-memory and cognitive tasks. Accepted input is not completed processing. Poll accepted or running events; On transport failure, retry writes with the same request_id and body. Keep the event ID when contacting support.

Project API key or console session. Permissions: View event status

Available on: gateway

Parameter Type Required Description, limits and example

Parameter	Type	Required	Description, limits and example
`event_id` path parameter	`string`	Required in this object
`project_id` query parameter	`string`	Optional	On the gateway, required when authenticating with ConsoleSession: selects the project authorized for the signed-in account. Omit with a project API key, which already binds the project. Omitting it with a browser session selects the Demo workspace instead. Minimum characters: `1`

event_id

path parameter

string

Required in this object

project_id

query parameter

string

Optional

On the gateway, required when authenticating with ConsoleSession: selects the project authorized for the signed-in account. Omit with a project API key, which already binds the project. Omitting it with a browser session selects the Demo workspace instead.

Minimum characters: 1

200 · Operation result

Shared rejection responses: default. See common errors

Common errors

These shared rejection shapes are listed once. Each endpoint lists the applicable status codes; operation-specific results stay beside that endpoint.

Loading API endpoints…

Quick start

Save conversation

Check processing

Recall memory

Run the complete example

Endpoint reference

GET/api/v1/event/{event_id}

Common errors

Endpoint reference

GET/api/v1/event/{event_id}

Common errors

GET`/api/v1/event/{event_id}`

GET`/api/v1/event/{event_id}`