Skip to main content
GET
/
media
/
{id}
Get Media
curl --request GET \
  --url https://api.example.com/media/{id}

​
Endpoint

GET /media/{id}

​
Path Parameters

ParameterTypeDescription
idstringMedia asset ID

​
Example Request

curl -X GET "https://api.skayle.ai/v1/media/media_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Example Response

{
  "data": {
    "id": "media_abc123",
    "type": "media",
    "attributes": {
      "filename": "hero-image.jpg",
      "url": "https://cdn.skayle.io/media/hero-image.jpg",
      "mimeType": "image/jpeg",
      "size": 245678,
      "width": 1920,
      "height": 1080,
      "alt": "Hero image for blog post",
      "caption": "Photo by John Doe",
      "variants": {
        "thumbnail": "https://cdn.skayle.io/media/hero-image-thumb.jpg",
        "medium": "https://cdn.skayle.io/media/hero-image-medium.jpg",
        "large": "https://cdn.skayle.io/media/hero-image-large.jpg"
      },
      "metadata": {
        "camera": "Canon EOS R5",
        "focalLength": "50mm",
        "aperture": "f/1.8"
      },
      "createdAt": "2024-01-15T10:00:00Z",
      "updatedAt": "2024-01-15T10:00:00Z"
    }
  }
}

​
Image Variants

For images, Skayle automatically generates optimized variants:
VariantMax WidthUse Case
thumbnail150pxThumbnails, previews
medium600pxIn-content images
large1200pxFeatured images
original-Full resolution

​
Error Responses

​
404 Not Found

{
  "errors": [
    {
      "status": "404",
      "title": "Not Found",
      "detail": "Media asset not found"
    }
  ]
}