---
title: "Favorite asset collection"
method: POST
path: "/assets/collections/{collection_id}/favorite"
tags: ["Assets"]
---

# Favorite asset collection

`POST /assets/collections/{collection_id}/favorite`

## Request

- Base URL: `https://api.fal.ai/v1`
- URL: `https://api.fal.ai/v1/assets/collections/{collection_id}/favorite`
- Auth: API key in header `Authorization`

Favorite an asset collection for the authenticated user's fal Assets library.

**Required permissions:** `assets:write`. Key presets that include them: `API`, `SERVERLESS`, `FULL`. See [key permissions](https://fal.ai/docs/documentation/model-apis/authentication/key-based#permissions).

## Path parameters

- `collection_id` string, required: Collection ID

## Headers

- `Idempotency-Key` string: Optional idempotency key for safe request retries

## Response `200`

Collection favorited

- object
  - `collection` object, required: Asset collection
    - `id` string, required: Collection ID
    - `type` 'manual' | 'smart' | 'character', required: Collection type
    - `name` string, required: Collection display name
    - `description` string, nullable, required: Collection description
    - `icon` string, nullable, required: Optional collection icon
    - `color` string, nullable, required: Optional collection color
    - `cover_image_url` string, nullable, required: Optional cover image URL for the collection
    - `character_identifier` string, nullable, required: Character @mention identifier for character collections
    - `parent_collection_id` string, nullable, required: Parent collection ID for a nested (manual) collection; null when top-level
    - `is_favorited` boolean, required: Whether the collection is favorited
    - `filters` unknown
    - `asset_count` number, nullable: Exact asset count when available; null for smart/character collections
    - `created_at` string, required: Collection creation time
    - `updated_at` string, required: Collection update time

## Other responses

- `400`: Invalid request parameters
- `401`: Authentication required
- `403`: Access denied
- `404`: Resource not found
- `409`: Invalid request parameters
- `422`: Invalid request parameters
- `429`: Rate limit exceeded
- `500`: Internal server error
- `502`: Upstream asset service error

---

[API](https://skmtc.dev/fal/apis/platform-apis.md) - [All operations](https://skmtc.dev/fal/apis/platform-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/fal/apis/platform-apis/revisions/3b3b61bedf06?raw)