Create Session

curl -X POST "https://app.joip.io/api/sessions" \
  -H "Content-Type: application/json" \
  -H "Cookie: connect.sid=YOUR_SESSION_COOKIE" \
  -d '{
    "title": "My JOI Session",
    "subreddits": "joi,femdom",
    "intervalMin": 5,
    "intervalMax": 15,
    "transition": "fade",
    "captionTheme": "joi",
    "isPublic": false,
    "isFavorite": true
  }'

curl -X POST "https://app.joip.io/api/sessions" \
  -H "Content-Type: application/json" \
  -H "Cookie: connect.sid=YOUR_SESSION_COOKIE" \
  -d '{
    "title": "Custom Captions",
    "subreddits": "gonewild,nsfw",
    "captionTheme": "custom",
    "aiPrompt": "Generate teasing captions with a playful tone",
    "intervalMin": 3,
    "intervalMax": 8
  }'

{
  "id": 456,
  "title": "My JOI Session",
  "userId": "user_abc123",
  "subreddits": ["joi", "femdom"],
  "categoryId": 1,
  "categorySource": "default",
  "intervalMin": 5,
  "intervalMax": 15,
  "transition": "fade",
  "thumbnail": "https://i.redd.it/auto-generated.jpg",
  "aiPrompt": null,
  "captionTheme": "joi",
  "isPublic": false,
  "shareToCommunity": false,
  "isFavorite": true,
  "isManualMode": false,
  "isImported": false,
  "createdAt": "2025-03-02T11:00:00Z",
  "updatedAt": "2025-03-02T11:00:00Z"
}

{
  "message": "Validation error: intervalMax must be greater than or equal to intervalMin"
}

{
  "message": "At least one valid subreddit is required"
}

{
  "error": "Insufficient credits",
  "code": "INSUFFICIENT_CREDITS",
  "required": 1,
  "current": 0,
  "featureKey": "session_create"
}

{
  "error": "This feature is only available for Premium subscribers",
  "code": "PREMIUM_ONLY",
  "featureKey": "session_create"
}

POST

api

sessions

curl -X POST "https://app.joip.io/api/sessions" \
  -H "Content-Type: application/json" \
  -H "Cookie: connect.sid=YOUR_SESSION_COOKIE" \
  -d '{
    "title": "My JOI Session",
    "subreddits": "joi,femdom",
    "intervalMin": 5,
    "intervalMax": 15,
    "transition": "fade",
    "captionTheme": "joi",
    "isPublic": false,
    "isFavorite": true
  }'

curl -X POST "https://app.joip.io/api/sessions" \
  -H "Content-Type: application/json" \
  -H "Cookie: connect.sid=YOUR_SESSION_COOKIE" \
  -d '{
    "title": "Custom Captions",
    "subreddits": "gonewild,nsfw",
    "captionTheme": "custom",
    "aiPrompt": "Generate teasing captions with a playful tone",
    "intervalMin": 3,
    "intervalMax": 8
  }'

{
  "id": 456,
  "title": "My JOI Session",
  "userId": "user_abc123",
  "subreddits": ["joi", "femdom"],
  "categoryId": 1,
  "categorySource": "default",
  "intervalMin": 5,
  "intervalMax": 15,
  "transition": "fade",
  "thumbnail": "https://i.redd.it/auto-generated.jpg",
  "aiPrompt": null,
  "captionTheme": "joi",
  "isPublic": false,
  "shareToCommunity": false,
  "isFavorite": true,
  "isManualMode": false,
  "isImported": false,
  "createdAt": "2025-03-02T11:00:00Z",
  "updatedAt": "2025-03-02T11:00:00Z"
}

{
  "message": "Validation error: intervalMax must be greater than or equal to intervalMin"
}

{
  "message": "At least one valid subreddit is required"
}

{
  "error": "Insufficient credits",
  "code": "INSUFFICIENT_CREDITS",
  "required": 1,
  "current": 0,
  "featureKey": "session_create"
}

{
  "error": "This feature is only available for Premium subscribers",
  "code": "PREMIUM_ONLY",
  "featureKey": "session_create"
}

Authentication

This endpoint requires authentication and credits. Sessions creation requires the session_create feature credit.

Request Body

string

required

Session title (minimum 1 character)

string

required

Comma-separated list of subreddit names (e.g., “joi,femdom,gonewild”)

integer

Category ID to assign to this session

integer

default:3

Minimum slide interval in seconds (1-60)

integer

default:10

Maximum slide interval in seconds (1-60)

string

default:"fade"

Transition effect: “fade”, “slide”, “zoom”, “flip”, or “none”

string

Custom AI prompt for caption generation

string

Caption theme: “joi”, “forced-bi”, “beta”, “cbt”, “cuckold”, or “custom”

string

Custom thumbnail URL. If not provided, auto-generated from subreddits

boolean

default:false

Whether the session is publicly accessible

Whether to share session to the community feed

boolean

default:false

Whether to mark as favorite

boolean

default:false

Whether to disable auto-advance in the player

Response

Returns the created session object with an automatically assigned ID.

integer

Unique session identifier

string

Session title

string

Owner’s user ID

array

Normalized array of subreddit names

integer

Assigned category ID

string

“manual” if explicitly set, “default” if auto-assigned

string

URL to auto-generated or custom thumbnail

timestamp

Session creation timestamp

curl -X POST "https://app.joip.io/api/sessions" \
  -H "Content-Type: application/json" \
  -H "Cookie: connect.sid=YOUR_SESSION_COOKIE" \
  -d '{
    "title": "My JOI Session",
    "subreddits": "joi,femdom",
    "intervalMin": 5,
    "intervalMax": 15,
    "transition": "fade",
    "captionTheme": "joi",
    "isPublic": false,
    "isFavorite": true
  }'

curl -X POST "https://app.joip.io/api/sessions" \
  -H "Content-Type: application/json" \
  -H "Cookie: connect.sid=YOUR_SESSION_COOKIE" \
  -d '{
    "title": "Custom Captions",
    "subreddits": "gonewild,nsfw",
    "captionTheme": "custom",
    "aiPrompt": "Generate teasing captions with a playful tone",
    "intervalMin": 3,
    "intervalMax": 8
  }'

{
  "id": 456,
  "title": "My JOI Session",
  "userId": "user_abc123",
  "subreddits": ["joi", "femdom"],
  "categoryId": 1,
  "categorySource": "default",
  "intervalMin": 5,
  "intervalMax": 15,
  "transition": "fade",
  "thumbnail": "https://i.redd.it/auto-generated.jpg",
  "aiPrompt": null,
  "captionTheme": "joi",
  "isPublic": false,
  "shareToCommunity": false,
  "isFavorite": true,
  "isManualMode": false,
  "isImported": false,
  "createdAt": "2025-03-02T11:00:00Z",
  "updatedAt": "2025-03-02T11:00:00Z"
}

{
  "message": "Validation error: intervalMax must be greater than or equal to intervalMin"
}

{
  "message": "At least one valid subreddit is required"
}

{
  "error": "Insufficient credits",
  "code": "INSUFFICIENT_CREDITS",
  "required": 1,
  "current": 0,
  "featureKey": "session_create"
}

{
  "error": "This feature is only available for Premium subscribers",
  "code": "PREMIUM_ONLY",
  "featureKey": "session_create"
}

Notes

The server automatically pre-populates the session with up to 25 media items in the background
Subreddits are normalized (lowercased, r/ prefix removed)
If categoryId is not provided, the session is assigned to the “Uncategorized” category
Credits are deducted after successful creation
Activity is tracked for analytics

Overview

Sessions

Media

AI Services

Community

Credits

Babecock

Reddit Integration

Authentication

Request Body

Response

Notes

​Authentication

​Request Body

​Response

​Notes

Authentication

Request Body

Response

Notes