/organizations/{organization_id}/sites/{site_id}/workspaces/{workspace_id}/media

Beta Notice: This is a pre-release beta endpoint. It is subject to change without notice and has no uptime guarantee.
Retrieves a paginated list of media items in a workspace. Supports optional filters for media type, a WGS84 bounding box, a title substring, media category, and an inclusive capture-date range. Multiple filters combine as a logical AND, and pagination.count always reflects the filtered set. Media with no capture date are excluded whenever either capture-date bound is supplied.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

ID of the organization

string
required

ID of the site

string
required

ID of the workspace

Query Params
number

A page number within the paginated result set.

number

Number of results to return per page.

string

Bounding box filter as a comma-separated WGS84 string: min_lon,min_lat,max_lon,max_lat. All four values must be finite numbers within WGS84 bounds with min_lon <= max_lon and min_lat <= max_lat.

media_type__in
array of strings

Filter media to one or more supported types. Provide a comma-separated list, e.g. ?media_type__in=IMAGE,WALKTHROUGH. Values are case-insensitive.

media_type__in
Allowed:
string
length ≤ 256

Case-insensitive substring filter against the media title. Whitespace is trimmed; an empty value is treated as no filter. %, _, and \ are matched literally.

media_category__in
array of strings

Filter media to one or more media categories. Provide a comma-separated list of media category ids, e.g. ?media_category__in=ca123456,ca654321. Media is returned when it carries at least one of the ids. At most 100 ids may be given. An empty value is treated as no filter. Ids are case-sensitive

media_category__in
date-time

Only return media captured at or after this ISO 8601 datetime, inclusive. Offsets are honoured, without one the value is UTC. A date without time defaults to midnight. Example: 2026-06-01 is equivalent to 2026-06-01T00:00:00Z.

date-time

Only return media captured at or before this ISO 8601 datetime, inclusive. Offsets are honoured, without one the value is UTC. A date without time defaults to midnight. Example: 2026-06-01 is equivalent to 2026-06-01T00:00:00Z. 2026-06-01 excludes 1 June, use 2026-06-01T23:59:59.999Z for the full day.

string
enum

Sort results by a single field. Prefix with - for descending order. Supported fields: title, date_created. Examples: ?ordering=title (ascending) or ?ordering=-date_created (descending).

Allowed:
boolean
Defaults to false

When true, populates download_urls with time-limited presigned source-file links (requires export permission).

string
enum
Defaults to site

Coordinate system for returned geometry. Defaults to "site" (the site's local coordinate system). Use "wgs84" to return coordinates in WGS 84.

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json