---
title: "POST /api/builder/preview/{builder_id}/grant/"
method: POST
path: "/api/builder/preview/{builder_id}/grant/"
tags: ["Builder preview"]
---

# POST /api/builder/preview/{builder_id}/grant/

`POST /api/builder/preview/{builder_id}/grant/`

## Request

- Base URL: `https://api.baserow.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.baserow.io/api/builder/preview/{builder_id}/grant/`
- Auth: HTTP bearer

Start the preview process for a logged-in editor.

This is the only step that uses the editor's normal account login. It makes
sure the editor may read the requested builder before issuing a temporary
preview pass. The returned URL is then opened by the browser to continue
with :class:`BuilderPreviewExchangeView`.

## Path parameters

- `builder_id` string, required

## Request body

- BuilderPreviewGrantRequest
  - `path` string

## Response `200`

- BuilderPreviewGrantResponse
  - `url` string, uri, required

## Other responses

- `404`

## Changes

- **2026-09-30** `e81714236040`: 1 info
  - the endpoint scheme security `UserSource JWT` was removed from the API
- **2026-09-15** `51b737b57ec4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/baserow/apis/baserow-api-spec/changes/api/builder/preview/:builder_id/grant/post.md)

---

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