Skip to main content
POST
Create project

Authorizations

Authorization
string
header
required

API key authentication. Pass your key as a Bearer token. Keys use the format hm_live_<32 hex chars>. Generate keys from your Harmonica dashboard settings.

Body

application/json
title
string
required

Project (workspace) title.

Maximum string length: 200
description
string | null

Optional project description (markdown).

Maximum string length: 2000
project_type
enum<string>

Project type, set at creation only and immutable afterwards. Omit for a standard project. A type governs behaviour (visibility, participation, which artifacts and public surfaces the project gets), not just labelling, so there is no conversion path between types.

Available options:
broad-listening,
team-os

Response

Project created

id
string<uuid>
required
title
string
required
status
string
required

Project lifecycle status (active, draft, deleted).

is_public
boolean
required
created_at
string<date-time>
required
description
string | null