---
title: "Update an array of favorites"
method: PUT
path: "/me/favorites"
tags: ["favorites"]
---

# Update an array of favorites

`PUT /me/favorites`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/me/favorites`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/me/favorites/put.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows updating an array of favorites. It follow all the requirements
and behavior from the [post] (Create Favorite) counterpart.

## Query parameters

- `meta` boolean

## Request body

- HandlerfavoritesPayload
  - `billable` boolean
  - `description` string
  - `project_id` integer
  - `tag_ids` integer[]
  - `task_id` integer
  - `workspace_id` integer

## Response `200`

Updated favorite

- ModelsFavorite
  - `billable` boolean
  - `client_name` string: Related entities meta fields - if requested
  - `created_at` string
  - `deleted_at` string
  - `description` string
  - `favorite_id` integer
  - `project_active` boolean
  - `project_color` string
  - `project_id` integer
  - `project_name` string
  - `public` boolean
  - `rank` integer
  - `tag_ids` integer[]: tag IDs are loaded into this after loading the Favorite
  - `task_id` integer
  - `task_name` string
  - `workspace_id` integer

## Other responses

- `400`: Possible error messages:<ul><li>the parameter '{parameter}' is invalid</li><li>we could not parse the provided parameters</li><li>user %d has no access to Favorites feature</li><li>favorite attributes are not valid: {attributes}</li><li>favorite constraints were not met: {constraints}</li></ul>
- `403`: Possible error messages:<ul><li>user {user_id} has no access to Favorites feature</li><li>user {user_id} has no access to all resources: {resources}</li></ul>
- `500`: Internal Server Error

---

[API](https://skmtc.dev/toggl/apis/toggl-api.md) - [All operations](https://skmtc.dev/toggl/apis/toggl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toggl/apis/toggl-api/revisions/3085aee16990?raw)