Get Session

Retrieve a single session with its media items

GET /api/sessions/:id

cURL

curl -X GET "https://app.joip.io/api/sessions/123" \
  -H "Cookie: connect.sid=YOUR_SESSION_COOKIE"

200 - Success

{
  "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

curl -X GET "https://app.joip.io/api/sessions/123" \
  -H "Cookie: connect.sid=YOUR_SESSION_COOKIE"

200 - Success

{
  "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