Edit Post

curl -X PATCH "https://api.infinipost.co/v1/posts/post_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Updated caption! #trending",
    "scheduledTime": "2024-04-22T15:00",
    "timezone": "America/New_York",
    "soundId": "snd_xyz789"
  }'

const response = await fetch('https://api.infinipost.co/v1/posts/post_abc123', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    caption: 'Updated caption! #trending',
    scheduledTime: '2024-04-22T15:00',
    timezone: 'America/New_York',
    soundId: 'snd_xyz789'
  })
});

const data = await response.json();

{
  "postId": "post_abc123",
  "accountId": "acc_1a2b3c4d5e",
  "platform": "tiktok",
  "contentType": "video",
  "contentUrl": "https://storage.googleapis.com/...",
  "thumbnailUrl": "https://storage.googleapis.com/.../thumb.jpg",
  "caption": "Updated caption! #trending",
  "soundId": "snd_xyz789",
  "timezone": "America/New_York",
  "scheduledTime": "2024-04-22T19:00:00Z",
  "status": "generated",
  "createdAt": "2024-04-21T20:15:00Z"
}

PATCH

posts

{postId}

curl -X PATCH "https://api.infinipost.co/v1/posts/post_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Updated caption! #trending",
    "scheduledTime": "2024-04-22T15:00",
    "timezone": "America/New_York",
    "soundId": "snd_xyz789"
  }'

const response = await fetch('https://api.infinipost.co/v1/posts/post_abc123', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    caption: 'Updated caption! #trending',
    scheduledTime: '2024-04-22T15:00',
    timezone: 'America/New_York',
    soundId: 'snd_xyz789'
  })
});

const data = await response.json();

{
  "postId": "post_abc123",
  "accountId": "acc_1a2b3c4d5e",
  "platform": "tiktok",
  "contentType": "video",
  "contentUrl": "https://storage.googleapis.com/...",
  "thumbnailUrl": "https://storage.googleapis.com/.../thumb.jpg",
  "caption": "Updated caption! #trending",
  "soundId": "snd_xyz789",
  "timezone": "America/New_York",
  "scheduledTime": "2024-04-22T19:00:00Z",
  "status": "generated",
  "createdAt": "2024-04-21T20:15:00Z"
}

Only posts with a status of generated or pending_render can be edited. Attempting to edit a post that has already been posted or failed will return an error.

Path Parameters

string

required

The unique post identifier.

Request Body

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

string

Updated caption for the post.

string

Updated local time to post, in YYYY-MM-DDTHH:MM format (e.g. "2024-04-22T14:00"). Interpreted in the timezone specified by the timezone parameter.

string

IANA timezone for interpreting scheduledTime. Required if scheduledTime is provided. Supported values:

Value	Label
`America/New_York`	Eastern (ET)
`America/Chicago`	Central (CT)
`America/Denver`	Mountain (MT)
`America/Los_Angeles`	Pacific (PT)
`America/Anchorage`	Alaska (AKT)
`Pacific/Honolulu`	Hawaii (HST)
`Europe/London`	London (GMT)
`Europe/Paris`	Paris (CET)
`Asia/Tokyo`	Tokyo (JST)
`Asia/Singapore`	Singapore (SGT)
`Australia/Sydney`	Sydney (AEDT)

string

Updated content type: video or slides. Must be provided alongside contentUrl if changing content.

string | array

Updated content URL. When contentType is video, provide a single URL string. When contentType is slides, provide an array of image URL strings.

string

Sound ID to attach to the post. If omitted the post will have no TikTok sound attached. Only applicable for TikTok posts.

Response

string

Unique identifier for the post.

string

The account this post is scheduled for.

string

Platform: tiktok or instagram.

string

video or slides.

string | array

The content to be posted. When contentType is video, this is a single URL string. When contentType is slides, this is an array of image URL strings.

string

URL of the video thumbnail. null for slideshow posts or if not yet generated.

string

Post caption.

string

ID of the sound attached to this post. null if no sound.

string

IANA timezone the scheduledTime was submitted in.

string

UTC ISO 8601 timestamp of when the post is scheduled to go live.

string

Current status: generated or pending_render.

string

ISO 8601 timestamp of when the post was created.

curl -X PATCH "https://api.infinipost.co/v1/posts/post_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Updated caption! #trending",
    "scheduledTime": "2024-04-22T15:00",
    "timezone": "America/New_York",
    "soundId": "snd_xyz789"
  }'

const response = await fetch('https://api.infinipost.co/v1/posts/post_abc123', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    caption: 'Updated caption! #trending',
    scheduledTime: '2024-04-22T15:00',
    timezone: 'America/New_York',
    soundId: 'snd_xyz789'
  })
});

const data = await response.json();

{
  "postId": "post_abc123",
  "accountId": "acc_1a2b3c4d5e",
  "platform": "tiktok",
  "contentType": "video",
  "contentUrl": "https://storage.googleapis.com/...",
  "thumbnailUrl": "https://storage.googleapis.com/.../thumb.jpg",
  "caption": "Updated caption! #trending",
  "soundId": "snd_xyz789",
  "timezone": "America/New_York",
  "scheduledTime": "2024-04-22T19:00:00Z",
  "status": "generated",
  "createdAt": "2024-04-21T20:15:00Z"
}

Error Responses

Unauthorized

{
  "error": {
    "code": "unauthenticated",
    "message": "Invalid or missing API key"
  }
}

Post Not Found

{
  "error": {
    "code": "not_found",
    "message": "Post post_abc123 not found"
  }
}

Post Already Posted

{
  "error": {
    "code": "cannot_edit",
    "message": "Only posts with status 'generated' or 'pending_render' can be edited"
  }
}

Server Error

{
  "error": {
    "code": "internal",
    "message": "An unexpected error occurred"
  }
}

Phones

Accounts

Warmup

Posts

Media

Engagement

Partners

Path Parameters

Request Body

Response

Error Responses

​Path Parameters

​Request Body

​Response

​Error Responses

Path Parameters

Request Body

Response

Error Responses