Sign in

List assets

<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

Path parameters

app_idstring required

ID of the app whose media library to read.

ID of the app whose media library to read.

Query parameters

searchstring nullable

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

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

sortstring nullable

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.

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 nullable

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

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

file_typestring nullable

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

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

Changed in 1 of the 39 revisions of this API.1