Skip to main content

​
Overview

The Omi Developer API provides programmatic access to your personal Omi data, allowing you to build custom applications and integrations. Use it to create analytics dashboards, export data to other services, build automation workflows, or contribute data back to your Omi account.

Memories

Read & write user memories

Conversations

Access full transcripts

Action Items

Manage tasks & to-dos

API Keys

Manage API access

​
Quick Start

Get Your API Key

Open the Omi app and navigate to Settings → Developer → Create Key
Copy the key immediately - you won’t be able to see it again!

Make Your First Request

curl -H "Authorization: Bearer omi_dev_your_key_here" \
  https://api.omi.me/v1/dev/user/memories?limit=5

Explore the Endpoints

Check out the endpoint pages for detailed documentation on each resource.

​
Base URL

https://api.omi.me/v1/dev
For self-hosted instances, replace with your backend URL.

​
Endpoints at a Glance

Memories

MethodEndpointDescription
GET/v1/dev/user/memoriesRetrieve memories
POST/v1/dev/user/memoriesCreate a memory
POST/v1/dev/user/memories/batchCreate up to 25 memories
MethodEndpointDescription
GET/v1/dev/user/action-itemsRetrieve action items
POST/v1/dev/user/action-itemsCreate an action item
POST/v1/dev/user/action-items/batchCreate up to 50 action items
MethodEndpointDescription
GET/v1/dev/user/conversationsRetrieve conversations
POST/v1/dev/user/conversationsCreate from text
POST/v1/dev/user/conversations/from-segmentsCreate from transcript segments
MethodEndpointDescription
GET/v1/dev/keysList all API keys
POST/v1/dev/keysCreate new API key
DELETE/v1/dev/keys/{key_id}Revoke API key

​
Authentication

All API requests require your Developer API key in the Authorization header: 
Authorization: Bearer omi_dev_your_api_key_here
Never commit API keys to version control or share them publicly!

​
Rate Limits

LimitValue
Per minute100 requests per API key
Per day10,000 requests per user
Rate limit headers are included in responses: 
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1642694400

​
Error Responses

HTTP Status Codes

CodeMeaning
200 OKRequest succeeded
204 No ContentRequest succeeded with no response body
400 Bad RequestInvalid request parameters
401 UnauthorizedInvalid or missing API key
403 ForbiddenAPI key doesn’t have required permissions
404 Not FoundResource not found
422 Unprocessable EntityValidation error
429 Too Many RequestsRate limit exceeded
500 Internal Server ErrorServer error
{
  "detail": "Invalid API key"
}

​
Security Best Practices

Store Keys Securely

Use environment variables or secret management services

Rotate Keys Regularly

Generate new keys and revoke old ones periodically

Use Specific Keys

Create separate keys for different applications

Monitor Usage

Check the “last used” timestamp in your key list
If a key is compromised, revoke it immediately from Settings → Developer in the Omi app.

​
Developer API vs MCP

FeatureDeveloper APIMCP
PurposeDirect HTTP API accessAI assistant integration
AccessRead & write user dataRead/write with AI context
Use CaseCustom apps, dashboards, automationClaude Desktop, AI agents
AuthenticationBearer tokenEnvironment variable
Best ForWeb apps, integrations, batch operationsAI-powered workflows

Use Developer API when you need

  • Programmatic access for custom applications
  • Batch operations (multiple memories/action items)
  • Integration with external services
  • Custom automation workflows

Use MCP when you want

  • AI assistants like Claude to interact with your data
  • Natural language queries and AI-powered insights
  • Context-aware AI assistance
Learn more about the Model Context Protocol in the MCP documentation.

​
Other APIs

Looking for different API capabilities? Omi offers several APIs for different use cases:

Integration Import APIs

For App Developers - Create conversations and memories on behalf of users who have enabled your app

Webhook Triggers

For App Developers - Receive real-time notifications when memories are created or transcripts are processed

Chat Tools

For App Developers - Add custom tools that Omi’s AI can invoke during conversations

Audio Streaming

For App Developers - Process raw audio bytes in real-time via WebSocket
The Developer API (this section) is for accessing your own personal data. The APIs above are for building apps that interact with other users’ data (with their permission).