Stories
Add to Story
Post a new media or vault file to your story.
post/api/{account}/stories
Request body
Example request
{
"mediaFiles": [
"ofapi_media_abc123",
1234567890
]
}Response
Success
Example response
{
"data": {
"id": 123,
"userId": 123,
"isReady": false,
"hasPost": false,
"isWatched": false,
"media": [
{
"id": 123,
"type": "photo",
"convertedToVideo": false,
"canView": true,
"hasError": false,
"createdAt": "2025-01-01T01:01:01+00:00",
"isReady": false,
"files": {
"full": {
"url": null,
"width": 0,
"height": 0,
"size": 0,
"sources": []
},
"thumb": null,
"preview": null,
"squarePreview": null
},
"duration": 0,
"hasCustomPreview": false
}
],
"createdAt": "2025-01-01T01:01:01+00:00",
"question": null,
"viewersCount": 0,
"viewers": [],
"commentsCount": 0,
"canDelete": true,
"isHighlightCover": false,
"isLastInHighlight": false,
"tipsAmount": "$0",
"tipsAmountRaw": 0,
"tipsCount": 0,
"likesCount": 0,
"releaseForms": []
},
"_meta": {
"_credits": {
"used": 1,
"balance": 1000999771,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 5000,
"limit_day": null,
"remaining_minute": 4995,
"remaining_day": null,
"notice": "We have decided to remove our daily rate limits. Please remove any references to these in your integrations."
}
}
}