List media

GET

/media

const url = 'https://postflow.biz.id/api/v1/media?kind=image';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://postflow.biz.id/api/v1/media?kind=image' \
  --header 'Authorization: Bearer <token>'

Newest first, 60 per page. For the next page, send the last item’s createdAt as before.

MCP tool: list_media.

Authorizations

apiKey
oauth

Parameters

Query Parameters

kind

string

Allowed values: image video

string

Part of the file name.

before

string format: date-time

Responses

200

application/json

Array

object

required

Use in mediaIds.

string

kind

required

string

Allowed values: image video

mime

required

string

Allowed values: image/jpeg image/png image/webp image/gif video/mp4 video/quicktime video/webm

sizeBytes

required

integer

width

required

Any of:

integer
null

integer

height

required

Any of:

integer
null

integer

durationMs

required

Any of:

integer
null

integer

originalName

required

string

parentId

required

Any of:

string
null

Set on edited copies (e.g. a crop) of another file.

string

url

required

App path of the file. With the API, download it from /media/{id}/file.

string

thumbUrl

required

Any of:

string
null

string

createdAt

required

string format: date-time

usedIn

required

Posts using the file.

integer

Example

[
  {
    "kind": "image",
    "mime": "image/jpeg"
  }
]

401

Missing, invalid, expired or deleted key or token.

application/json

object

error

required

object

code

required

string

Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL

message

required

A sentence you can show to a person.

string

details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

429

More than 120 requests in a minute with this key.

application/json

object

error

required

object

code

required

string

Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL

message

required

A sentence you can show to a person.

string

details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}