GET https://api.gorilladash.com/api/v1/media returns images from your media library. Use it for a gallery, a rotating hero image, or anywhere a website should show pictures your marketing team controls rather than ones a developer uploaded.
Parameters
| Parameter | Notes |
|---|---|
page | Page number, from 1. |
results_per_page | Up to 1000. Defaults to just 5. |
tribe_slug | Only media attached to one tribe. |
starred | Send true for starred images only. |
Newest first. As with tribes, the default page size is five — set results_per_page explicitly.
What comes back
| Field | Notes |
|---|---|
id | The media id. |
organisation_id | Owning organisation. |
name | The image name. |
description | Its description. Use this as alt text where it is filled in. |
url | A direct URL to the image. |
Using starred as a curation switch
A NICE PATTERN
Build your gallery against
starred=true. Your marketing team then controls exactly what appears on the website by starring and unstarring in the media library, with no developer involved and nothing to deploy.Scoping and caching
An organisation key sees the organisation's media and can filter with tribe_slug. A tribe key sees only media attached to that tribe. The endpoint is cached and sends an ETag, so a newly uploaded image can take a few minutes to appear.
DO NOT RE-HOST THE IMAGES