Create a project in a project folder

POST

/workspaces/{workspaceId}/folders/{folderId}/projects

import { FloraClient } from '@flora-ai/flora';

const client = new FloraClient({ apiKey: process.env['FLORA_API_KEY'] });

const project = await client.workspaces.projects.createInFolder({
  workspaceId: '<workspaceId>',
  folderId: '<folderId>',
  name: 'Spring Campaign',
});
console.log(project);

Creates a new Flora project filed into the given project folder. The folder must belong to the workspace named in the path; private folders are reachable only by their owner, and an unreachable folder returns 404 rather than disclosing that it exists. 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.

Authorizations

• bearerAuth

Parameters

Path Parameters

workspaceId

required

Workspace identifier

string

/^ws_\S+$/

Workspace identifier

folderId

required

Project folder identifier

string

/^fld_\S+$/

Project folder identifier

Request Body ^required

Media type application/json

object

name

required

Project name

string

>= 1 characters

Responses

201

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:

string

Project origin

string

null

null

last_modified

required

Any of:

number

number

null

null

created_at

required

number

Example

{
  "project_id": "prj_abc123",
  "name": "Spring Campaign",
  "workspace_id": "ws_abc123",
  "origin": "api"
}