---
title: "Create a provisional workspace for agent-first setup"
method: POST
path: "/v1/bootstrap/workspace"
tags: ["Bootstrap"]
---

# Create a provisional workspace for agent-first setup

`POST /v1/bootstrap/workspace`

Creates a provisional workspace, setup member, starter skill, and short-lived claim links without requiring an email account first.

## Request body

- object
  - `workspaceName` string, required
  - `skillName` string
  - `devicePublicKey` string
  - `claimRoles` string[]
  - `ownerEmail` string, email
  - `teammateEmails` string[]

## Response `200`

Workspace bootstrap completed.

- object
  - `ok` true, required
  - `organization` object, required
    - `id` string, typeid, required — Den TypeID with 'org_' prefix and a 26-character base32 suffix.
    - `name` string, required
    - `slug` string, required
    - `status` 'provisional', required
  - `setup` object, required
    - `id` string, typeid, required — Den TypeID with 'wbt_' prefix and a 26-character base32 suffix.
    - `expiresAt` string, required
  - `skill` object, required
    - `id` string, typeid, required — Den TypeID with 'cob_' prefix and a 26-character base32 suffix.
    - `title` string, required
    - `output` 'OPENWORK_BOOTSTRAP_SKILL_TRIGGERED', required
  - `claimLinks` object[], required
    - `id` string, typeid, required — Den TypeID with 'wcl_' prefix and a 26-character base32 suffix.
    - `role` string, required
    - `token` string, required
    - `url` string, required
    - `expiresAt` string, required

## Other responses

- `400` — The bootstrap request body was invalid.

## Changes

- **2026-08-20** `93df40e2efd5` — 4 info
  - the `claimLinks/items/id` response's property pattern `^wcl_.*` was removed for the status `200`
  - the `organization/id` response's property pattern `^org_.*` was removed for the status `200`
  - the `setup/id` response's property pattern `^wbt_.*` was removed for the status `200`
  - the `skill/id` response's property pattern `^cob_.*` was removed for the status `200`

[Change history](https://skmtc.dev/openworklabs/apis/den-api/changes/v1/bootstrap/workspace/post.md)

---

[API](https://skmtc.dev/openworklabs/apis/den-api.md) · [All operations](https://skmtc.dev/openworklabs/apis/den-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openworklabs/den-api/revisions/93df40e2efd5/schema)