List Media

get/v1/media

Returns a cursor-paginated, workspace-scoped list of media rows from the records pipeline. Read-only; no side effects. Media is created via the avatar/logo upload sub-resources on people and companies. ## Filtering & sorting Filter via `POST /v1/records/query` (root `media`) or the `filters` model; operators are gated by each field's data type. See [Filtering & sorting](../filtering-and-sorting). **Filterable fields** | Field | Type | Allowed operators | |---|---|---| | `composite_companies_list` | text | `contains` `eq` `neq` `starts_with` `ends_with` `is_null` `is_not_null` | | `composite_media_summary` | text | `contains` `eq` `neq` `starts_with` `ends_with` `is_null` `is_not_null` | | `composite_people_list` | text | `contains` `eq` `neq` `starts_with` `ends_with` `is_null` `is_not_null` | | `created_at` | date | `eq` `lt` `gt` `is_null` `is_not_null` | | `deleted_at` | date | `eq` `lt` `gt` `is_null` `is_not_null` | | `label` | text | `contains` `eq` `neq` `starts_with` `ends_with` `is_null` `is_not_null` | | `media_id` | text | `contains` `eq` `neq` `starts_with` `ends_with` `is_null` `is_not_null` | | `media_type` | enum | `eq` `neq` `in` `is_null` `is_not_null` | | `path` | text | `contains` `eq` `neq` `starts_with` `ends_with` `is_null` `is_not_null` | | `pk` | number | `eq` `neq` `gt` `gte` `lt` `lte` `is_null` `is_not_null` | | `updated_at` | date | `eq` `lt` `gt` `is_null` `is_not_null` | | `url` | text | `contains` `eq` `neq` `starts_with` `ends_with` `is_null` `is_not_null` | **Sortable fields:** `composite_companies_list`, `composite_media_summary`, `composite_people_list`, `created_at`, `deleted_at`, `label`, `media_id`, `media_type`, `path`, `pk`, `updated_at`, `url` (via `orderBy` / `sort`, `asc`|`desc`).

Requires a bearer token: Authorization: Bearer <token>.

Query parameters

Name	Type	Required	Description
limit	string	No	Page size, 1 to 200.e.g. 50
cursor	string	No	Opaque cursor from a prior page's links.next.e.g. eyJwayI6OTl9
orderBy	string	No	Column to order by.e.g. created_at
direction	string	No	Sort direction.e.g. desc
workspaceId	string <uuid>	No	Workspace to scope to; defaults to the token's workspace.e.g. 8f6b2c10-4a1e-4d2b-9c3a-1f0e7a5b6c21

Request

cURL

curl -X GET https://api.wellapp.ai/v1/media \
  -H "Authorization: Bearer $WELL_API_TOKEN"

Responses

200 — A page of media rows.

{
  "data": [
    {
      "type": "media",
      "id": "2c3d4e5f-6071-4829-93a4-b5c6d7e8f9a1",
      "attributes": {
        "media_type": "logo",
        "label": "Foldspace logo",
        "url": "https://media.wellapp.ai/ws/foldspace-logo.png",
        "created_at": "2026-01-12T09:35:00.000Z"
      }
    }
  ],
  "meta": {
    "total": 12,
    "count": 1
  },
  "links": {
    "next": null
  }
}

401 — Unauthorized

{
  "code": "UNAUTHORIZED",
  "status": 401,
  "title": "Unauthorized",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

403 — Forbidden

{
  "code": "FORBIDDEN",
  "status": 403,
  "title": "Forbidden",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

This resource's related objects (the ones you can include) and how to filter or sort on each:

Relationship	Cardinality	Filter on a field	Sort by a field
`workspace`	to-one (workspace)	`{ "workspace": { "name": { "_eq": … } } }`	`"field": "workspace.name"` ✅

Replace field_name with any field of the related object. See its object-reference page for the full field list.

Filter by a to-one relation (and sort by it):

{
  "root": "media",
  "whereClause": { "workspace": { "name": { "_ilike": "%acme%" } } },
  "orderBy": { "field": "workspace.name", "direction": "asc" }
}

Query parameters

Request

Responses

Filtering & sorting on related objects