Update classification (partial)
Update specific fields on a classification. Send only the fields you want to change — anything you don't send stays as it is. Use null on parent_id to remove a parent.
Example — rename and deactivate a classification:
{"name": "Department (legacy)", "is_active": false}
Selections (classification lines)
Omitting selections preserves the existing lines. Sending the field applies it as-is: lines whose id you include are kept (and updated with whatever values you send), and lines whose id you omit are deleted. Sending [] removes every line. Adding a new line means sending it without an id:
{"selections": [
{"id": 42, "name": "Engineering", "is_active": true, "parent_id": null},
{"name": "Operations", "is_active": true, "parent_id": null}
]}
Required-for-records
Omitting required_for_records preserves existing associations. Sending the field replaces the full set; sending [] removes them all:
{"required_for_records": ["invoice", "bill"]}
Lines that are in use elsewhere can't be deleted; you'll get a 422 back listing which ones.
Path parameters
Headers
Optional. A unique value (a UUID works well) identifying this operation. If the request is repeated with the same key, the original response is replayed instead of the operation running again, so a retry cannot create a duplicate record. Results are replayable for 48 hours. Reusing a key with a different request body returns 422.
Request body
Response
OK
Changes
Changed in 4 of the 27 revisions of this API.15
- ○
added the optional property
to the response with the statusresponse-optional-property-added
- ○
- ○
added the required property
to the response with the statusresponse-required-property-added
- ○
added the required property
to the response with the statusresponse-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
- ○
- ○
added the new optional
headerrequest parameterIdempotency-Keynew-optional-request-parameter
- ○
- ●
added the new
statistical_journalenum value to the/response property for the response statusresponse-property-enum-value-added
- ○
added the new
statistical_journalenum value to the request property/request-property-enum-value-added
- ●
Of the 27 revisions, 1 has no diff computed.