Signed render links

urlbox link produces a signed Urlbox render URL on your machine. No API call is made and no credit is spent. The image is only rendered when someone actually loads the URL, which makes signed links ideal for embedding in templates, emails, dashboards or static sites.

Basic usage

urlbox link https://example.com

This prints a ready-to-use URL you can drop straight into an <img> tag or a template.

With options

To set render options, pass them as JSON and choose a format:

urlbox link --json '{"url":"https://example.com","width":1920,"full_page":true}' --format png

The JSON accepts the same options as a render.

Requirements

link needs both your publishable API key and your API secret. The signature is computed from your options using the secret. urlbox login stores both automatically. If you authenticate with the URLBOX_API_SECRET env var alone, add the key with --api-key <key>, or store it once with urlbox config set api_key <key>. The publishable key is shown on your project dashboard and is distinct from the secret.

Want the rendered image itself, not a URL to it? Use urlbox render instead. link only builds the signed URL and never fetches the image.