---
title: "Edit your listing"
method: PATCH
path: "/api/v1/listings/{id}"
---

# Edit your listing

`PATCH /api/v1/listings/{id}`

## Request

- Base URL: `https://traydstar.com`
- URL: `https://traydstar.com/api/v1/listings/{id}`
- Auth: HTTP bearer

Scope: propose. Only the fields sent change. A listing that is part of a trade in progress is frozen (409). Changing stated_value_usd appends to the value history. Images can't be changed here.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `title` string
  - `description` string
  - `type` 'GOOD' | 'SERVICE' | 'BOTH'
  - `category` string
  - `subcategory` string, nullable
  - `condition` 'NEW' | 'LIKE_NEW' | 'GOOD' | 'FAIR' | 'POOR' | 'null', nullable
  - `want_tags` string[]
  - `want_description` string, nullable
  - `stated_value_usd` number

## Response `200`

{ success, listing_id }

## Other responses

- `400`: Invalid field, or a field that can't be changed.
- `404`: Not your listing.
- `409`: Traded, or part of a trade in progress.
- `default`: Error.

---

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