---
title: "Unfavorite asset"
method: POST
path: "/assets/unfavorite"
tags: ["Assets"]
---

# Unfavorite asset

`POST /assets/unfavorite`

Unfavorite an asset by request ID or vector ID.

## 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 unfavorited

- 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)