Organization API

Update editable Case metadata

Updates editable Case metadata, status, Project link, and first-response marker. customerId, propertyId, systemId, ownerId, and the removed assignedToId field are not writable on PATCH.

/api/v1/cases/{id}

Updates editable Case metadata, status, Project link, and first-response marker. customerId, propertyId, systemId, ownerId, and the removed assignedToId field are not writable on PATCH.

Update editable Case metadata. Use an organization API key with cases:write. Check the response envelope and meta.requestId before triggering dependent workflow steps.

Required scopes

cases:write

Parameters

Name	In	Type	Description
idrequired	path	string	Case identifier returned by the Organization API.

Request body

objectrequired

Field	Type	Description
subject	string	Optional unless marked required.
description	string	Optional unless marked required.
origin	PHONE \| EMAIL \| PORTAL \| MONITORING_ALERT \| IN_PERSON	Optional unless marked required.
severity	LOW \| MEDIUM \| HIGH \| URGENT	Optional unless marked required.
category	string	Case Category key. Platform keys: HARDWARE_DEFECT, WORKMANSHIP, MONITORING, BILLING, OTHER. Organizations may add their own; list them with GET /case-categories.
status	OPEN \| TRIAGING \| IN_PROGRESS \| AWAITING_CUSTOMER \| AWAITING_VENDOR \| AWAITING_WORK \| RESOLVED \| CLOSED	CLOSED is the sole terminal status. Legacy RESOLVED input is accepted as CLOSED.
projectId	string \| null	Current project compatibility pointer. Changing or clearing it preserves prior Project memberships. Use Project.caseId to link/unlink membership.
firstResponseAt	string \| null	Optional unless marked required.

updatecaseRequest

{
  "status": "IN_PROGRESS",
  "firstResponseAt": "2026-08-12T18:00:00Z"
}

Responses

200

Updated Case envelope

#/components/schemas/CaseEnvelope

400

Validation error