Create and list collections
Sign in to Objectgrove. Choose New collection, enter a name and optional description, and save.
Keep the returned collection ID. Use it when cataloguing and searching objects in that collection.
Your collections lists saved collections, object counts, the collection allowance, and collections used.
Your subscription sets the allowance. ALLOWANCE_EXCEEDED means the extra collection was not created. Existing collections stay unchanged.
Catalogue and revise objects
Open a collection and choose Catalogue an object. Enter its accession number and title. Accession numbers must be unique within the collection.
Add a description, object type, maker, date, materials, dimensions, provenance, location, condition, and notes as needed.
Save the object and keep its returned object ID. View an object retrieves the saved fields and the collection ID. Download record saves this information and attached image details as JSON.
To revise a saved object, use its existing object ID and the fields to change. Revise record updates the existing record without creating a duplicate. The object keeps its ID and collection. Other objects remain unchanged.
Omitted fields keep their saved values. An empty optional field clears that field. A missing object returns OBJECT_NOT_FOUND without creating an object or modifying any existing records.
A revision refusal contains JSON with ok: false and an error object. The error has code and message fields. OBJECT_NOT_FOUND means no saved object in your account has that ID.
Search within a collection
Open the collection you want to search. Enter a word or phrase from the object's description, title, accession number, maker, materials, object type, or notes.
Search uses literal text. Results contain matching objects from that collection in your account. Objects from other collections are excluded.
Leave search text empty to browse the collection. Use the next and previous links to move through results.
Attach and retrieve original images
Open a saved object and attach a JPEG image of up to 5 MB. Add an optional file name and caption. The image stays associated with that object's ID.
When supplying image data in JSON, use image_base64 with standard base64 and no data URL prefix. Keep the returned image ID.
Retrieve an object image with that image ID to receive the original JPEG as image_base64, together with its object ID, file name, and caption. Decode the base64 to recover the identical original bytes.
In the workspace, select an attached image to view the original. Images are available only to the account that saved them.