KHkhotan
Projects

File a change as an issue

Creates or updates the issue tracking one OpenSpec change directory under this project. Khotan owns the issue's title and description; its state, assignee, priority, and dates stay with the tracker. Idempotent by change id.

post/api/v1/projects/{projectId}/changes

Request

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

Path parameters

projectIdstring required

Request body

changeIdstring required

The change directory name. Stable identity for the issue, so renaming the directory files a second one.

titlestring required
bodystring required
capabilitiesstring[]

Capabilities this change amends, applied as labels in one managed group. Labels outside that group are untouched.

Response

The issue tracking this change.

projectIdstring required
changeIdstring required
issueIdstring required
issueUrlstring nullable required
identifierstring nullable required

Linear's human key, e.g. ADE-12.

createdboolean required

False when an existing issue was updated.

documentsWrittennumber required

Changes

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