OjasOS API Platform
APIs and real-time workflows for news, digests, documents, chat, and structured intelligence
OjasOS currently powers an authenticated product stack built around OTP sign-in, live news, digests, threads, document upload, and real-time chat. A broader external developer API layer is also planned for business, institutions, and integrations.
Current Product API
Used by the live OjasOS app for auth, feeds, digests, uploads, profile, threads, and real-time chat.
Auth Model
Current app access is based on OTP + JWT sessions. Planned external developer access is designed around API keys with quota and rate limits.
Business Use
Useful for coaching systems, institutions, EdTech, market workflows, legal/compliance systems, MSMEs, and research-heavy products.
Current API
These routes reflect the current product-facing backend used by the OjasOS app.
Authentication
/auth/send-otpSend OTP to user email for sign-in.
/auth/verify-otpVerify OTP and create authenticated session.
/auth/meFetch current authenticated user context.
News
/newsFetch live news feed across configured categories.
/news/{id}Fetch detailed news item view.
/news/actions/bookmarkBookmark a news item for the user.
Digests
/digestsFetch digest list across domains.
/digests/{id}Fetch a detailed digest.
Threads
/threadsList user chat threads.
/threadsCreate a new thread.
/threads/{id}Rename or update a thread.
/threads/{id}Delete a thread.
RAG / Files
/rag/uploadUpload PDF, image, or document for analysis.
Profile
/user/profileFetch user profile and preferences.
/user/profileUpdate user profile settings.
Chat
/chatWebSocket chat endpoint for real-time streaming.
Current cURL Examples
These examples match the current authenticated product API and typically use JWT-based access.
Get Live News Feed
curl -X GET "https://api.ojasos.com/news" \ -H "Authorization: Bearer YOUR_JWT_TOKEN"
Fetch Digests
curl -X GET "https://api.ojasos.com/digests" \ -H "Authorization: Bearer YOUR_JWT_TOKEN"
Upload PDF
curl -X POST "https://api.ojasos.com/rag/upload" \ -H "Authorization: Bearer YOUR_JWT_TOKEN" \ -F "file=@/path/to/document.pdf"
Fetch Threads
curl -X GET "https://api.ojasos.com/threads" \ -H "Authorization: Bearer YOUR_JWT_TOKEN"
API & Integration Access
OjasOS currently operates through a structured application layer using OTP-based authentication, real-time feeds, document workflows, and conversational intelligence.
For business and institutional use cases, OjasOS supports controlled integration workflows, allowing teams to access feeds, digests, documents, and chat systems through backend connectivity.
Current Integration Model
- • OTP-based authentication (user-level access)
- • JWT-backed session workflows
- • cURL-based testing for backend endpoints
- • WebSocket chat for real-time streaming
- • Controlled onboarding for business integrations
External Developer API (Evolving)
A broader API layer with API key access, rate limits, and structured endpoints is being developed for coaching systems, EdTech platforms, MSMEs, and integration-driven products.
Integration Approach
OjasOS follows a controlled integration model. Instead of open public access, integrations are aligned based on use case, scale, and workflow requirements.
- • Start with product access (OTP-based)
- • Move to backend workflows via cURL
- • Expand into structured API access
- • Optional deeper integration (CLI / custom flows)
Real-time Chat
OjasOS uses a WebSocket chat layer for live streaming conversations. This powers real-time answer delivery, thread continuity, and future document-linked chat workflows.
wss://api.ojasos.com/chat
Planned External Developer API
This layer is intended for B2B customers, institutions, coaching systems, EdTech platforms, research tools, and external developer integrations.
Planned External Developer API
/v1/news/searchSearch across domain-linked news and intelligence layers.
/v1/feedFetch category-aware feed data for external products.
/v1/trendingGet trending items across selected verticals.
/v1/chat/messageAsk OjasOS through external API workflows.
/v1/files/uploadUpload files for document workflows.
/v1/files/processOCR, extraction, parsing, and digest generation.
/v1/memoryRetrieve context-aware memory objects.
/v1/threadsExternal thread access for integrated apps.
/v1/user/profileAuthenticated user profile access.
Planned External News Search
curl -X GET "https://api.ojasos.com/v1/news/search?q=RBI%20policy&domain=finance&limit=10" \ -H "Authorization: Bearer YOUR_API_KEY"
Planned External Feed API
curl -X GET "https://api.ojasos.com/v1/feed?domain=education&limit=10" \ -H "Authorization: Bearer YOUR_API_KEY"
Need business or integration access?
OjasOS can support current product usage today and broader developer/API access for business use cases as the external API layer matures.