> ## Documentation Index
> Fetch the complete documentation index at: https://fal.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Platform APIs for Assets

> Programmatic access to fal Assets for browsing, searching, uploading, and organizing generated media

The **fal Platform APIs** provide programmatic access to fal Assets, including:

* **Browse and search** - List assets, filter by media type or source, and search with text or fal-hosted media
* **Uploads** - Add media to your Assets library from API or CLI-driven workflows
* **Collections** - Create manual collections and add or remove assets
* **Characters** - Create reusable character collections with reference images
* **Tags and favorites** - Organize assets with tags and favorite state

Use these APIs when you want generated outputs, uploaded references, and reusable creative assets to be available outside the dashboard. For generating new media, use the [Model APIs](/documentation/model-apis/overview), then use Assets to browse, search, and organize the media that belongs in your library.

## Available Operations

The Platform APIs provide the following endpoints for fal Assets:

<CardGroup cols={2}>
  <Card title="Browse Assets" icon="image" href="/platform-apis/v1/assets">
    Browse and semantically search assets across media, uploads, favorites, collections, tags, and character references
  </Card>

  <Card title="Upload Asset" icon="upload" href="/platform-apis/v1/assets/uploads">
    Upload fal-hosted media into your Assets library
  </Card>

  <Card title="Get Asset" icon="info-circle" href="/platform-apis/v1/assets/get">
    Retrieve a single asset by vector ID
  </Card>

  <Card title="Favorite Asset" icon="star" href="/platform-apis/v1/assets/favorite">
    Favorite an asset by vector ID or request ID
  </Card>
</CardGroup>

## Collections

<CardGroup cols={2}>
  <Card title="List Collections" icon="folder" href="/platform-apis/v1/assets/collections">
    List asset collections in your library
  </Card>

  <Card title="Create Collection" icon="plus" href="/platform-apis/v1/assets/collections/create">
    Create a collection for organizing related assets
  </Card>

  <Card title="Browse Collection Assets" icon="grid" href="/platform-apis/v1/assets/collections/assets">
    Browse assets inside a collection
  </Card>

  <Card title="Add Asset to Collection" icon="folder-plus" href="/platform-apis/v1/assets/collections/assets/add">
    Add an asset to a collection by vector ID or request ID
  </Card>
</CardGroup>

## Characters

<CardGroup cols={2}>
  <Card title="List Characters" icon="users" href="/platform-apis/v1/assets/characters">
    List character collections in your library
  </Card>

  <Card title="Create Character" icon="user-plus" href="/platform-apis/v1/assets/characters/create">
    Create a reusable character from descriptions and reference images
  </Card>

  <Card title="Get Character" icon="info-circle" href="/platform-apis/v1/assets/characters/get">
    Retrieve a character collection
  </Card>

  <Card title="Favorite Character" icon="star" href="/platform-apis/v1/assets/characters/favorite">
    Mark a character collection as a favorite
  </Card>
</CardGroup>

## Tags

<CardGroup cols={2}>
  <Card title="List Tags" icon="tags" href="/platform-apis/v1/assets/tags">
    List tags in your Assets library
  </Card>

  <Card title="Create Tag" icon="tag" href="/platform-apis/v1/assets/tags/create">
    Create a tag for organizing assets
  </Card>

  <Card title="Set Tags for Asset" icon="list-check" href="/platform-apis/v1/assets/tags/set-for-asset">
    Replace the full tag set for an asset
  </Card>

  <Card title="Assign Tag" icon="plus" href="/platform-apis/v1/assets/tags/assign">
    Assign a tag to an asset by vector ID or request ID
  </Card>
</CardGroup>

## Authentication

Assets endpoints require an API key in the `Authorization` header:

```bash theme={null}
Authorization: Key YOUR_API_KEY
```

<Note>
  If generated media is not appearing in Assets, check your Assets settings in the dashboard and enable the request sources you want available in the library.
</Note>
