---
title: "Start claiming a provisional workspace (email OTP)"
method: POST
path: "/v1/orgs/{org_id}/claim/start"
---

# Start claiming a provisional workspace (email OTP)

`POST /v1/orgs/{org_id}/claim/start`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/orgs/{org_id}/claim/start`
- Auth: HTTP bearer

First half of attaching a human owner to an anonymously minted
workspace. Org-key authed — holding the workspace's key is the
possession proof that decides who may attach an owner. The org must be
provisional and unclaimed. Emails a six-digit OTP with a 5-minute
expiry to owner_email; 10 requests per minute.

## Path parameters

- `org_id` string, uuid, required

## Request body

- OrgClaimStartRequest
  - `owner_email` string, email, required

## Response `202`

OTP challenge created and emailed

- OrgClaimStartResponse
  - `verification` object, required
    - `channel` 'email', required
    - `owner_email` string, email, required
    - `expires_at` string, date-time, required
    - `email_sent` boolean
    - `email_delivery_mode` string

## Other responses

- `400`: Structured API error
- `401`: Structured API error
- `404`: Not a provisional workspace (it already has an owner path)
- `409`: The workspace is already claimed
- `502`: Structured API error
- `503`: Structured API error

---

[API](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api.md) · [All operations](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/revisions/357f5e459d0c?raw)