---
title: "POST /api/v1/projects"
method: POST
path: "/api/v1/projects"
---

# POST /api/v1/projects

`POST /api/v1/projects`

## Request body

- InitProjectRequestBody
  - `actor` string
  - `alias` AliasInput
    - `identity` string, required — alias identity (normalized git remote or local://<abs>)
    - `kind` string, required — "git" or "local"
  - `name` string — project name; required when start_path is empty
  - `reassign` boolean
  - `replace` boolean
  - `start_path` string — absolute path on the daemon's filesystem; omit for path-free init

## Response `200`

OK

- InitProjectResponseBody
  - `alias` ProjectAlias, required
    - `alias_identity` string, required
    - `alias_kind` string, required
    - `created_at` string, date-time, required
    - `id` integer, required
    - `project_id` integer, required
  - `created` boolean, required
  - `project` ProjectOut, required
    - `created_at` string, date-time, required
    - `deleted_at` string, date-time
    - `id` integer, required
    - `metadata` object, required
    - `name` string, required
    - `revision` integer, required
    - `stats` ProjectStatsOut
      - `closed` integer, required
      - `last_event_at` string, date-time, nullable, required
      - `open` integer, required
    - `uid` string, required
  - `workspace_root` string

## Other responses

- `default` — Error

---

[API](https://skmtc.net/kenn-io/apis/kata.md) · [All operations](https://skmtc.net/kenn-io/apis/kata/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kenn-io/kata/versions/14560b7a29ca/schema)