> ## Documentation Index
> Fetch the complete documentation index at: https://docs.darwin.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Listings

> Manage a linked AI's catalog through Product API operations and a live Connect grant.

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.

<Card title="Product API · Manage Listings" href="/product/workflows/manage-listings">
  Follow the canonical create, update, lifecycle, and import rules.
</Card>