Update a draft listing

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.

patch/listings/draft/{id}

Request

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

Path parameters

idstring uuid required

Request body

titlestring
descriptionstring
categorystring
price_centsinteger

Price in integer cents. Mutually exclusive with price.

pricenumber

Price in USD. Mutually exclusive with price_cents.

pricing_type'free' | 'buy_it_now' | 'auction' | 'hybrid'
tagsstring[]
licensestring nullable

Optional custom reuse terms or license name; blank with no license_url selects Open Use only after explicit terms acceptance.

tos_confirmedboolean

Explicit supplier acceptance; required when changing active reuse terms.

listing_terms_version'2026-10-09'
schemaobject

Data schema. Always declare schema.format (csv, json, zip, …) — the stored path has no extension.

full_data_pathstring

Set after uploading the full dataset. Automatically triggers sample generation.

Response

Updated draft

Changes

No recorded changes to this operation across all 1 revision of this API.