Skip to content

Create a project in a workspace

POST
/workspaces/{workspaceId}/projects
import { FloraClient } from '@flora-ai/flora';
const client = new FloraClient({ apiKey: process.env['FLORA_API_KEY'] });
const project = await client.workspaces.projects.create({
workspaceId: '<workspaceId>',
name: 'Spring Campaign',
});
console.log(project);

Creates a new Flora project in the workspace named in the path. Prefer this over POST /projects when a credential can reach more than one workspace: the destination is explicit rather than carried in the body. To file the project into a project folder, use the folder route below. Mutating public API requests support an optional Idempotency-Key header for client retries; duplicate keys within two hours return idempotency_duplicate.

Error responses use the standard error body.

workspaceId
required

Workspace identifier

string
/^ws_\S+$/

Workspace identifier

Media type application/json
object
name
required

Project name

string
>= 1 characters

Project created.

Media type application/json
object
project_id
required

Project identifier

string
/^prj_\S+$/
name
required

Project name

string
workspace_id
required

Workspace identifier

string
/^ws_\S+$/
origin
required
Any of:

Project origin

string
last_modified
required
Any of:
number
created_at
required
number
Example
{
"project_id": "prj_abc123",
"name": "Spring Campaign",
"workspace_id": "ws_abc123",
"origin": "api"
}