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

Before registering the video upload, the publisher GETs pinterest.coverImageUrl. The response must:

​
Why

Pinterest fetches the cover image on its end during pin creation. If the URL is unreachable, returns 4xx/5xx, or serves something that isn’t an image, POST /v5/pins fails with a generic upstream error. Catching it locally points at the URL specifically.

​
Failure response

{
  "error": {
    "code": "preflight_failed",
    "rule": "pinterest.cover_image_url.reachable",
    "platform": "pinterest",
    "message": "URL returned 404: https://cdn.example.com/cover.jpg",
    "remediation": "Pinterest must be able to fetch the cover image URL; verify it is public and returns 2xx."
  }
}

​
Remediation

  • Verify the URL is publicly reachable from outside your network (no auth, no IP allowlist).
  • Don’t use Google Drive share links, Dropbox preview URLs, or signed S3 URLs that have expired — same general failure mode as instagram.media.reachable (OAuthException 2207052).
  • When in doubt, upload the cover via POST /v1/media and use the returned public URL.