List Sessions

Retrieve all sessions for the authenticated user

GET /api/sessions

cURL

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

200 - Success

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

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

200 - Success

[
  {
    "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"
  }
]