---
title: "List edit options"
method: GET
path: "/edit-options"
tags: ["Edit options"]
---

# List edit options

`GET /edit-options`

## Request

- Base URL: `https://api.propertypixel.app/v1`
- URL: `https://api.propertypixel.app/v1/edit-options`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://llflgtovnkrsjqydycyu.supabase.co/auth/v1/oauth/authorize`, token URL `https://llflgtovnkrsjqydycyu.supabase.co/auth/v1/oauth/token`)

List every edit PropertyPixel can make, with the exact keys to pass to other tools: enhancement types for enhance_photos (combinable, e.g. blue_skies + improve_lighting), design styles and variation limits for stage_photos, room types, Photo to Video settings for create_video (1–9 photos; one makes a clip, several make a Listing Tour), the Ultra HD add-on, and credit prices. Call this when the user asks what you can do, or before choosing keys you are unsure of.

Works with view-only access.

## Response `200`

List edit options

- EditOptions
  - `object` 'edit_options', required
  - `enhancement_types` object[], required: Edits for enhance_photos. Combine several in one request; the price is per photo, not per type.
    - `key` string, required
    - `label` string, required
    - `description` string, required
    - `preview_url` string, uri, required
  - `design_styles` object[], required: Furniture styles for stage_photos.
    - `key` string, required
    - `label` string, required
    - `description` string, required
    - `preview_url` string, uri, required
  - `room_types` object[], required: Room labels; staging furnishes the room as this type.
    - `key` string, required
    - `label` string, required
  - `staging` object, required
    - `min_variations` integer, required
    - `max_variations` integer, required
    - `default_variations` integer, required
  - `video` object, required
    - `min_photos` integer, required
    - `max_photos` integer, required
    - `clip_seconds` integer[], required: Allowed seconds per photo.
    - `default_clip_seconds` integer, required
    - `aspect_ratios` string[], required: `auto` matches the first photo's orientation.
    - `default_aspect_ratio` string, required
    - `crossfade_seconds` number, required
  - `ultra_hd` object, required
    - `description` string, required
    - `credits_per_photo` integer, required
  - `credit_costs` object, required: Credits per unit. 100 credits = one standard photo enhancement.
    - `enhancement_per_photo` integer, required
    - `ultra_hd_per_photo` integer, required
    - `staging_per_variation` integer, required
    - `video_per_photo` integer, required
    - `recommendation_apply_per_photo` integer, required
    - `recommendations` integer, required: Getting recommendations is free.

## Other responses

- `400`: The request is invalid. Codes: `validation_failed`.
- `401`: Missing, invalid or revoked credential. Codes: `unauthorized`.
- `403`: The credential can't do this. View-only connections get forbidden_scope on writes. Codes: `forbidden_scope`, `forbidden`.
- `404`: The resource doesn't exist in this workspace. Codes: `not_found`.
- `429`: Too many requests for this connection. Codes: `rate_limited`.
- `500`: Something failed on our side. Retry later. Codes: `internal`.

---

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