Skip to main content
PATCH
/
posts
/
{id}
Update post
curl --request PATCH \
  --url https://app.tryordinal.com/api/v1/posts/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "title": "Updated: Q4 Product Launch Announcement",
  "publishAt": "2026-01-16T15:00:00.000Z",
  "status": "Finalized",
  "linkedIn": {
    "copy": "Updated content for our product launch! šŸš€\n\nShoutout to @[Jane Smith](urn:li:person:XYZ789abc) for leading this effort.\n\nWe've added even more features:\nā€¢ Feature D\nā€¢ Feature E\n\n#ProductLaunch #Innovation"
  },
  "x": {
    "tweets": [
      {
        "copy": "Updated content for our product launch! šŸš€\n\nWe've added even more features šŸ§µ"
      },
      {
        "copy": "ā€¢ Feature D\nā€¢ Feature E\n\n#ProductLaunch #Innovation"
      }
    ]
  }
}
EOF
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "url": "https://app.tryordinal.com/acme/posts/550e8400-e29b-41d4-a716-446655440000",
  "title": "Updated: Q4 Product Launch Announcement",
  "channels": [
    "LinkedIn",
    "Twitter"
  ],
  "status": "Finalized",
  "publishDate": "2026-01-16",
  "publishAt": "2026-01-16T15:00:00.000Z",
  "updatedAt": "2026-01-13T09:15:00.000Z",
  "linkedIn": {
    "copy": "Updated content for our product launch! šŸš€\n\nShoutout to @[Jane Smith](urn:li:person:XYZ789abc) for leading this effort.\n\nWe've added even more features:\nā€¢ Feature D\nā€¢ Feature E\n\n#ProductLaunch #Innovation"
  },
  "x": {
    "tweets": [
      {
        "copy": "Updated content for our product launch! šŸš€\n\nWe've added even more features šŸ§µ"
      },
      {
        "copy": "ā€¢ Feature D\nā€¢ Feature E\n\n#ProductLaunch #Innovation"
      }
    ]
  }
}

Authorizations

ā€‹
Authorization
string
header
required

API key authentication. Generate an API key from your workspace settings.

Path Parameters

ā€‹
id
string<uuid>
required

Post ID (UUID)

Body

application/json

All fields are optional. Only include the fields you want to update.

ā€‹
title
string
ā€‹
publishAt
string<date-time>
ā€‹
status
enum<string>
Available options:
Tentative,
ToDo,
InProgress,
ForReview,
Blocked,
Finalized,
Scheduled,
Posted
ā€‹
labelIds
string<uuid>[]
ā€‹
campaignId
string<uuid> | null
ā€‹
notes
string | null
ā€‹
linkedIn
object
ā€‹
x
object

X (Twitter) channel configuration for creating or updating posts

ā€‹
instagram
object

Instagram channel configuration for creating or updating posts. The shape of the object depends on the type field.

ā€‹
tikTok
object

TikTok channel configuration for creating or updating posts. TikTok posts require exactly one video asset.

ā€‹
youTubeShorts
object

YouTube Shorts channel configuration for creating or updating posts. YouTube Shorts posts require exactly one video asset (1sā€“3min).

Response

Post updated successfully

ā€‹
id
string<uuid>
ā€‹
url
string<uri>
ā€‹
title
string
ā€‹
channels
string[]
ā€‹
status
enum<string>
Available options:
Tentative,
ToDo,
InProgress,
ForReview,
Blocked,
Finalized,
Scheduled,
Posted
ā€‹
publishDate
string

Scheduled publish date (YYYY-MM-DD) in workspace timezone

ā€‹
publishAt
string<date-time> | null

Scheduled publish datetime UTC. Only set when a specific time is specified.

ā€‹
createdAt
string<date-time>
ā€‹
updatedAt
string<date-time>
ā€‹
archivedAt
string<date-time> | null

When the post was archived. Null if the post is not archived.

ā€‹
labels
object[]

Labels assigned to this post

ā€‹
linkedIn
object
ā€‹
x
object

X (Twitter) content. Present when the post targets the Twitter channel.

ā€‹
instagram
object

Instagram content. Present when the post targets the Instagram channel. The shape depends on the type field.

ā€‹
tikTok
object

TikTok content. Present when the post targets the TikTok channel.

ā€‹
youTubeShorts
object

YouTube Shorts content. Present when the post targets the YouTube Shorts channel.