Documentation

Quickstart

npm install @motionos/sdk

import { MotionOS } from '@motionos/sdk';

const motion = new MotionOS({
  apiKey: 'sb_secret_xxx',
  projectId: 'proj-123'
});

await motion.ingest('User prefers dark mode');
const ctx = await motion.retrieve('user preferences');

See Examples for more code samples.

API Reference

POST /v1/memory/ingest

Store memory in MotionOS

{
  "project_id": "proj-123",
  "raw_text": "User prefers dark mode",
  "agent_id": "assistant-1"
}

POST /v1/memory/retrieve

Retrieve memory from MotionOS

{
  "project_id": "proj-123",
  "query": "user preferences",
  "mode": "inject",
  "limit": 10
}

Error Codes

CodeDescription
invalid_api_keyAPI key is missing or invalid
project_mismatchProject ID doesn't match API key
rate_limitedRate limit exceeded
bad_payloadInvalid request payload

Rate Limits

  • Soft limit: 300 requests/minute
  • Hard limit: 600 requests/minute
  • • Rate limit headers included in all responses