---
title: "Plan Upload Naming"
method: POST
path: "/api/v1/quick-spaces/naming/plan"
tags: ["quickSpaces", "quickSpaces"]
---

# Plan Upload Naming

`POST /api/v1/quick-spaces/naming/plan`

Name a batch of files BEFORE they are uploaded.

A read — nothing is created — so it is safe to call as the user edits the builder. The upload
itself carries the chosen name as the file's own name, which is what both the storage key and
the displayed name are derived from, so no separate rename call follows.

## Request body

- NamingPlanRequestDTO
  - `files` NamingPlanFileDTO[], required
    - `ref` string, required
    - `filename` string, required
    - `values` object, nullable
    - `directory` string, nullable
  - `brand_id` integer, nullable
  - `space_id` string, nullable
  - `shared` object, nullable
  - `template_id` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) · [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brandbooster/fastapi/revisions/624917d53409/schema)