---
title: "Update Builder Favorite"
method: PUT
path: "/api/v1/builder-favorites/{favorite_id}"
tags: ["User APIs", "builder-favorites"]
---

# Update Builder Favorite

`PUT /api/v1/builder-favorites/{favorite_id}`

## Request

- Base URL: `https://carbonarc.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://carbonarc.ai/api/v1/builder-favorites/{favorite_id}`
- Auth: OAuth 2 (authorization code, authorization URL `authorize`, token URL `token`)

Update an existing builder favorite

## Path parameters

- `favorite_id` string, uuid, required

## Request body

- UserBuilderFiltersFavoritesUpdate: Schema for updating an existing builder favorite
  - `flow` string, nullable: Flow type (e.g., 'entity', 'insight')
  - `name` string, nullable: User-defined name for the favorite
  - `filters` object, nullable: Filter configuration as JSON

## Response `200`

Successful Response

- UserBuilderFiltersFavoritesRead: Schema for reading a builder favorite
  - `flow` string, required: Flow type (e.g., 'entity', 'insight')
  - `name` string, required: User-defined name for the favorite
  - `filters` object: Filter configuration as JSON
  - `id` string, uuid, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.dev/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/carbonarc/apis/carbon-arc-client-admin-api/revisions/56e2edae9dfe?raw)