---
title: "Create a user style from the RD Pro template"
method: POST
path: "/styles"
tags: ["styles"]
---

# Create a user style from the RD Pro template

`POST /styles`

## Request

- Base URL: `https://api.retrodiffusion.ai/v2`
- URL: `https://api.retrodiffusion.ai/v2/styles`
- Auth: none declared. Required headers: `X-RD-Token`

Creates a user-owned style using the RD Pro template defaults. Only RD Pro editable fields are accepted in this endpoint. Exactly one reference image is required. Use the returned `prompt_style` value in /inferences.

## Headers

- `X-RD-Token` string, required

## Request body

- ExternalRDProStyleCreate: Public API schema for creating styles from the RD Pro user template. Only fields exposed by the RD Pro template are accepted.
  - `name` string, required
  - `description` string
  - `style_icon` string
  - `reference_images` string[], required: Exactly one base64-encoded reference image is required.
  - `reference_caption` string
  - `apply_prompt_fixer` boolean
  - `llm_instructions` string
  - `expanded_llm_instructions` string
  - `user_prompt_template` string
  - `force_palette` boolean
  - `force_bg_removal` boolean
  - `min_width` integer
  - `min_height` integer

## Response `201`

Successful Response

- ExternalStyleCreateResponse: Minimal response model for public API style creation.
  - `id` string, required
  - `prompt_style` string, required
  - `name` string, required
  - `description` string, required
  - `type` 'system' | 'user' | 'template' | 'experimental', required: Types of Neo Art Styles for differentiation and filtering
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `405`: Method not allowed.
- `422`: Validation Error
- `500`: Internal Server Error

---

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