---
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

## Changes

- **2026-06-05** `45de91fcec33` — 1 breaking, 1 info
  - removed `subschema #2, subschema #3` from the `origin` request property `oneOf` list
  - added `subschema #2` to the `origin` request property `oneOf` list
- **2026-05-18** `cd5b6fad189e` — 1 breaking
  - removed the enum value `unknown` of the request property `origin/oneOf[subschema #2]/app_type`
- **2026-04-17** `91d10d3c5c55` — 1 breaking, 1 info
  - removed `subschema #2` from the `origin` request property `oneOf` list
  - added `subschema #2, subschema #3` to the `origin` request property `oneOf` list
- **2026-03-28** `03807319958f` — 1 info
  - added the new `unknown` enum value to the request property `origin/oneOf[subschema #2]/app_type`
- **2026-03-16** `eb2c08128881` — 2 breaking, 4 warning
  - added the new required request property `origin/oneOf[subschema #2]/app_type`
  - added the new required request property `origin/oneOf[subschema #2]/has_ui`
  - removed the request property `origin/oneOf[subschema #2]/agents`
  - removed the request property `origin/oneOf[subschema #2]/kb_id`
  - …2 more

[Change history](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/changes/orgs/:org_id/projects/post.md)

---

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