Create Workspace

curl -sS -X POST https://app.opentrain.ai/api/public/v1/instructions/workspaces \
  -H "Authorization: Bearer $OT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ws-create-$(uuidgen)" \
  -d '{"name": "Operations"}'

{
  "workspace": {},
  "idempotentReplay": true
}

POST

api

public

instructions

workspaces

curl -sS -X POST https://app.opentrain.ai/api/public/v1/instructions/workspaces \
  -H "Authorization: Bearer $OT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ws-create-$(uuidgen)" \
  -d '{"name": "Operations"}'

{
  "workspace": {},
  "idempotentReplay": true
}

Creates a workspace: the permission boundary that owns manuals, assets, changesets, and per-user roles. OpenTrain persists an OWNER permission record for the creator. Requirements: instructions:write + a verified (claimed) account whose user belongs to an employer organization. A verified user without employer membership receives 403.

Request

Send an optional Idempotency-Key header — replaying the same key returns the original workspace with idempotentReplay: true; replaying the key with a different body is a 409.

string

required

Workspace display name.

Response

Returns 201 with the created workspace.

object

{id, name, manualCount, archivedAt, createdAt, updatedAt}.

boolean

Present and true when the Idempotency-Key matched a prior create.

curl -sS -X POST https://app.opentrain.ai/api/public/v1/instructions/workspaces \
  -H "Authorization: Bearer $OT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ws-create-$(uuidgen)" \
  -d '{"name": "Operations"}'

⌘I

Getting started

Connect your agent

Core concepts

Guides

API reference

CLI

MCP server

Annotation platforms

Request

Response

​Request

​Response

Request

Response