---
title: "Suggest logo directions and styles"
method: GET
path: "/v1/mascots/{id}/logos/suggestions"
tags: ["Suggestions"]
---

# Suggest logo directions and styles

`GET /v1/mascots/{id}/logos/suggestions`

## Request

- Base URL: `https://api.masko.ai`
- URL: `https://api.masko.ai/v1/mascots/{id}/logos/suggestions`
- Auth: HTTP bearer

Five directions, including face portrait and full body, plus three suggested styles. Each direction can include a style. A style can be custom; preset_id is present only when it exactly matches a built-in preset. Returns defaults if generation is unavailable, unless refresh=true, which returns 503. No image credits; does not change the mascot.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `variant_id` string, uuid
- `refresh` 'true' | 'false'

## Response `200`

Logo ideas

- object
  - `data` object, required
    - `prompt_version` number, required
    - `cached` boolean, required
    - `descriptions` object[], required
      - `name` string, required
      - `description` string, required
      - `style` object, nullable
        - `name` string, required
        - `instruction` string, required
        - `preset_id` 'graphic-app-icon' | 'cut-paper' | 'soft-depth' | 'geometric' | 'abstract-symbol' | 'monoline-symbol' | 'negative-space' | 'retro-emblem' | 'hand-drawn'
    - `styles` object[], required
      - `name` string, required
      - `instruction` string, required
      - `preset_id` 'graphic-app-icon' | 'cut-paper' | 'soft-depth' | 'geometric' | 'abstract-symbol' | 'monoline-symbol' | 'negative-space' | 'retro-emblem' | 'hand-drawn'

## Other responses

- `400`: Invalid request
- `401`: Unauthorized
- `402`: Insufficient credits
- `403`: Write access required
- `404`: Source or mascot not found
- `409`: Request ID conflict or variant not approved
- `429`: Rate limited
- `500`: Internal error
- `503`: Generation unavailable

---

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