Skip to main content
PUT
Edit post

Authorizations

Authorization
string
header
required

Link access token for one Sandbox, Test, or Live authorization.

x-linked-account-id
string
header
required

Selects one of the authorization's linked accounts via the x-linked-account-id header.

Headers

x-linked-account-id
string
required

The linked account to use. The user must have shared it with your app. A missing account returns linked_account_required; an account outside your access returns linked_account_not_granted.

Example:

"conn_example123"

Path Parameters

postId
string | null

OnlyFans post ID

Minimum string length: 1

Body

application/json
text
string
default:""

Plain text with optional formatting marks. HTML is displayed as text. See Text formatting.

Maximum string length: 10000
replyToMessageId
string | null

Reply to an existing chat message

Minimum string length: 1
mediaItems
(integer | string)[]

Media references to attach. Accepts vault media IDs, upload references (mediaUploadId), or http(s) URLs. See mediaItems reference.

OnlyFans media ID

Required range: x > 0
isLockedText
boolean
default:false

Whether users must pay to read the text (default: false).

price
number | null
default:0

Price to unlock message content (0 for free)

Required range: 0 <= x <= 200
previewMediaCount
integer | null
default:0

Number of mediaItems to show as free previews, starting with the first item.

Required range: x >= 0
releaseForms
object

Release form participants

userTags
integer[]

Users to tag

OnlyFans user ID

Required range: x > 0
isMarkdown
boolean
default:true

Apply formatting marks (default: true). Set false to keep marks as literal text. HTML is displayed as text in both modes. See Text formatting.

scheduledDate

When to publish the post (omit for immediate). Use ISO 8601 with timezone, e.g. 2026-05-25T12:00:00.000Z, or epoch milliseconds.

fundRaisingTargetAmount
number

Target amount for fund raising post

Required range: x >= 10
fundRaisingTipsPresets
number[]

Preset tip amounts for fund raising

Maximum array length: 4
expireAfter
number

Days until post expires (1-30)

Required range: 1 <= x <= 30
poll
object

Poll attached to the post

Response

Successful response

id
number
required
canDelete
boolean
required
canEdit
boolean
required
canViewMedia
boolean
required
media
object[]
required
author
object
postedAt
string
postedAtPrecise
string
text
string
tipsAmount
string
canComment
boolean
favoritesCount
number
isFavorite
boolean
mediaTotal
number
mediaReady
boolean
price
number
releaseForms
object[]
canEditText
boolean
canEditMedia
boolean
canEditSchedule
boolean
canEditVote
boolean
previewIds
null[]