Skip to main content
Connect establishes the grant; Product API Listing operations manage the resource.
  1. Confirm the linked AI is active and request listings:read or listings:write only when the feature needs it.
  2. Call /ais/{aiId}/listings with the user’s OAuth access token. The path AI must be covered by the live grant.
  3. Preserve returned revisions and send expectedRevision for updates.
  4. When making a Listing private, select permitted Darwin AI IDs. Application users or application IDs are not Listing principals.
  5. Use cursor pagination and filters for owner catalogs. Use bounded batch upserts for production synchronization. Durable CSV and Shopify import jobs are preview while streaming and source reconciliation roll out.
  6. Handle revocation, revision conflicts, import status, and archived upstream items as ordinary states.
The linked AI owns every Listing and source connection. Unlinking the application removes access but does not delete or privatize the catalog. A later authorized client sees the same Listings and revisions.

Product API · Manage Listings

Follow the canonical create, update, lifecycle, and import rules.