Update a post
curl --request PATCH \
--url http://localhost:4000/api/v1/posts/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('http://localhost:4000/api/v1/posts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "http://localhost:4000/api/v1/posts/{id}"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"data": {
"id": "post_123",
"content": "Hello from Postova",
"publishingMode": "SCHEDULE",
"status": "PENDING",
"scheduledAt": "2023-11-07T05:31:56Z",
"timezone": "<string>",
"profileId": "profile_123",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"media": [
{
"id": "media_123",
"url": "<string>",
"type": "image",
"mimeType": "image/jpeg",
"size": 123,
"thumbnailUrl": "<string>",
"altText": "<string>",
"order": 123,
"postId": "post_123",
"createdAt": "2023-11-07T05:31:56Z"
}
],
"targets": [
{
"id": "target_123",
"postId": "post_123",
"socialAccountId": "account_123",
"content": "Hello from Postova",
"settings": {},
"socialAccount": {
"id": "<string>",
"provider": "<string>",
"accountName": "<string>",
"accountType": "<string>"
}
}
],
"publications": [
{
"id": "publication_123",
"postId": "post_123",
"provider": "linkedin",
"socialAccountId": "account_123",
"accountId": "urn:li:person:abc123",
"status": "success",
"providerPostId": "activity_123",
"errorMessage": "Provider rejected the media.",
"scheduledFor": "2023-11-07T05:31:56Z",
"postedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"socialAccount": {
"id": "<string>",
"provider": "<string>",
"accountName": "<string>",
"accountType": "<string>"
}
}
]
},
"meta": {
"rateLimit": {
"limit": 60,
"remaining": 59,
"resetAt": "2026-06-14T12:01:00.000Z"
}
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request data",
"details": null
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request data",
"details": null
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request data",
"details": null
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request data",
"details": null
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request data",
"details": null
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request data",
"details": null
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request data",
"details": null
}
}Posts
Update a post
Updates a draft, scheduled, or pending post and requeues publishing jobs when publishing details change.
PATCH
http://localhost:4000
/
api
/
v1
/
posts
/
{id}
Update a post
curl --request PATCH \
--url http://localhost:4000/api/v1/posts/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('http://localhost:4000/api/v1/posts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "http://localhost:4000/api/v1/posts/{id}"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"data": {
"id": "post_123",
"content": "Hello from Postova",
"publishingMode": "SCHEDULE",
"status": "PENDING",
"scheduledAt": "2023-11-07T05:31:56Z",
"timezone": "<string>",
"profileId": "profile_123",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"media": [
{
"id": "media_123",
"url": "<string>",
"type": "image",
"mimeType": "image/jpeg",
"size": 123,
"thumbnailUrl": "<string>",
"altText": "<string>",
"order": 123,
"postId": "post_123",
"createdAt": "2023-11-07T05:31:56Z"
}
],
"targets": [
{
"id": "target_123",
"postId": "post_123",
"socialAccountId": "account_123",
"content": "Hello from Postova",
"settings": {},
"socialAccount": {
"id": "<string>",
"provider": "<string>",
"accountName": "<string>",
"accountType": "<string>"
}
}
],
"publications": [
{
"id": "publication_123",
"postId": "post_123",
"provider": "linkedin",
"socialAccountId": "account_123",
"accountId": "urn:li:person:abc123",
"status": "success",
"providerPostId": "activity_123",
"errorMessage": "Provider rejected the media.",
"scheduledFor": "2023-11-07T05:31:56Z",
"postedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"socialAccount": {
"id": "<string>",
"provider": "<string>",
"accountName": "<string>",
"accountType": "<string>"
}
}
]
},
"meta": {
"rateLimit": {
"limit": 60,
"remaining": 59,
"resetAt": "2026-06-14T12:01:00.000Z"
}
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request data",
"details": null
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request data",
"details": null
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request data",
"details": null
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request data",
"details": null
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request data",
"details": null
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request data",
"details": null
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request data",
"details": null
}
}Authorizations
Use your Postova API key as a bearer token.
Path Parameters
Example:
"post_123"
Body
application/json
Update a draft, scheduled, or pending post.
Maximum string length:
10000Required string length:
1 - 100Minimum string length:
1Maximum array length:
10Show child attributes
Show child attributes
Required array length:
1 - 25 elementsShow child attributes
Show child attributes
Maximum array length:
30Required string length:
1 - 100Show child attributes
Show child attributes
Available options:
PENDING, PROCESSING, PUBLISHED, PARTIAL_FAILED, FAILED, CANCELLED Last modified on June 20, 2026