Skip to main content
GET
/
api
/
sessions
/
:id
curl -X GET "https://app.joip.io/api/sessions/123" \
  -H "Cookie: connect.sid=YOUR_SESSION_COOKIE"
{
  "session": {
    "id": 123,
    "title": "My JOI Session",
    "userId": "user_abc123",
    "subreddits": ["joi", "femdom"],
    "categoryId": 1,
    "intervalMin": 5,
    "intervalMax": 15,
    "transition": "fade",
    "thumbnail": "https://i.redd.it/thumb.jpg",
    "aiPrompt": null,
    "captionTheme": "joi",
    "isPublic": false,
    "isFavorite": true,
    "isManualMode": false,
    "isImported": false,
    "createdAt": "2025-03-02T10:00:00Z",
    "updatedAt": "2025-03-02T10:00:00Z"
  },
  "media": [
    {
      "id": 1001,
      "sessionId": 123,
      "mediaUrl": "https://i.redd.it/image1.jpg",
      "thumbnail": "https://i.redd.it/image1.jpg",
      "caption": null,
      "type": "image",
      "redditPostId": "abc123",
      "redditPostUrl": "https://reddit.com/r/joi/comments/abc123",
      "subreddit": "joi",
      "order": 0
    },
    {
      "id": 1002,
      "sessionId": 123,
      "mediaUrl": "https://i.redd.it/video1.mp4",
      "thumbnail": "https://i.redd.it/video1_thumb.jpg",
      "caption": "Follow my instructions...",
      "type": "video",
      "redditPostId": "def456",
      "redditPostUrl": "https://reddit.com/r/femdom/comments/def456",
      "subreddit": "femdom",
      "order": 1
    }
  ]
}

Authentication

This endpoint requires authentication. Users can only access sessions they own or sessions marked as public.

Path Parameters

id
integer
required
The unique session ID

Response

Returns a session object along with all associated media items.
session
object
The session metadata object
id
integer
Unique session identifier
title
string
Session title
userId
string
Owner’s user ID
subreddits
array
Array of subreddit names
intervalMin
integer
Minimum slide interval in seconds
intervalMax
integer
Maximum slide interval in seconds
transition
string
Transition effect type
thumbnail
string
Session thumbnail URL
captionTheme
string
Caption generation theme
isPublic
boolean
Public accessibility flag
isFavorite
boolean
Favorite status
isManualMode
boolean
Auto-advance disabled flag
isImported
boolean
Imported session flag
media
array
Array of media items in the session
id
integer
Media item ID
sessionId
integer
Parent session ID
mediaUrl
string
URL to the media file
thumbnail
string
Media thumbnail URL
caption
string
Pre-generated or stored caption text
type
string
Media type: “image”, “gif”, or “video”
redditPostId
string
Original Reddit post ID
redditPostUrl
string
Original Reddit post URL
subreddit
string
Source subreddit name
order
integer
Display order (0-based)
curl -X GET "https://app.joip.io/api/sessions/123" \
  -H "Cookie: connect.sid=YOUR_SESSION_COOKIE"
{
  "session": {
    "id": 123,
    "title": "My JOI Session",
    "userId": "user_abc123",
    "subreddits": ["joi", "femdom"],
    "categoryId": 1,
    "intervalMin": 5,
    "intervalMax": 15,
    "transition": "fade",
    "thumbnail": "https://i.redd.it/thumb.jpg",
    "aiPrompt": null,
    "captionTheme": "joi",
    "isPublic": false,
    "isFavorite": true,
    "isManualMode": false,
    "isImported": false,
    "createdAt": "2025-03-02T10:00:00Z",
    "updatedAt": "2025-03-02T10:00:00Z"
  },
  "media": [
    {
      "id": 1001,
      "sessionId": 123,
      "mediaUrl": "https://i.redd.it/image1.jpg",
      "thumbnail": "https://i.redd.it/image1.jpg",
      "caption": null,
      "type": "image",
      "redditPostId": "abc123",
      "redditPostUrl": "https://reddit.com/r/joi/comments/abc123",
      "subreddit": "joi",
      "order": 0
    },
    {
      "id": 1002,
      "sessionId": 123,
      "mediaUrl": "https://i.redd.it/video1.mp4",
      "thumbnail": "https://i.redd.it/video1_thumb.jpg",
      "caption": "Follow my instructions...",
      "type": "video",
      "redditPostId": "def456",
      "redditPostUrl": "https://reddit.com/r/femdom/comments/def456",
      "subreddit": "femdom",
      "order": 1
    }
  ]
}

Notes

  • Only the session owner or users with access to public sessions can retrieve session details
  • Media items are returned in display order (sorted by order field)
  • Captions may be null for Reddit-based sessions (generated on-demand during playback)
  • Imported or manual sessions typically have pre-populated captions

Build docs developers (and LLMs) love