Skip to navigation
API ReferenceAccounting & ProcessingBalance ProcessingReclassification

List the versions of a Reclassification configuration

This endpoint returns every version of the active Reclassification configuration with the given name, oldest first. Each version includes its author, the time it was written, and its comment.

Every save that changes the configuration creates a version, whether it’s made through this API or the Fynapse UI.

Version numbers re-start again at 1 in these cases:

  • A configuration is created with the name of a deleted configuration.
  • A bulk configuration upload re-creates every configuration.

In these cases, expectedVersion can’t detect the configuration restarted, so it is recommended to read the configuration again before you update it, after a bulk upload or a re-creation.

Errors (each error type ends with the name shown):

  • 404 ConfigurationNotFound: no active configuration has this name.
  • 409 AmbiguousName: more than one active configuration has this name. Rename the duplicates in the Fynapse UI so that only one configuration keeps the name.

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Path parameters

namestringRequired<=64 characters

The name of the Reclassification configuration, as one path segment. Percent-encode it. The service decodes the segment before it routes the request, so a name that contains / cannot be addressed.

Response

OK
versioninteger
The version's number, counted from 1 for the configuration.
createdAtstringformat: "date-time"
When the version was written.
createdBystring
The name of the user who wrote the version.
commentstringOptional
The comment the version was written with. Absent when there was none.

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error
5XX
Server Error