Skip to main content
A curator storefront can sell inventory that belongs to another storefront. It links that storefront as a linked partner source. When a buyer brief reaches the curator, the curator forwards it to the partner and returns the partner’s products. The curator does not copy the partner’s catalog. Linked partner sources are in a pilot. They work only for storefronts that Apostra has enabled them for. For any other storefront, linking and activating are refused with FEATURE_NOT_ENABLED. Name the seller whose inventory you want:
Send that to save_inventory_source. It creates a source in the PENDING state and returns it. The source belongs to your own storefront: you cannot name an owner. Linking the same partner again returns the source that already exists. The partner seller must already have approved your storefront’s account as a buyer on their storefront. The partner does this in their own account, the same way a seller approves any buyer. Without that approval the call answers NOT_FOUND, exactly as it does for a storefront that does not exist, so a curator cannot learn whether a storefront exists without its approval. A pending source is not selected for buyer briefs and cannot be booked.

Activate it

Activating does two things in one call: it sets the source’s terms, then turns it on. You can also send sellerId and status: "ACTIVE" together to link and activate at once. A source that is already active is returned unchanged. Activation checks the partner seller’s approval again. If the partner has withdrawn it since you linked, activation is refused, the source stays PENDING and the answer says why. Ask the partner seller to approve you again, then send the same call again.

The terms

The terms are fixed and you do not enter them: Because nothing can be chosen, there is no separate call to set terms. They are set when the source is activated.

Turn it off

A disabled source is no longer offered for new briefs or bookings. To turn it back on, activate it again.

Read where it stands

get({ "kind": "inventory_source", "id": "linked-storefront:9001" }) returns linkedSeller: connection.nextStep names the next action for the state the source is in.