---
title: "Favorite asset"
method: POST
path: "/assets/favorite"
tags: ["Assets"]
---

# Favorite asset

`POST /assets/favorite`

Favorite an asset. Provide a request ID or vector ID; unresolved references are materialized before favorite state is added.

## Headers

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

## Request body

- object
  - `asset_id` string — Asset ID (canonical catalog identity)
  - `request_id` string — Request ID to save as an asset before mutating
  - `vector_id` string — Vector ID to save as an asset before mutating. Prefer asset_id

## Response `200`

Asset favorited

- object
  - `is_favorited` boolean, required — Whether the asset is now favorited

## 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-service-production.skmtc.workers.dev/v1/apis/fal/platform-apis/revisions/0c7dabf80b00/schema)