API Reference / Media

List images

PostPiper API: list your latest ready image assets, newest first. Each result includes mime type, size bytes, and a signed preview URL.

GEThttps://api.postpiper.ai/v1/media

Only ready images owned by the API key's user are returned, newest first. Each result has a fresh preview URL.

Path and query parameters

Name	Type	Description
limit	integer, optional	Number of images from 1 to 50; defaults to 20.

Example request

Terminal

curl -H "Authorization: Bearer $POSTPIPER_API_KEY" "https://api.postpiper.ai/v1/media?limit=20"

Response

200 OK. Returns an assets array.

JSON

{
  "assets": [
    {
      "id": "<asset-uuid>",
      "post_id": null,
      "mime_type": "image/png",
      "size_bytes": 1234,
      "created_at": "2030-10-12T01:00:00.000Z",
      "preview_url": "https://<signed-preview-url>"
    }
  ]
}

Errors

401Missing or invalid API key.
403API key lacks the required scope.
503MEDIA_UNAVAILABLE.