---
title: "inserts a favorite"
method: POST
path: "/4.0/favorites/"
tags: ["Diagram Favorites"]
---

# inserts a favorite

`POST /4.0/favorites/`

## Request body

- FavoritesFavoriteDiagramService
  - `user_id` string
  - `legacy_user_id` integer
  - `team_id` string
  - `legacy_team_id` integer
  - `space_id` integer
  - `name` string, required
  - `floor_elements` object, required
  - `legacy_property_id` integer

## Response `200`

inserted favorite with id

- FavoritesFavoriteDiagramService
  - `user_id` string
  - `legacy_user_id` integer
  - `team_id` string
  - `legacy_team_id` integer
  - `space_id` integer
  - `name` string, required
  - `floor_elements` object, required
  - `legacy_property_id` integer

## Other responses

- `400` — favorite not valid
- `409` — created a favorite with an existing name

---

[API](https://skmtc.net/socialtables/apis/social-tables-api-gateway.md) · [All operations](https://skmtc.net/socialtables/apis/social-tables-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/socialtables/social-tables-api-gateway/revisions/b8bbb74a1212/schema)