Skip to content

Change a scheduled post

Change a post that is still 'scheduled' (waiting in mixetape): its time, lead, media, caption or metadata (merged; null clears a field). Once it is on the platform, use edit_published_post. Needs the publish permission.

PATCH
https://mixetape.com/api/v1/posts/{id}

Authorisation

  • apiKeyHTTPrequired

Path parameters

  • idstringrequired

Request bodyJSONrequired

  • mediaUrloptionalstring
  • captionoptionalstring
  • scheduledAtoptionalstring

    ISO 8601 with timezone offset

  • leadMinutesoptionalnumber
  • metadataoptionalYouTubeorFacebookorInstagramorThreadsorTikTokorPinterest
    6 variants

    One of the following:

    • YouTube
    • Facebook
    • Instagram
    • Threads
    • TikTok
    • Pinterest

Returns

200

The changed post.

JSON
  • postobjectrequired
    16 properties
    • idstringrequired
    • accountIdstringrequired
    • providerstringrequired
    • mediaUrlstringrequired
    • scheduledAtstringrequired

      When it goes live

      format: date-time
    • statusscheduledorpublishingoruploadedorpublishedorfailedorcancelledrequired
    • captionoptionalstring | null
    • metadataoptionalobject | null

      The platform's own fields

    • leadMinutesoptionalinteger | null

      Uploaded or prepared this long before scheduledAt

    • platformPostIdoptionalstring | null
    • platformUrloptionalstring | null
    • erroroptionalstring | null

      Why it failed, when it did

    • attemptsoptionalinteger
    • publishedAtoptionalstring | null
      format: date-time
    • createdAtoptionalstring
      format: date-time
    • updatedAtoptionalstring
      format: date-time

400

The request is invalid; error says why.

JSON
  • errorstringrequired

    What went wrong, in plain words

401

No valid API key.

JSON
  • errorstringrequired

    What went wrong, in plain words

403

The key lacks the permission this needs.

JSON
  • errorstringrequired

    What went wrong, in plain words

404

Not found, or not yours.

JSON
  • errorstringrequired

    What went wrong, in plain words

Navigation

Type to search…

↑↓ navigate↵ selectEsc close