---
title: "Set the caller's default folder for a key: their own personal folder or a folder of a team they have joined. Refusals: default_key_invalid, default_folder_invalid (400), folder_not_found (404)."
method: PUT
path: "/placement-defaults/{key}"
tags: ["Folders"]
---

# Set the caller's default folder for a key: their own personal folder or a folder of a team they have joined. Refusals: default_key_invalid, default_folder_invalid (400), folder_not_found (404).

`PUT /placement-defaults/{key}`

## Request

- Base URL: `https://www.livediagram.app/api`
- URL: `https://www.livediagram.app/api/placement-defaults/{key}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Owner-Id`

## Path parameters

- `key` string, required

## Request body

- object
  - `folderId` string, required

## Response `204`

Success.

## Other responses

- `400`: Error.
- `401`: Error.
- `404`: Error.
- `429`: Error.

---

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