1. API reference
  2. Media

List media files

GEThttps://howdybell.com/api/v1/media

Retrieve a paginated list of media files for a specific location. You can filter results by folder, search by name, or limit by file kind.

Parameters

  • folder_idintegerquery
  • qstringquery
  • kindstringquery
  • pageintegerquery
  • location_idintegerRequiredquery

    The location to work in. Must belong to your workspace.

Responses

200

  • dataarray of object
    • idinteger
    • namestring
    • kindstring
    • mimestring
    • sizeinteger
    • widthinteger, nullable
    • heightinteger, nullable
    • folder_idinteger, nullable
    • urlstring
    • created_atstring, nullable
      date and time (ISO 8601)
    • uploaded_byobject, nullable
      • idinteger
      • namestring
  • metaobject
    • current_pageinteger
    • last_pageinteger
    • totalinteger

422 Validation error

  • messagestring

    Errors overview.

  • errorsobject

    A detailed description of each field that failed validation.

RequestcURL
curl -X GET "https://howdybell.com/api/v1/media?location_id=1" \
  -H "Authorization: Bearer $HOWDYBELL_TOKEN" \
  -H "Accept: application/json" \
Response200
{
  "data": [],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "total": 0
  }
}
List media files (GET /api/v1/media) | HowdyBell Developers