Map a factor to a utility resource
Sets which utility resource the factor's rows count under on the Utility page (a manual mapping, which the rule never overwrites, including when the factor is renamed or moved), or with null returns the factor to the rule mapping derived from its category and name. Factors of the organization's own libraries need the organization's write access, and every emission row using the factor is reclassified in the same transaction (200). Factors of public (shared) libraries are mapped for every organization at once: only Greentally platform staff holding the factor_library.write platform capability may do it (anyone else, and every API key, gets 403 PLATFORM_CAPABILITY_REQUIRED), a non-blank reason is required (400 without one), and the change is recorded in the platform audit trail with its before and after mapping (resource, source, library and factor name), the reason and the job. The mapping change commits at once (202) and the rows of every organization using the factor are reclassified in the background, one organization per transaction, by the returned job (GET /factor/utility-reclassify-jobs/{jobId}).
Path parameters
Request body
Response
The factor with its new mapping, and how many rows were reclassified.
Changes
Changed in 1 of the 11 revisions of this API.1
- ○
endpoint added
endpoint-added
- ○