Stories, WIP

NOTE

This page is a work in progress. Endpoints below haven't been fully researched.

Create story, WIP

Requires Authorization.

POST /v1/stories

Body:

• mediaId — long integer
• caption — string, optional
• audience — object
  • options — array of strings, e.g. ["EVERYONE"]
  • myType — object, optional
    • ageMin — integer, optional
    • ageMax — integer, optional
    • positions — array of sexual position IDs, optional

Get stories inbox, WIP

Requires Authorization.

Profiles with active stories.

GET /v1/stories/inbox

Query (optional):

• pageNumber — integer, starts at 1, optional
• pageSize — integer, number of posters per page, optional

Response:

• posters — array of objects or null
  • profileId — long integer
  • displayName — string or null
  • mediaHash — string, See Media -> Public CDN files -> Profile Images or null
  • onlineUntil — unix timestamp in milliseconds or null
  • hasUnviewed — boolean
  • isFavorite — boolean
  • rightNow — RightNowStatus or null
  • stories — array of objects or null
    • id — long integer
    • profileId — long integer
    • displayName — string or null
    • mediaHash — string, See Media -> Public CDN files -> Profile Images or null
    • onlineUntil — unix timestamp in milliseconds or null
    • distance — integer, appears to be in meters or null
    • media — StoryMedia or null
    • caption — object or null
      • text — string or null
    • posted — unix timestamp in milliseconds or null
    • expiration — unix timestamp in milliseconds or null
    • viewed — boolean

Errors:

• 404 — Returned with an empty body; appears to mean Stories are not enabled for the account (no stories-v1 assignment).

Get my stories, WIP

Requires Authorization.

GET /v1/stories/mine

Response:

• stories — array of objects or null
  • id — long integer
  • status — string, "PENDING", "ACTIVE", "REJECTED", "EXPIRED" or null
  • media — StoryMedia or null
  • caption — object or null
    • text — string or null
    • textStatus — string, "AWAITING_MODERATION", "MODERATION_APPROVED", "MODERATION_FAILED" or null
    • rejectReasons — array of strings: "BULLYING", "SELF_HARM", "DRUG_PATTERNS", "HATE_SPEECH", "SOL_SEX", "SPAM_DISRUPT", "UNDERAGE" or null
  • posted — unix timestamp in milliseconds or null
  • expiration — unix timestamp in milliseconds or null

Errors:

• 404 — Returned with an empty body; appears to mean Stories are not enabled for the account (no stories-v1 assignment).

Get story, WIP

Requires Authorization.

GET /v1/stories/{storyId}

Delete story, WIP

Requires Authorization.

DELETE /v1/stories/{storyId}

Record story view, WIP

Requires Authorization.

POST /v1/stories/{storyId}/views

Get profile stories, WIP

Requires Authorization.

GET /v1/stories/profiles/{profileId}

StoryMedia

• mediaId — long integer, optional
• thumbnailUrl — string, optional
• fullImageUrl — string, optional
• state — string, "PENDING", "APPROVED", "REJECTED", "DELETED" or null, optional
• reason — string or null, optional
• isRejectAutomated — boolean or null, optional
• shouldBlur — boolean, optional
• isNsfw — boolean, optional