---
title: "POST /api/builder/preview/handoff/"
method: POST
path: "/api/builder/preview/handoff/"
tags: ["Builder preview"]
---

# POST /api/builder/preview/handoff/

`POST /api/builder/preview/handoff/`

## 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/handoff/`
- Auth: none required

Let the preview Nuxt server consume an opaque one-time handoff code.

## Request body

- BuilderPreviewHandoffRequest
  - `preview_handoff` string, required
  - `builder_id` integer, required

## Response `200`

- BuilderPreviewHandoffResponse
  - `preview_session` string, required
  - `expires_in` integer, required
  - `builder_id` integer, required

## Other responses

- `404`: No response body

## Changes

- **2026-09-15** `51b737b57ec4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/baserow/apis/baserow-api-spec/changes/api/builder/preview/handoff/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)