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

# POST /api/v1/projects/resolve

`POST /api/v1/projects/resolve`

## Request body

- ResolveProjectRequestBody
  - `alias` AliasInput
    - `identity` string, required — alias identity (normalized git remote or local://<abs>)
    - `kind` string, required — "git" or "local"
  - `name` string — project name; required for first-seen alias attach
  - `start_path` string — absolute path to resolve from (daemon-side filesystem); legacy local-only fallback

## Response `200`

OK

- ProjectResolveBody
  - `alias` ProjectAlias, required
    - `alias_identity` string, required
    - `alias_kind` string, required
    - `created_at` string, date-time, required
    - `id` integer, required
    - `project_id` integer, required
  - `project` ProjectOut, required
    - `active` boolean, 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

## Changes

- **2026-09-16** `2916e577ef54` — 1 info
  - added the required property `project/active` to the response with the `200` status

[Change history](https://skmtc.dev/kenn-io/apis/kata/changes/api/v1/projects/resolve/post.md)

---

[API](https://skmtc.dev/kenn-io/apis/kata.md) · [All operations](https://skmtc.dev/kenn-io/apis/kata/llms.txt) · [OpenAPI document](https://skmtc.dev/kenn-io/apis/kata/revisions/eec9b2fb4675?raw)