Skip to main content
POST
cURL

Authorizations

Authorization
string
header
default:dav_ak_live_your_token
required

Personal access token. The scopes granted at issuance determine both which operations the key may call and the ceiling on the resource permissions it can exercise. Each scope family is a ladder: projects:manage implies projects:write and projects:read; cards:manage implies cards:write and cards:read; and teams:manage implies teams:write and teams:read. These are named API capability bundles, not blanket domain roles: manage exposes only the permissions enumerated for that scope and never bypasses the acting user's current role-based access.

Headers

Idempotency-Key
string

A value you choose to identify this request, so that retrying it does not repeat its effect. Reuse the same key when retrying and the original result is returned; use a fresh key when you mean to create something new. Keys are scoped to the API key that sent them (or to the user for browser sessions). Replayed responses include Idempotency-Replayed: true.

Maximum string length: 255

Body

application/json
name
string

Required unless initialPrompt is supplied.

initialPrompt
string

Staged as the creator's first agent message when a client connects.

Maximum string length: 4000
description
string
orgId
string | null

Create the project under an organization instead of the calling user.

visibility
enum<string>
default:private
Available options:
private,
internal,
public
autoName
boolean
default:false

Derive the project name from initialPrompt.

skipInitialCommit
boolean
default:false

Response

Project created.

id
string
required
projectSlug
string | null
ownerSlug
string | null