Skip to main content
PATCH

Authentication

This endpoint requires authentication. Users can only update sessions they own.

Path Parameters

integer
required
The unique session ID to update

Request Body

All fields are optional. Only provided fields will be updated.
string
Session title (minimum 1 character)
string
Comma-separated list of subreddit names. Note: Cannot be modified for imported sessions
integer | null
Category ID to assign. Pass null to reset to default category
integer
Minimum slide interval in seconds (1-60)
integer
Maximum slide interval in seconds (1-60)
string
Transition effect: “fade”, “slide”, “zoom”, “flip”, or “none”
string
Custom AI prompt. Note: Cannot be modified for imported sessions
string
Caption theme: “joi”, “forced-bi”, “beta”, “cbt”, “cuckold”, or “custom”. Note: Cannot be modified for imported sessions
string
Custom thumbnail URL. Pass empty string to auto-generate from subreddits
boolean
Public accessibility flag
boolean
Whether to share to community feed. Enabling creates a persistent snapshot
boolean
Favorite status
boolean
Whether to disable auto-advance in player

Response

Returns the updated session object.
integer
Session identifier
string
Updated session title
array
Updated subreddit list
integer
Updated category ID
timestamp
Timestamp of this update

Notes

  • For imported sessions, the following fields cannot be modified:
    • subreddits
    • captionTheme
    • aiPrompt
  • If an empty thumbnail string is provided and subreddits exist, a new thumbnail is auto-generated
  • Enabling shareToCommunity creates a persistent community snapshot with media copied to durable storage
  • Disabling shareToCommunity removes the community snapshot
  • Activity is tracked for analytics with the updated caption theme (if changed)