---
title: "List valid icons and colors"
method: GET
path: "/public/v1/guidance/visual-options"
tags: ["Guidance"]
---

# List valid icons and colors

`GET /public/v1/guidance/visual-options`

Returns the allowlists used when creating objects, tables, fields, and select options: valid icon keys, icon colors, option colors, and tag/relation modes. Sourced live from backend constants, so values never drift from validation. Accepts any valid API key.

## Response `200`

Visual option allowlists

- PublicVisualOptions
  - `iconKeys` string[], required — Valid icon keys for the `icon`/`emoji` field on objects and record types (the IconPicker set).
  - `iconColors` object[], required — Valid colors for an object/record-type/field `iconColor`.
    - `name` string, required
    - `value` string, required
  - `optionColors` object[], required — Valid preset colors for tag/select option `color` (note: a different palette from iconColor).
    - `name` string, required
    - `value` string, required
  - `tagModes` string[], required
  - `relationModes` string[], required

## Other responses

- `401` — Unauthorized

---

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