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

POST/auth/send-otp

Send OTP to user email for sign-in.

POST/auth/verify-otp

Verify OTP and create authenticated session.

GET/auth/me

Fetch current authenticated user context.

News

GET/news

Fetch live news feed across configured categories.

GET/news/{id}

Fetch detailed news item view.

POST/news/actions/bookmark

Bookmark a news item for the user.

Digests

GET/digests

Fetch digest list across domains.

GET/digests/{id}

Fetch a detailed digest.

Threads

GET/threads

List user chat threads.

POST/threads

Create a new thread.

PUT/threads/{id}

Rename or update a thread.

DELETE/threads/{id}

Delete a thread.

RAG / Files

POST/rag/upload

Upload PDF, image, or document for analysis.

Profile

GET/user/profile

Fetch user profile and preferences.

PUT/user/profile

Update user profile settings.

Chat

WS/chat

WebSocket 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

GET/v1/news/search

Search across domain-linked news and intelligence layers.

GET/v1/feed

Fetch category-aware feed data for external products.

GET/v1/trending

Get trending items across selected verticals.

POST/v1/chat/message

Ask OjasOS through external API workflows.

POST/v1/files/upload

Upload files for document workflows.

POST/v1/files/process

OCR, extraction, parsing, and digest generation.

GET/v1/memory

Retrieve context-aware memory objects.

GET/v1/threads

External thread access for integrated apps.

GET/v1/user/profile

Authenticated 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.