flow

Create Product From URL

Queue and execute product creation from a vendor source URL in api-v1.

FlowStatus: Implemented in api-v1

Overview

This flow documents the active api-v1 create-from-URL path for Product Marketplace.

OpenAPI

  • createProductModelFromUrl
  • createProductModelFromUrlNested
  • createProductFromUrlAlias

Event Path

  • ProductFromUrlRequested
  • ScrapeRunCompleted
  • OrganizationCreated
  • ProductModelCreated

Code References

  • apps/api-v1/src/modules/product-marketplace/core/application/use-cases/ProductCreationUseCases.ts
  • apps/api-v1/src/modules/product-marketplace/core/application/use-cases/ProductFromUrlWorkflowUseCase.ts
  • apps/api-v1/src/modules/product-marketplace/adapters/outbound/scraping/ProductFromUrlScraperAdapter.ts

Parameter persistence

See Parameter Graph Persistence for canonical key/value upsert and variant_parameters linking during bulk creation.

Notes

The request schemas are intentionally permissive today because this is an active api-v1 workflow used by script and Retool callers.