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

# Launch admin UI

> Mint a one-time signed URL into the managed ad-server source admin UI

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

Mints a single-use signed URL that drops the caller into the upstream managed-source admin UI. Pass an optional deep-link `path` to land on a specific page.

## Request

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.interchange.io/api/v2/storefront/inventory-sources/retail-gam/launch \
    -H "Authorization: Bearer $SCOPE3_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{ "path": "/products" }'
  ```

  ```json Land on home theme={null}
  {}
  ```
</CodeGroup>

## Parameters

| Field      | Type          | Required | Notes                                                                                                                                 |
| ---------- | ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `sourceId` | string (path) | Yes      | Storefront-scoped inventory source ID                                                                                                 |
| `path`     | string        | No       | Managed-source-relative deep-link path (e.g. `/products`, max 2048). No schemes and no `..` segments. Omit to land on the source home |

## Response

```json theme={null}
{
  "url": "https://retail-gam.esa.interchange.io/launch?token=eyJ..."
}
```

The `url` is single-use and short-lived — redirect immediately. Do not store or share it.

## Errors

* `400 VALIDATION_ERROR` — `path` contains a scheme or `..` segment.
* `401 UNAUTHORIZED` — missing or invalid API key.
* `404 NOT_FOUND` — no ad-server-backed source with this `sourceId`.

See [Errors](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Inventory source tasks" href="/v2/storefront/inventory-sources/tasks" icon="list-check">
    All operations
  </Card>

  <Card title="Get status" href="/v2/storefront/inventory-sources/tasks/get-status" icon="heart-pulse">
    Operational snapshot
  </Card>

  <Card title="Get ad-server connection" href="/v2/storefront/inventory-sources/tasks/get-ad-server-connection" icon="server">
    Connection state
  </Card>

  <Card title="Test connection" href="/v2/storefront/inventory-sources/tasks/test-connection" icon="plug-circle-check">
    Probe upstream reachability
  </Card>
</CardGroup>