---
title: "Create private workspace. Owner recovery secret returned once; keep it out of Agent context."
method: POST
path: "/api/auth/create"
---

# Create private workspace. Owner recovery secret returned once; keep it out of Agent context.

`POST /api/auth/create`

## Request

- Base URL: `https://human4ai.ai`
- URL: `https://human4ai.ai/api/auth/create`
- Auth: none required

## Request body

- object
  - `name` string, required

## Response `200`

Successful operation; single resource or {items,nextCursor} for lists.

## Other responses

- `201`: Created resource, or the original resource on an idempotent replay.
- `400`: Structured error; see error.code. Cross-workspace IDs also return 404.
- `401`: Structured error; see error.code. Cross-workspace IDs also return 404.
- `403`: Structured error; see error.code. Cross-workspace IDs also return 404.
- `404`: Structured error; see error.code. Cross-workspace IDs also return 404.
- `409`: Structured error; see error.code. Cross-workspace IDs also return 404.
- `413`: Structured error; see error.code. Cross-workspace IDs also return 404.
- `415`: Structured error; see error.code. Cross-workspace IDs also return 404.
- `429`: Structured error; see error.code. Cross-workspace IDs also return 404.
- `503`: Structured error; see error.code. Cross-workspace IDs also return 404.

---

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