---
title: "Coming soon. Mint a single-use connect URL for /v1/browser"
method: POST
path: "/v1/browser/token"
tags: ["Browser"]
---

# Coming soon. Mint a single-use connect URL for /v1/browser

`POST /v1/browser/token`

## Request

- Base URL: `https://api.spicrawl.com`
- URL: `https://api.spicrawl.com/v1/browser/token`
- Auth: HTTP bearer

Coming soon.
Returns a `/v1/browser` URL that carries a short-lived token instead of the API key, for CDP clients
that accept only a URL. The key goes in the `Authorization` header of THIS request only (a query key
is refused). The token is single-use, expires after 60 s, and is bound to the options in the body:
connect with the URL unchanged. `path` is authoritative: the URL relative to the API base. `url` is
built from the deployment's SPICRAWL_BROWSER_PUBLIC_URL when set, otherwise from this request's scheme and
Host header (caller-controlled, a convenience only). The token is
never logged and never stored in plaintext. Requires the `browser` scope.

## Request body

- object: The options `GET /v1/browser` accepts, validated the same way. All optional.
  - `engine` 'browser' | 'js'
  - `proxy_country` string
  - `proxy_region` string
  - `sticky_key` string
  - `session_ttl` integer
  - `headless` boolean

## Response `200`

The connect URL, sent with Cache-Control no-store.

- object
  - `url` string, required
  - `path` string, required
  - `expires_at` string, date-time, required
  - `expires_in` integer, required
  - `single_use` boolean, required

## Other responses

- `400`: The request is invalid. Not retryable; fix the request using `code` and `diagnostics.hint`.
- `401`: Missing, invalid, revoked or expired key. Not retryable with the same key.
- `403`: The key lacks the scope this route requires (`ERR::AUTH::INSUFFICIENT_SCOPE`), or the action is not permitted.
- `503`: No proxy exit or engine capacity was available. Retryable after `Retry-After`; 0 credits.

---

[API](https://skmtc.dev/spicrawl/apis/spicrawl-api.md) · [All operations](https://skmtc.dev/spicrawl/apis/spicrawl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spicrawl/apis/spicrawl-api/revisions/c4b4c6f97219?raw)