List media

GET

/public/v1/media

const url = 'https://api.loomta.com/public/v1/media?mediaType=image&source=upload';
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://api.loomta.com/public/v1/media?mediaType=image&source=upload' \
  --header 'Authorization: Bearer <token>'

Authorizations

apiKey

Parameters

Query Parameters

folderId

string

Optional. Filter by folder UUID, or the string null for the root folder. Omit to list all folders.

mediaType

string

Allowed values: image video

Optional. Filter by media type. Omit to include both.

source

string

Allowed values: upload composite generated all

Optional (default upload). composite and generated are internal artifacts (baked-caption images and raw AI-generated images, respectively) — omit this to see only media you uploaded. Pass all to include every source.

Responses

200

The matching media objects.

application/json

object

media

required

Array<object>

A media object in the workspace library.

object

string format: uuid

storageKey

string

publicUrl

string format: uri

previewUrl

string format: uri

mimeType

string

size

integer | null

mediaType

string

Allowed values: image video audio file

originalFileName

string

status

string

Allowed values: PENDING READY

thumbnailMetadata

object | null

finalizedAt

string | null format: date-time

folderId

string | null format: uuid

createdAt

string format: date-time

Example

{
  "media": [
    {
      "mimeType": "image/jpeg",
      "mediaType": "image",
      "status": "PENDING"
    }
  ]
}

401

The API key is missing or invalid.

application/json

object

code

required

A stable, machine-readable error code to branch on.

string

message

required

A human-readable description.

string

details

Optional structured detail (for example Zod validation issues).

Examples

{
  "code": "missing_api_key",
  "message": "A Bearer API key is required."
}

{
  "code": "invalid_api_key",
  "message": "The API key is invalid."
}