Marketplace — APIs

Generated from the architecture model

This page is rendered from model/**/*.yaml by tools/docs_model during mkdocs build. Edit the YAML, not this page; hand-written design lives on the linked service, platform and plane pages.

LicenseService

REST (public endpoints need a scope; every call carries trusted tenant and project scope)

Method	Path	Operation	Scope	Side effects	Idempotency	Gateway	Summary
GET	/factory/marketplace/listings/{listingId}/pricing	GetPricing	factory.marketplace.read	read	natural	GW-03	Pricing plans of a listing with the caller's edition applied.
PUT	/factory/marketplace/listings/{listingId}/pricing	SetPricing	factory.marketplace.publish	shared-write	natural	GW-03	Set a pricing plan (publisher; public plans reviewed by Platform admin).
POST	/factory/marketplace/listings/{listingId}/acquire	AcquireListing	factory.marketplace.acquire	spend	key-header	GW-03	Acquire an entitlement against the tenant's Factory subscription (spend class above the threshold needs an approval).
GET	/factory/marketplace/entitlements	ListEntitlements	factory.marketplace.read	read	natural	GW-03	The tenant's entitlements with state, validity and terms.
POST	/factory/marketplace/publishers	ApplyAsPublisher	factory.marketplace.publish	shared-write	key-header	GW-03	Apply for publisher certification (agreement, identity).
POST	/factory/marketplace/publishers/{publisherId}/certify	CertifyPublisher	factory.marketplace.admin	publication	natural	GW-03	Certify or suspend a publisher (Platform admin; publication class).
POST	/factory/marketplace/listings/{listingId}/reviews	ReviewListing	factory.marketplace.read	shared-write	natural	GW-03	Rate and review a listing the tenant is or was entitled to.

gRPC (code-first, internal)

gRPC service	Method	Streaming	Visibility	Side effects	Summary
Licensing	CheckEntitlement	none	internal	read	Is the tenant entitled to install or use a listing now?

MarketplaceCatalogService

REST (public endpoints need a scope; every call carries trusted tenant and project scope)

Method	Path	Operation	Scope	Side effects	Idempotency	Gateway	Summary
GET	/factory/marketplace/listings	SearchListings	factory.marketplace.read	read	natural	GW-03	Search and browse listings by kind, text, compatibility with the caller's edition and template versions, publisher and rating.
GET	/factory/marketplace/listings/{listingId}	GetListing	factory.marketplace.read	read	natural	GW-03	One listing with release, evidence, provenance, compatibility, dependencies, pricing and documents.
POST	/factory/marketplace/listings	CreateListing	factory.marketplace.publish	shared-write	key-header	GW-03	Create a Draft listing for a Published release (certified publisher).
POST	/factory/marketplace/listings/{listingId}/submit	SubmitListing	factory.marketplace.publish	publication	natural	GW-03	Submit for review; public visibility needs Platform admin approval (publication class).
POST	/factory/marketplace/listings/{listingId}/install	InstallListing	factory.marketplace.install	shared-write	key-header	GW-03	Install into the caller's tenant or project: entitlement check, policy check, scoped release reference.
GET	/factory/marketplace/installations	ListInstallations	factory.marketplace.read	read	natural	GW-03	Installations in scope with available updates.
DELETE	/factory/marketplace/installations/{installationId}	RemoveInstallation	factory.marketplace.install	shared-write	natural	GW-03	Remove the scoped reference (runs using it keep their pinned snapshots).

gRPC (code-first, internal)

gRPC service	Method	Streaming	Visibility	Side effects	Summary
Catalog	ResolveListing	none	internal	read	Resolve a listing to its Published release for the agent card and A2A discovery (ADR-0023).

MarketplaceHost

REST (public endpoints need a scope; every call carries trusted tenant and project scope)

Method	Path	Operation	Scope	Side effects	Idempotency	Gateway	Summary
GET	/marketplace/health	MarketplaceHealth	factory.health.read	read	natural	GW-01	Liveness, readiness and dependency health (marketplace store, asset publication, commercial, SaaS foundations).