Media

List media

Returns media you can attach to posts. To list a workspace's media library (the files uploaded from the PostPlanify dashboard, which is usually what "my media" means), you must pass workspaceId. Without it, only files uploaded through the API are returned (usually a small or empty subset). Each item has a source of "upload" or "library"; both can be used as mediaIds in POST /posts.

get/media

Request

Base URL: https://api.postplanify.com/api/v1
URL: https://api.postplanify.com/api/v1/media
Auth: HTTP bearer

Query parameters

workspaceIdstring uuid

Include this workspace's media library. Omit to return only your API uploads.

type'image' | 'video'

Filter library media by type.

pageinteger

Library page number (default 1).

pageSizeinteger

Library items per page (default 50, max 100).

Response

List of media

okboolean

Example response

{
  "ok": true,
  "data": [
    {
      "id": "e1a2b3c4-d5e6-f7a8-b9c0-d1e2f3a4b5c6",
      "name": "banner.png",
      "url": "https://cdn.postplanify.com/api-uploads/banner.png",
      "type": "image/png",
      "size": 542000,
      "createdAt": "2026-02-19T10:00:00.000Z",
      "source": "library"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.