Unfavorite asset character
Unfavorite an asset character for the authenticated user’s fal Assets library.
Required permissions: assets:write. Key presets that include them: API, SERVERLESS, FULL. See key permissions.
curl --request POST \
--url https://api.fal.ai/v1/assets/characters/{character_id}/unfavorite \
--header 'Authorization: <api-key>'import requests
url = "https://api.fal.ai/v1/assets/characters/{character_id}/unfavorite"
headers = {"Authorization": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: '<api-key>'}};
fetch('https://api.fal.ai/v1/assets/characters/{character_id}/unfavorite', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"character": {
"id": "d7tatpsregjaga2cf3d0",
"type": "character",
"name": "Alice",
"description": "A character with red hair and a blue jacket",
"icon": "folder",
"color": "blue",
"cover_image_url": "https://v3b.fal.media/files/b/0a9b4900/PDbTGyzqRh1aijW2WQiY9_opengraph-1%20%281%29.png",
"character_identifier": "alice",
"parent_collection_id": null,
"is_favorited": false,
"created_at": "2026-05-23T20:00:00.000Z",
"updated_at": "2026-05-23T20:00:00.000Z",
"asset_count": null,
"reference_images": [
"https://v3b.fal.media/files/b/0a9b4900/PDbTGyzqRh1aijW2WQiY9_opengraph-1%20%281%29.png"
]
}
}{
"error": {
"type": "validation_error",
"message": "Invalid request parameters"
}
}{
"error": {
"type": "authorization_error",
"message": "Authentication required"
}
}{
"error": {
"type": "authorization_error",
"message": "Access denied"
}
}{
"error": {
"type": "not_found",
"message": "Resource not found"
}
}{
"error": {
"type": "validation_error",
"message": "Invalid request parameters"
}
}{
"error": {
"type": "validation_error",
"message": "Invalid request parameters"
}
}{
"error": {
"type": "rate_limited",
"message": "Rate limit exceeded"
}
}{
"error": {
"type": "server_error",
"message": "An unexpected error occurred"
}
}{
"error": {
"type": "server_error",
"message": "Upstream asset service failed"
}
}Authorizations
Key on the API preset, or any key whose permissions include the ones this API lists. APIs with no required permission accept any key. Prefix it with "Key ", e.g. Authorization: Key YOUR_API_KEY
Headers
Optional idempotency key for safe request retries
"550e8400-e29b-41d4-a716-446655440000"
Path Parameters
Character collection ID
1"d7tatpsregjaga2cf3d0"
Response
Character unfavorited
Asset character
Hide child attributes
Hide child attributes
Collection ID
Collection type
character Collection display name
Collection description
Optional collection icon
Optional collection color
Optional cover image URL for the collection
Character @mention identifier for character collections
Parent collection ID for a nested (manual) collection; null when top-level
Whether the collection is favorited
Collection creation time
Collection update time
Reference images used for character matching
Exact asset count when available; null for smart/character collections
Was this page helpful?
curl --request POST \
--url https://api.fal.ai/v1/assets/characters/{character_id}/unfavorite \
--header 'Authorization: <api-key>'import requests
url = "https://api.fal.ai/v1/assets/characters/{character_id}/unfavorite"
headers = {"Authorization": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: '<api-key>'}};
fetch('https://api.fal.ai/v1/assets/characters/{character_id}/unfavorite', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"character": {
"id": "d7tatpsregjaga2cf3d0",
"type": "character",
"name": "Alice",
"description": "A character with red hair and a blue jacket",
"icon": "folder",
"color": "blue",
"cover_image_url": "https://v3b.fal.media/files/b/0a9b4900/PDbTGyzqRh1aijW2WQiY9_opengraph-1%20%281%29.png",
"character_identifier": "alice",
"parent_collection_id": null,
"is_favorited": false,
"created_at": "2026-05-23T20:00:00.000Z",
"updated_at": "2026-05-23T20:00:00.000Z",
"asset_count": null,
"reference_images": [
"https://v3b.fal.media/files/b/0a9b4900/PDbTGyzqRh1aijW2WQiY9_opengraph-1%20%281%29.png"
]
}
}{
"error": {
"type": "validation_error",
"message": "Invalid request parameters"
}
}{
"error": {
"type": "authorization_error",
"message": "Authentication required"
}
}{
"error": {
"type": "authorization_error",
"message": "Access denied"
}
}{
"error": {
"type": "not_found",
"message": "Resource not found"
}
}{
"error": {
"type": "validation_error",
"message": "Invalid request parameters"
}
}{
"error": {
"type": "validation_error",
"message": "Invalid request parameters"
}
}{
"error": {
"type": "rate_limited",
"message": "Rate limit exceeded"
}
}{
"error": {
"type": "server_error",
"message": "An unexpected error occurred"
}
}{
"error": {
"type": "server_error",
"message": "Upstream asset service failed"
}
}