Posts
Update a post
PATCH
apiKeyheader
AuthorizationBearer <token>An API key from the web app, under Developers. It starts with rz_live_.
id*stringapplication/json- body
text?stringLength
length <= 5000mediaIds?array<string>status?stringValue in
"draft""scheduled"scheduledAt?|nullfields?targets?array<>The targets as they should be. Pending ones not listed are dropped and new ones added; live ones stay and change only with applyToPublished.
Items
1 <= itemsapplyToPublished?booleanAlso edit targets already live, where the network allows it. Each one's result is in edits.
Default
falseOK
application/json- response
id*stringprofileId*stringstatus*stringpartially_published: some targets went out and others failed; each target has its own status.
Value in
"draft""scheduled""published""partially_published""failed"text*stringmedia*array<>targets*array<>scheduledAt*|nullpublishedAt*|nullcreatedBy*|createdAt*stringFormat
date-timeupdatedAt*stringFormat
date-timefields*metrics*|nulldeletedAt*|Deleted posts are kept: restore them within 30 days.
edits*array<>When the text, media or targets change: one per target whose version differs from the one it had.
curl -X PATCH 'https://api.rizamo.com/v1/posts/string' \ -H 'Content-Type: application/json' \ -d '{}'Example Response200
{ "id": "string", "profileId": "string", "status": "draft", "text": "string", "media": [ { "id": "string", "type": "image", "url": "string", "alt": "string" } ], "targets": [ { "accountId": "string", "network": "instagram", "format": "feed", "text": "string", "media": [ { "id": "string", "type": "image", "url": "string", "alt": "string" } ], "options": { "instagram": { "shareToFeed": true, "coverUrl": "http://example.com", "collaborators": [ "string" ], "locationId": "string" }, "facebook": { "link": "http://example.com" }, "tiktok": { "disableComments": true, "disableDuet": true, "disableStitch": true, "isBrandedContent": true, "isYourBrand": true, "isAiGenerated": true }, "linkedin": { "documentTitle": "string" }, "youtube": { "title": "string", "privacy": "public", "madeForKids": true, "tags": [ "string" ] }, "pinterest": { "boardId": "string", "title": "string", "link": "http://example.com" } }, "firstComment": "string", "status": "pending", "url": "string", "error": "string", "removal": "removed" } ], "scheduledAt": "2019-08-24T14:15:22Z", "publishedAt": "2019-08-24T14:15:22Z", "createdBy": { "type": "agent", "agent": "claude", "name": "string" }, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "fields": { "property1": "string", "property2": "string" }, "metrics": { "impressions": -9007199254740991, "reach": -9007199254740991, "engagements": -9007199254740991, "likes": -9007199254740991, "comments": -9007199254740991, "shares": -9007199254740991, "saves": -9007199254740991, "clicks": -9007199254740991 }, "deletedAt": "2019-08-24T14:15:22Z", "edits": [ { "accountId": "string", "format": "feed", "result": "applied" } ]}