Developer Portal

Build on DESIRIY

Access the DESIRIY platform through REST APIs, WebSocket events, and official SDKs. Build integrations that extend what people can do on DESIRIY.

API Overview

Base URL

https://api.desiriy.com/v1

Authentication

All API requests require a Bearer token obtained through the /auth/token endpoint.

Rate Limits

Default500 requests / 15 minutes per IP
Authenticated1000 requests / 15 minutes per user
MethodPathDescription
POST/auth/registerRegister a new user account
POST/auth/loginAuthenticate and receive tokens
POST/auth/refreshRefresh an access token
GET/users/{id}Get a public user profile
GET/postsList public posts
POST/postsCreate a post
GET/posts/{id}Get a post by ID
GET/momentsList public moments
GET/journeysList public journeys
GET/searchSearch platform content
GET/notificationsGet user notifications
POST/media/uploadUpload media assets

WebSocket

wss://ws.desiriy.com
moment.updatenotification.newstatus.change

SDKs

JavaScript / TypeScript SDK

v1.0.0
npm install @desiriy/sdk
Documentation →GitHub →

React Native SDK

v1.0.0
npm install @desiriy/react-native-sdk
Documentation →GitHub →

Changelog

v1.0.0
Platform LaunchFeature

Initial public release of the DESIRIY API. Includes authentication, moments, journeys, and public content endpoints.

October 17, 2026

v1.1.0
WebSocket SupportFeature

Added WebSocket support for real-time moment updates and live broadcast signaling.

October 3, 2026

v1.2.0
Rate Limit HeadersFeature

All API responses now include X-RateLimit-Remaining and X-RateLimit-Reset headers.

September 17, 2026