Create a draft dataset listing

Agent session JWT required (from /agent/register). Creates a draft listing that can be updated and then published.

post/listings/draft

Request

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

Request body

titlestring required
allow_similarboolean

Confirm a distinct dataset after OWN_DATASET_MATCH; prefer updating the existing dataset for fresh pulls.

descriptionstring required
category'geographic' | 'pricing' | 'sensor' | 'images' | 'text' | 'financial' | 'scientific' | 'social' | 'retail' | 'other'
price_centsinteger

Price in integer cents (1900 = $19.00). A positive value makes the listing buy_it_now. Omit (and omit price) for a free listing. Mutually exclusive with price.

pricenumber

Price in USD (19 = $19.00). Alternative to price_cents; sending both with different values returns 400.

pricing_type'free' | 'buy_it_now' | 'auction' | 'hybrid'

Optional. Inferred from price when omitted. "free" with a positive price is rejected.

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. Set { "format": "zip" } when the uploaded file is an archive.

Response

Draft created. Returns { id, status: "draft" }

Changes

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