Classifications

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.

patch/public/v1/classifications/{classification_id}/

Path parameters

classification_idinteger required

Headers

Idempotency-Keystring

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

namestring nullable
is_activeboolean nullable
required_for_recordsPublicClassifiableRecords[] nullable
parent_idinteger nullable

Response

OK

created_atstring date-time required

Date and time the record was created

updated_atstring date-time required

Date and time the record was last updated

idinteger required
codestring nullable
required_for_recordsPublicClassifiableRecords[] required
parent_idinteger nullable required
parent_namestring nullable required
namestring required
is_activeboolean

Changes

Changed in 4 of the 27 revisions of this API.15

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the required property to the response with the status

      response-required-property-added

    • ○

      added the required property to the response with the status

      response-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 header request parameter Idempotency-Key

      new-optional-request-parameter

  • 51b71d2b921311See the full diff
    • ●

      added the new statistical_journal enum value to the / response property for the response status

      response-property-enum-value-added

    • ○

      added the new statistical_journal enum value to the request property /

      request-property-enum-value-added

Of the 27 revisions, 1 has no diff computed.