Marketplace

Update Listing

Update an existing marketplace listing.

Modify the title, description, pricing, or license terms of a listing you own. Changes take effect immediately for new purchases.

Authentication Required: Valid API key or JWT token (listing owner only)

Path Parameters:

  • listing_id: UUID of the listing to update

Request Body: Same fields as create — all fields are replaced (not merged).

Restrictions:

  • Listing must belong to your account
  • Cannot update listings tied to anonymous verifications

Status Codes:

  • 200: Listing updated successfully
  • 403: Access denied or anonymous verification restriction
  • 404: Listing not found
put/v1/marketplace/listings/{listing_id}

Request

  • Base URL: https://api.lumethic.com
  • URL: https://api.lumethic.com/v1/marketplace/listings/{listing_id}
  • Auth: OAuth2PasswordBearer (a scheme the document does not define)

Path parameters

listing_idstring uuid required

Headers

X-API-Keystring nullable

Request body

titlestring required
descriptionstring nullable
currency'usd' | 'cad' | 'mxn' | 'eur' | 'gbp' | 'chf' | 'sek' | 'nok' | 'dkk' | 'pln' | 'czk' | 'huf' | 'ron' | 'bgn' | 'aud' | 'nzd' | 'jpy' | 'sgd' | 'hkd' | 'krw' | 'cny' | 'inr' | 'thb' | 'myr' | 'brl' | 'aed' | 'zar' | 'ils'

Supported currencies for marketplace listings and purchases.

Focus on major currencies for EU, US, Australia, and Canada regions, plus other commonly used currencies in photography markets.

price_personal_centsinteger nullable
price_commercial_centsinteger nullable
price_editorial_centsinteger nullable
price_extended_centsinteger nullable
license_terms_personalstring nullable
license_terms_commercialstring nullable
license_terms_editorialstring nullable
license_terms_extendedstring nullable

Example request

{
  "currency": "usd",
  "description": "Authenticated landscape photo taken with Nikon Z9",
  "license_terms_commercial": "Commercial use in marketing materials",
  "license_terms_editorial": "Editorial use in news and publications",
  "license_terms_extended": "Unlimited commercial use including merchandise",
  "license_terms_personal": "Personal use only, no redistribution",
  "price_commercial_cents": 5000,
  "price_editorial_cents": 2000,
  "price_extended_cents": 10000,
  "price_personal_cents": 1000,
  "title": "Sunset over Lake Zurich"
}

Response

Listing updated successfully

idstring uuid required

Unique identifier for the listing

verification_idstring uuid required

ID of the verified photo this listing represents

titlestring required

Display title for the listing

descriptionstring nullable required

Optional description of the photo and its context

is_activeboolean required

Whether the listing is currently available for purchase

currencystring required

ISO 4217 currency code (e.g., 'usd', 'eur', 'chf')

price_personal_centsinteger nullable required

Price in cents for personal use license

price_commercial_centsinteger nullable required

Price in cents for commercial use license

price_editorial_centsinteger nullable required

Price in cents for editorial use license

price_extended_centsinteger nullable required

Price in cents for extended/unlimited use license

license_terms_personalstring nullable required

Terms and restrictions for personal use

license_terms_commercialstring nullable required

Terms and restrictions for commercial use

license_terms_editorialstring nullable required

Terms and restrictions for editorial use

license_terms_extendedstring nullable required

Terms and restrictions for extended use

total_salesinteger required

Total number of licenses sold for this listing

total_revenue_centsinteger required

Total revenue generated in cents

created_atstring required

ISO 8601 timestamp when the listing was created

updated_atstring required

ISO 8601 timestamp when the listing was last modified

Changes

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