Skip to main content
POST
Create Project

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Payload for creating a project.

A project is a workspace-scoped container that groups skills, agents, MCP server instances, and uploaded files under a shared identity and optional parent project.

name
string
required

Human-readable project name (unique per workspace).

Required string length: 1 - 255
description
string | null

Short summary of the project's purpose.

Maximum string length: 1000
instructions
string | null

System-level instructions or notes shared across the project's agents.

Maximum string length: 20000
parent_project_id
string | null

UUID of the parent project, if this is a sub-project.

Response

Successful Response

created_by
string
required
description
string | null
required
id
string<uuid>
required
instructions
string | null
required
name
string
required
parent_project_id
string | null
required
workspace_id
string
required
agents
ProjectAgentRef · object[]
mcp_instances
ProjectMcpInstanceRef · object[]
skills
ProjectSkillRef · object[]