Projects

Update a project

Updates a project's Khotan-owned attributes. An omitted field, including tags, stays unchanged; a sent tags list replaces the stored list. The slug is immutable, and execution state is never writable here — the tracker owns it.

patch/api/v1/projects/{projectId}

Request

  • Base URL
    https://app.khotan.com
  • URL
    https://app.khotan.com/api/v1/projects/{projectId}
  • Auth
    • HTTP bearer
    • or API key in header x-api-key

Path parameters

projectIdstring required

Request body

namestring
descriptionstring nullable
lifecycle'active' | 'archived'
tagsstring[]

Full tag list; it replaces the stored list. Each tag is trimmed, lowercased, and has whitespace runs replaced with "-", and repeats are removed. After that, each tag is 1-32 lowercase letters, digits, or single hyphens, with at most 10 tags. Presets: test, live, uat, dev, demo, deprecated.

Response

The updated project.

idstring required
slugstring required
namestring required
descriptionstring nullable required
lifecyclestring required
linearProjectIdstring nullable required
latestSpecRevisionnumber required
memberCountnumber required
tagsstring[] required
createdAtstring required
updatedAtstring required

Changes

No recorded changes to this operation across all 1 revision of this API.