BAbase44

List assets

Changed on

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns the files in the app's media library, newest first unless you set sort. That includes files uploaded to the app and files Base44 generated for it, such as AI-generated images and videos.

You can filter by:

  • Text in the file name
  • How the file got into the library
  • File type

You get up to 500 assets, and there's no pagination. Use the filters to narrow a larger library.

This is limited to 120 requests a minute per app for each workspace's personal API keys, so every key in a workspace shares one allowance. Some workspaces have a different limit.

<Note>This endpoint accepts a personal API key, including a read-only one, from anyone with access to the app, viewers included. Workspace API keys are not authorized for it.</Note>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>

get/api/apps/{app_id}/assets

Request

  • Base URL
    https://app.base44.com
  • URL
    https://app.base44.com/api/apps/{app_id}/assets
  • Auth
    HTTP bearer

Path parameters

app_idstring required

ID of the app whose media library to read.

Query parameters

searchstring

Text to match, ignoring case, anywhere in the file name. For example, logo matches Logo-dark.png.

sortstring

Order of the list. Either newest, oldest, or a-z for file name order, where uppercase letters come before lowercase ones. Defaults to newest, and any other value also sorts newest first.

source_typestring

Keep only files with this source_type, either upload or generated.

file_typestring

Keep only files with this file_type, matched exactly. For example, png.

Response

The app's assets.

idstring required

ID of the asset.

app_idstring required

ID of the app the asset belongs to.

file_namestring required

Name of the file.

file_urlstring required

URL of the file.

source_type'upload' | 'generated' required

How the file got into the library. upload for a file someone uploaded, and generated for most files Base44 created for the app, such as AI-generated images and videos or a Figma import.

file_typestring nullable required

File extension without the dot, usually lowercase, such as png or mp4. The value is null when the file was added without one.

created_datestring required

When the asset was added to the library, as a UTC timestamp in ISO 8601 format.

updated_datestring required

When the asset was last changed, such as renamed, as a UTC timestamp in ISO 8601 format.

Example response

[
  {
    "id": "68b0e1f2a3c4d5e6f7a8b9c0",
    "app_id": "6820f3a4e7b91d003c45a1f2",
    "file_name": "Logo-dark.png",
    "file_url": "https://media.base44.com/files/public/6820f3a4e7b91d003c45a1f2/Logo-dark.png",
    "source_type": "upload",
    "file_type": "png",
    "created_date": "2026-01-15T09:23:41",
    "updated_date": "2026-01-15T09:31:07"
  }
]

Changes

  • c23775445de2Revision changes
    • breaking

      query request parameter file_type list-of-types was narrowed by removing types null

    • breaking

      query request parameter search list-of-types was narrowed by removing types null

    • breaking

      query request parameter sort list-of-types was narrowed by removing types null

    • breaking

      query request parameter source_type list-of-types was narrowed by removing types null

    • info

      for the query request parameter file_type, the type was generalized from no type to string

    • info

      for the query request parameter search, the type was generalized from no type to string

    • info

      for the query request parameter sort, the type was generalized from no type to string

    • info

      for the query request parameter source_type, the type was generalized from no type to string

  • 80287813ab84Revision changes
    • info

      the endpoint scheme security PersonalAccessTokenAuth was added to the API