---
title: "Bootstrap a workspace (upload-first flows)"
method: POST
path: "/workspaces"
tags: ["Workspace"]
---

# Bootstrap a workspace (upload-first flows)

`POST /workspaces`

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `name` string

## Response `201`

The created workspace.

- Workspace
  - `object` 'workspace', required
  - `id` string, uuid, required
  - `name` string, required
  - `createdByApi` boolean, required — True when the workspace was created through the API (upload-first bootstrap or agent auto-create).
  - `url` string, uri, required — Deep link a human can open.
  - `createdAt` string, date-time, required

## Other responses

- `403` — WORKSPACE_LIMIT_REACHED (carries an upgrade-plan handoff).

---

[API](https://skmtc.net/origami/apis/origami-agent-api.md) · [All operations](https://skmtc.net/origami/apis/origami-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/origami/origami-agent-api/versions/8083ad7fe081/schema)