Skip to main content
POST
Create a workspace

Authorizations

Authorization
string
header
required

A dashboard session — the short-lived JWT a signed-in human holds at the dashboard, sent on the same Authorization: Bearer header. Dispatched by shape: a session token is a JWT, an API key starts with ck_. Sessions cannot be created through this API, and operations that list only this scheme refuse API keys with 401.

Body

application/json
email
string<email>
required

The signer's verified email, asserted by the dashboard server from the Clerk profile.

Maximum string length: 255
name
string

Workspace display name. Defaults from the email's local part when omitted.

Required string length: 1 - 120

Response

Workspace created. The key is shown here and never again.

A fresh workspace and its first test key.

workspace
object
required
apiKey
string
required

A ck_test_ key, shown exactly once — only its SHA-256 hash is stored. Losing it means minting a new one.