Skip to content

Retry a failed post, or set its thumbnail

Without a body, sends a failed post again. With { thumbnailUrl }, sets or replaces the thumbnail of a post already on the platform. Needs the publish permission.

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

Authorisation

  • apiKeyHTTPrequired

Path parameters

  • idstringrequired

Request bodyJSONoptional

  • thumbnailUrloptionalstring

    A public image URL or r2:// URL

Returns

200

The 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