API reference

Connect your stack

Collecta is the operating system for serious art collections. The core journey is Sign up -> Import artwork -> Enrich metadata -> Place & share -> Invite partners -> Transact.

Core endpoints

View live API explorer
Analyze artworkPOST

/api/collection/analyses

Create or enrich a collector artwork record from uploaded images and collection notes.

Save room configurationPOST

/api/collection/room-configs

Persist wall and placement data for private room previews, saved layouts, and share links.

Create orderPOST

/api/orders

Submit a collector order generated from listings, offers, or direct partner workflows.

Current event surface

Request signing secrets

  • order.created

    Triggered when a collector workflow produces a new partner-facing order.

  • order.status_changed

    Triggered as a partner advances an order through fulfillment milestones.

  • inventory.updated

    Legacy compatibility event used by invited partner inventory syncs.

Collector-first mode

Legacy kiosk and optical endpoints are hidden by default. SetNEXT_PUBLIC_ENABLE_LEGACY_PRODUCT_SURFACES=1to expose compatibility docs during migrations.