---
title: "Patch One"
method: PATCH
path: "/v2/studio/sessions/{session_id}"
tags: ["studio"]
---

# Patch One

`PATCH /v2/studio/sessions/{session_id}`

## Request

- Base URL: `https://api.etymolt.com`
- URL: `https://api.etymolt.com/v2/studio/sessions/{session_id}`
- Auth: none declared

## Path parameters

- `session_id` string, required

## Request body

- PatchSessionReq: Patch one stage's state. Server appends an event; client sees new fold.
  - `stage` 'welcome' | 'discovery' | 'mood' | 'sound' | 'already_loved' | 'generate' | 'reveal' | 'iterate' | 'decide' | 'take_home': The 9 stages of the co-creation flow.
  - `discovery` DiscoveryAttributes: Structured attributes extracted from the founder's voice/text intake.
    - `audience` string, nullable
    - `category` string, nullable
    - `tone` string[]
    - `must_avoid` string[]
    - `founder_loved_names` string[]
    - `founder_killed_names` string[]
    - `voice_transcript` string, nullable
    - `voice_audio_url` string, nullable
  - `mood` MoodBoard
    - `selected_image_ids` string[]
    - `inferred_archetypes` string[]
  - `sound` SoundSymbolismProfile: Five 0..1 sliders mapping into the generator's prompt vector.
    - `sharp_soft` number
    - `bright_dark` number
    - `light_heavy` number
    - `fast_slow` number
    - `modern_timeless` number
  - `loved` LovedNamesInput
    - `records` LovedNameRecord[]
      - `name` string, required
      - `sentiment` 'loved' | 'killed' | 'considered'
      - `reason` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/etymolt/apis/etymolt-verify-ai-generated-brand-names.md) · [All operations](https://skmtc.dev/etymolt/apis/etymolt-verify-ai-generated-brand-names/llms.txt) · [OpenAPI document](https://skmtc.dev/etymolt/apis/etymolt-verify-ai-generated-brand-names/revisions/7228ffa1efa7?raw)