---
title: "Claim a sandbox Form into the active organization"
method: POST
path: "/v1/sandboxes/{id}/claim"
tags: ["forms"]
---

# Claim a sandbox Form into the active organization

`POST /v1/sandboxes/{id}/claim`

## Request

- Base URL: `https://postbag.dev`
- URL: `https://postbag.dev/v1/sandboxes/{id}/claim`
- Auth: HTTP bearer

Requires both an authenticated manage-scoped actor and the sandbox capability in Postbag-Sandbox-Token. The Form id and submit URL remain unchanged.

## Path parameters

- `id` string, required

## Headers

- `postbag-sandbox-token` string, required: The sandbox token returned at creation.

## Response `200`

claimed or idempotently returned

- object
  - `claimed` true, required
  - `idempotent` boolean, required
  - `form` object, required
    - `id` string, required
    - `project_id` string, required
    - `slug` string, required
    - `name` string, required
    - `submit_url` string, required
  - `copied_test_submissions` integer, required
  - `next` object[], required
    - `why` string, required
    - `method` string, required
    - `path` string, required
    - `body` object

## Other responses

- `401`: Invalid sandbox capability
- `402`: Target organization Form limit reached
- `403`: Claim email mismatch
- `410`: Expired or consumed

---

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