API Docs

__METHOD= PUT . __PATH= /almaws/v1/bibs/{mms_id} .

Update Bib Record

This web service updates a Bib Record.
Note: JSON is not supported, and updating a linked CZ record is currently not supported.
For more information regarding the various options supported for this API see here.
For an IZ record that is linked to NZ record, local fields will be replaced - based on $$9local field indication.
Updating of non-local fields should be done directly on the NZ record.
See Working with APIs in a Network Topology for more details.

Resource URL

PUT /almaws/v1/bibs/{mms_id}

API Description

URL Parameters

ParameterTypeDescription
mms_idxs:stringThe Bib Record ID.

Querystring Parameters

ParameterTypeRequiredDescription
normalizationxs:stringOptional.The id of the normalization profile to run.
validatexs:stringOptional. Default: falseIndicating whether to check for errors. Default: false.
override_warningxs:stringOptional. Default: trueIndicating whether to ignore warnings. Default: true (record will be saved and the warnings will be added to the API output).
override_lockxs:stringOptional. Default: trueIndicating whether to ignore lock. Default: true (record will be saved regardless if is currently being edited by another user).
stale_version_checkxs:stringOptional. Default: falseIndicating whether to validate stale version of the record. When true, the 005 field of the MARC record must be identical to that of the record in the database. Default: false.
cataloger_levelxs:stringOptional.Cataloger level of the user updating the record - used for validating that the level is sufficient. To change the record's level, use the payload's cataloging_level field.

Body Parameters

This method takes a Bib object. See doc

Output

This method returns a Bib object. See doc

Possible Error Codes

CodeMessage
401652General Error - An error has occurred while processing the request.
40166454Error - Not supported from the community zone.
402204Input parameters mmsId X is not numeric.
402203Input parameters mmsId X is not valid.
60105JSON is not supported for this API.
4022030Invalid normalization profile ID.
4022031Failed to normalize record.
4022032The record failed validation (with specified error).
4022033Failed validation on the record.
4022034A newer version of this record exists in the repository.
4022040Cataloging level is not enabled for your institution.
4022041Cannot update this record due to insufficient cataloger level privileges.