---
title: "Set a tile icon for a device"
method: POST
path: "/v1/enterprise/{enterprise_id}/tile-icon-apply/"
tags: ["esper_cloud_api_Tile Icon"]
---

# Set a tile icon for a device

`POST /v1/enterprise/{enterprise_id}/tile-icon-apply/`

Apply a tile icon to a device.

## Path parameters

- `enterprise_id` string, required

## Request body

- EsperCloudApiApplyTileIcon
  - `icon` string, uuid, nullable
  - `apply_mode` 'devices' | 'all_devices' | 'groups' | 'device_model'
  - `device_model` string, nullable
  - `devices` unknown[]
    - unknown
  - `groups` string[]

## Response `201`

Successful Operation

- EsperCloudApiApplyTileIcon
  - `icon` string, uuid, nullable
  - `apply_mode` 'devices' | 'all_devices' | 'groups' | 'device_model'
  - `device_model` string, nullable
  - `devices` unknown[]
    - unknown
  - `groups` string[]

## Other responses

- `400` — Bad request
- `401` — Authorization information is missing or invalid.
- `403` — Forbidden, no permission to perform this action.
- `500` — Internal server error

---

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