List media files

Get a paginated list of all active (confirmed) media files for your organization. Only non-expired files are returned. Use limit and offset query parameters for pagination. Each file includes its public URL, content type, size, and expiration date. Files expire 60 days after upload. Use the returned media IDs when creating posts to attach media content.

GET/v1/media

Query Parameters

limit?string

Number of media files per page (1-100)

Default"50"
offset?string

Pagination offset

Default"0"

Response Body

fetch("https://api.outstand.so/v1/media?limit=50&offset=0", {  method: "GET"})
{
  "success": true,
  "data": [
    {
      "id": "9dyJS",
      "filename": "product-image.jpg",
      "url": "https://media.outstand.so/org_abc123/550e8400-e29b-41d4-a716-446655440000/product-image.jpg",
      "content_type": "image/jpeg",
      "size": 1024000,
      "status": "active",
      "created_at": "2025-01-15T10:30:00Z",
      "expires_at": "2025-03-16T10:30:00Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "count": 10
  }
}
{
  "success": false,
  "error": "Internal server error",
  "message": "Failed to generate upload URL"
}