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

[
  {
    "id": 123,
    "title": "My First Session",
    "userId": "user_abc123",
    "subreddits": ["joi", "femdom"],
    "categoryId": 1,
    "intervalMin": 3,
    "intervalMax": 10,
    "transition": "fade",
    "thumbnail": "https://i.redd.it/example.jpg",
    "aiPrompt": null,
    "captionTheme": "joi",
    "isPublic": false,
    "isFavorite": true,
    "isManualMode": false,
    "isImported": false,
    "importSource": null,
    "createdAt": "2025-03-02T10:30:00Z",
    "updatedAt": "2025-03-02T10:30:00Z"
  }
]

​
Authentication

This endpoint requires authentication. Include session credentials in your request.

​
Query Parameters

​
categoryId
integer
Filter sessions by category ID
​
categorySlug
string
Filter sessions by category slug (max 120 characters)
​
tags
string
Comma-separated list of tag slugs to filter by (e.g., “joi,femdom”)
​
tagMode
string
Tag matching mode: “and” or “or” (default: “or”)
​
sort
string
Sort order: “recent” or “relevance” (when using tag filtering)

​
Response

Returns an array of session objects owned by the authenticated user.
​
id
integer
Unique session identifier
​
title
string
Session title
​
userId
string
Owner’s user ID
​
subreddits
array
Array of subreddit names associated with this session
​
categoryId
integer
Category ID for this session
​
intervalMin
integer
Minimum slide interval in seconds (1-60)
​
intervalMax
integer
Maximum slide interval in seconds (1-60)
​
transition
string
Transition effect: “fade”, “slide”, “zoom”, “flip”, or “none”
​
thumbnail
string
URL to session thumbnail image
​
aiPrompt
string
Custom AI prompt for caption generation
​
captionTheme
string
Caption theme: “joi”, “forced-bi”, “beta”, “cbt”, “cuckold”, or “custom”
​
isPublic
boolean
Whether the session is publicly accessible
​
isFavorite
boolean
Whether the session is marked as favorite
​
isManualMode
boolean
Whether auto-advance is disabled in the player
​
isImported
boolean
Whether the session was imported from an external source
​
importSource
string
Source of import (e.g., “imgchest”)
​
createdAt
timestamp
Session creation timestamp
​
updatedAt
timestamp
Last update timestamp
curl -X GET "https://app.joip.io/api/sessions" \
  -H "Cookie: connect.sid=YOUR_SESSION_COOKIE"

[
  {
    "id": 123,
    "title": "My First Session",
    "userId": "user_abc123",
    "subreddits": ["joi", "femdom"],
    "categoryId": 1,
    "intervalMin": 3,
    "intervalMax": 10,
    "transition": "fade",
    "thumbnail": "https://i.redd.it/example.jpg",
    "aiPrompt": null,
    "captionTheme": "joi",
    "isPublic": false,
    "isFavorite": true,
    "isManualMode": false,
    "isImported": false,
    "importSource": null,
    "createdAt": "2025-03-02T10:30:00Z",
    "updatedAt": "2025-03-02T10:30:00Z"
  }
]

Build docs developers (and LLMs) love

Get started for freeTalk to us