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

# Configure linked storefront source terms

> Set the pilot pass-through terms required before activation

`POST /api/v2/storefront/inventory-sources/{sourceId}/configure-terms`

Set the fixed pass-through terms for a pending, active, or disabled linked
storefront source. This pilot uses `pass_through`: the buyer price equals the
partner price, your retained share is 0%, and supplier settlement happens
outside the platform. The buyer-payment collector comes from the buyer
account's approved billing setting for the selected seller account on your
storefront and is recorded when a booking is made. This is separate from the
partner's consent for your storefront to buy from it.

This operation keeps the current source status. Configuring a disabled source
does not reactivate it; use
[Activate linked storefront source](/v2/storefront/inventory-sources/tasks/activate-linked-source)
to reactivate it with the latest terms version. Archived sources cannot be
configured.

To receive briefs and bookings, your partner storefront must be listed in the
marketplace and not paused. The partner sees your storefront as the buyer for
linked requests. Your buyer's account stays on your own booking and is not sent
to the partner.

## Request

```bash theme={null}
curl -X POST https://api.apostra.com/api/v2/storefront/inventory-sources/linked-storefront:42/configure-terms \
  -H "Authorization: Bearer $SCOPE3_API_KEY"
```

| Field | Type | Required | Notes |
| - | - | - | - |
| `sourceId` | string (path) | Yes | The linked storefront source ID in your storefront |

The request body is empty. Terms are fixed for this pilot and cannot be supplied
or overridden in the request.

## Response

`200 OK` returns the updated `InventorySourceResponse`.

| Field | Type | Meaning |
| - | - | - |
| `sourceId` | string | The linked storefront source ID |
| `executionType` | string | `LINKED_STOREFRONT` |
| `status` | string | Keeps its current `PENDING`, `ACTIVE`, or `DISABLED` status |
| `linkedStorefrontTarget.lifecycleStatus` | string | The linked-source lifecycle state |
| `linkedStorefrontTarget.selectable` | boolean | `true` only when the source is active with configured terms, partner consent remains current, and routing is enabled for a pilot storefront |
| `linkedStorefrontTarget.activationRequirements` | array | Work still required before activation |

Each successful change creates a new terms version. Existing bookings keep the
terms recorded when they were booked. A later activation uses the latest terms
version.

## Availability and errors

This pilot requires the `linked-partner-sources` feature flag.

* `403 FEATURE_NOT_ENABLED` - the pilot is not enabled for your storefront.
* `400 VALIDATION_ERROR` - the source is not a linked storefront source.
* `401 UNAUTHORIZED` - the request is not authenticated.
* `404 NOT_FOUND` - no source with this `sourceId` exists in your storefront,
  including an archived source.

## Related

<CardGroup cols={2}>
  <Card title="Activate linked storefront source" href="/v2/storefront/inventory-sources/tasks/activate-linked-source" icon="circle-check">
    Activate after terms are configured
  </Card>

  <Card title="Inventory sources overview" href="/v2/storefront/inventory-sources/overview" icon="plug">
    Lifecycle and pass-through terms
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.