Assets

List asset entities

Changed on

List saved characters, props, environments, styles, and scenes in the authenticated account. Returns their @mention handles and defining reference images. Uses limit and offset pagination; omit types to include every entity type.

Required permissions: assets:read. Key presets that include them: API, SERVERLESS, READONLY, FULL. See key permissions.

get/assets/entities

Request

  • Base URL
    https://api.fal.ai/v1
  • URL
    https://api.fal.ai/v1/assets/entities
  • Auth
    API key in header Authorization

Query parameters

limitinteger

Maximum number of entities to return

Example:50
offsetinteger nullable

Number of entities to skip

typesstring[] nullable

Entity types to include, comma-separated. Omit to list all types.

[
  "prop",
  "environment"
]

Response

Entities

Example response

{
  "entities": [
    {
      "type": "character"
    }
  ]
}

Changes