---
title: "POST /orgs/{org_id}/projects"
method: POST
path: "/orgs/{org_id}/projects"
tags: ["projects"]
---

# POST /orgs/{org_id}/projects

`POST /orgs/{org_id}/projects`

Create a new project.

## Path parameters

- `org_id` string, required

## Request body

- CreateProjectReqBody
  - `name` string, nullable
  - `origin` union, required
    - object
      - `project_id` integer, required
      - `type` 'Template', required
    - object
      - `agents` string[] — Agent directory names to scaffold under `workforce/`. Omit for an empty workforce directory.
      - `kb_id` integer, nullable — Knowledge base to attach to the project. Provide an existing KB's id to link it, or omit to auto-create an empty one.
      - `type` 'Scratch', required
      - `with_ui` boolean — Include the default web UI scaffold. Requires at least one entry in `agents` (workflows alone do not use the web UI).
      - `workflows` string[] — Workflow directory names to scaffold under `workforce/`.

## Response `200`

Project created successfully

- CreateProjectResBody
  - `id` integer, required
  - `name` string, required

---

[API](https://skmtc.net/timbal-ai/apis/timbal-platform-api.md) · [All operations](https://skmtc.net/timbal-ai/apis/timbal-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/timbal-ai/timbal-platform-api/revisions/dd7e398ce0d3/schema)