Images with their size and where they are used

Scope templates.read

Returns

1 fields of the 200 answer

dataarray of objectsrequired

12 fields

idstringrequired

namestringrequired

formatenumrequired

jpegpng

widthPxintegerrequired

heightPxintegerrequired

hasAlphabooleanrequired

colourProfilestringrequired

sizeBytesintegerrequired

urlsobjectrequired

2 fields

masterstringrequired

thumbstringrequired

createdAtdate-timerequired

storedBytesintegerrequired

usagesarray of objectsrequired

4 fields

templateIdstringrequired

templateNamestringrequired

versioninteger or nullrequired

archivedbooleanrequired

Responses

200Success

401Authentication required or API key invalid

403Permission or scope missing, organisation suspended

429Rate limited for this API key and class; wait Retry-After seconds

otherError (RFC 9457 problem details)

Request

curl https://api.postbuddy.nl/v1/media/images \
  -H "Authorization: Bearer $POSTBUDDY_API_KEY"

import { PostBuddyClient } from '@postbuddy/sdk';

const client = new PostBuddyClient({ apiKey: process.env.POSTBUDDY_API_KEY! });

const result = await client.media.images();

import os
from postbuddy import Client

client = Client(os.environ["POSTBUDDY_API_KEY"])

result = client.media.images()

Response

{
  "data": [
    {
      "id": "obj_01J9Y2K8QF4T6W8Z0B2D4F6H8K",
      "name": "Welcome card",
      "format": "jpeg",
      "widthPx": 1,
      "heightPx": 1,
      "hasAlpha": false,
      "colourProfile": "Example",
      "sizeBytes": 1,
      "urls": {
        "master": "https://example.com/r/Fq3ZtR8w",
        "thumb": "https://example.com/r/Fq3ZtR8w"
      },
      "createdAt": "2026-10-16T09:14:02.000Z",
      "storedBytes": 1,
      "usages": [
        {
          "templateId": "tpl_01J9Y2K8QF4T6W8Z0B2D4F6H8K",
          "templateName": "Example",
          "version": 1,
          "archived": false
        }
      ]
    }
  ]
}