---
title: "Update a tile in a note"
method: PUT
path: "/notes/{noteId}/tiles/{tileId}"
---

# Update a tile in a note

`PUT /notes/{noteId}/tiles/{tileId}`

Update or create tile.
A tile is rendered with a structured header and a markdown content.
You can create a tile by copying a tile id from Slite by clicking on `Copy block id` on an empty line setting in the editor.

## Path parameters

- `noteId` string, required
- `tileId` string, required

## Request body

- object
  - `title` string, nullable — Title of the tile
  - `iconURL` string, nullable — Icon URL to show in the tile
  - `status` object, nullable — If needed a tile status can be specified with its color
    - `colorHex` string, nullable
    - `label` string, required — Content of the status
  - `url` string, nullable — The tile can be linked to an external URL
  - `content` string, nullable — The content of the tile. Can be in markdown.

## Response `200`

Ok

- object
  - `url` string, required — Direct url of the tile in the note

## Other responses

- `401` — Invalid authentication
- `422` — Input validation error
- `429` — Rate limitation error
- `default` — Unexpected error

---

[API](https://skmtc.net/slite/apis/public-slite-api.md) · [All operations](https://skmtc.net/slite/apis/public-slite-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slite/public-slite-api/versions/7cee1a5a5128/schema)