Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.letmepost.dev/llms.txt

Use this file to discover all available pages before exploring further.

What it checks

After uploading bytes, the publisher polls GET /v5/media/{id} every 2 s for up to 5 minutes. If the status is still processing (or registered) at the deadline, this rule fires.

Why

Pinterest’s video transcode is usually fast (under a minute for short clips), but the upstream queue depth varies. Holding a synchronous publish open longer than 5 minutes is worse UX than failing fast — Pinterest keeps the registered media id around, so a follow-up retry can short-circuit.

Failure response

{
  "error": {
    "code": "platform_unavailable",
    "rule": "pinterest.video.transcode_timeout",
    "platform": "pinterest",
    "message": "Pinterest media vid-… did not finish transcoding within 300000ms.",
    "remediation": "Pinterest is still processing the video; retry the publish in a minute or two."
  }
}

Remediation

  • Retry the publish in a few minutes.
  • For consistent timeouts, shorten the clip or drop the bitrate.