---
title: "Upload Ideation Flats"
method: POST
path: "/ideation/upload-flats"
tags: ["ideation"]
---

# Upload Ideation Flats

`POST /ideation/upload-flats`

## Request

- Base URL: `https://api.threadchain.pro` (the document declares no server; this is the origin it was published from)
- URL: `https://api.threadchain.pro/ideation/upload-flats`
- Auth: OAuth 2
  - Password
  - Token URL: `auth/token`

Upload user-owned front (and optional back) flats for the Ideation "Or upload your own flats" path.

Also detects the design format from the images (returned as ``design_format``).

## Request body `multipart/form-data`

- BodyUploadIdeationFlatsIdeationUploadFlatsPost
  - `front` string, binary, required
  - `back` string, binary, nullable

## Response `201`

Successful Response

- IdeationFlatsResponse
  - `front_url` string, required
  - `back_url` string, nullable
  - `prompt` string, nullable
  - `design_format` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/threadchain/apis/threadchain-backend.md) - [All operations](https://skmtc.dev/threadchain/apis/threadchain-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/threadchain/apis/threadchain-backend/revisions/8ee288a7e6bd?raw)