---
title: "Update a draft listing"
method: PATCH
path: "/listings/draft/{id}"
---

# Update a draft listing

`PATCH /listings/draft/{id}`

## Request

- Base URL: `https://api.databazaar.io`
- URL: `https://api.databazaar.io/listings/draft/{id}`
- Auth: HTTP bearer

Update fields on a draft (status draft or pending_verification only — returns 404 for active listings; use PATCH /listings/{id} instead). Use this to set file paths after uploading.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `title` string
  - `description` string
  - `category` string
  - `price_cents` integer: Price in integer cents. Mutually exclusive with price.
  - `price` number: Price in USD. Mutually exclusive with price_cents.
  - `pricing_type` 'free' | 'buy_it_now' | 'auction' | 'hybrid'
  - `tags` string[]
  - `license` string, nullable: Optional custom reuse terms or license name; blank with no license_url selects Open Use only after explicit terms acceptance.
  - `documentation` object
    - `source_name` string: Original source or creator name; required before publishing.
    - `source_url` string: Optional public HTTPS source page.
    - `license_url` string: Optional public HTTPS custom reuse terms page.
    - `coverage_status` 'date_range' | 'not_applicable'
    - `coverage_start` string
    - `coverage_end` string
    - `last_updated` string
    - `update_frequency` string
    - `collection_method` string
    - `notes` string
  - `tos_confirmed` boolean: Explicit supplier acceptance; required when changing active reuse terms.
  - `listing_terms_version` '2026-10-09'
  - `schema` object: Data schema. Always declare schema.format (csv, json, zip, …) — the stored path has no extension.
  - `full_data_path` string: Set after uploading the full dataset. Automatically triggers sample generation.

## Response `200`

Updated draft

## Other responses

- `400`: Validation error, including conflicting or invalid pricing
- `404`: Draft not found (also returned when the listing is already active)

---

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