---
title: "Studio Photo"
method: POST
path: "/v1/apps/{listing_id}/studio/photo"
tags: ["asc-studio"]
---

# Studio Photo

`POST /v1/apps/{listing_id}/studio/photo`

## Request

- Base URL: `https://api.theagentc.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.theagentc.io/v1/apps/{listing_id}/studio/photo`
- Auth: HTTP bearer

Auto-Direct lifestyle hero photo. Optionally crops the app's mascot
from one of the listing's own screenshots and passes it as a reference so
the character appears in the photo. Free; shares the studio fal limiter.

## Path parameters

- `listing_id` string, uuid, required

## Request body

- StudioPhotoRequest: POST /v1/apps/{listing_id}/studio/photo — Auto-Direct lifestyle hero. `mascot` optionally names one of the listing's own uploaded screenshots + a box to crop a character from, so it can appear in the photo.
  - `scene` string, required
  - `mascot_screen` string, nullable
  - `mascot_box` number[], nullable
  - `wide` boolean

## Response `200`

Successful Response

- StudioPhotoResponse
  - `url` string, required
  - `cached` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/theagentc/apis/the-agent-c-api.md) · [All operations](https://skmtc.dev/theagentc/apis/the-agent-c-api/llms.txt) · [OpenAPI document](https://skmtc.dev/theagentc/apis/the-agent-c-api/revisions/1c9868b44584?raw)