API ReferenceObject Actions

Create Objects

Create objects within your organization's AmniSphere library.

Headers

x-api-keystringRequired
Your organization's active API Key.

Request

This endpoint expects a list of objects.
labelstringRequired
The name of the object you'd like to create within your organization's library.
organization_idstringRequiredformat: "uuid"
Your organization's unique identifier.
attributesmap from strings to stringsRequired
A map of attributes associated with the object to be created within your organization's library. At least one attribute is required to create an object.
detection_item_folder_idstringOptionalformat: "uuid"
The folder id of the folder you'd like your object to be created in within your organization's library. If this value is left empty, the object will be created in the "Unclassified" folder.
collection_notestringOptional
A collection note to be shown to users when they begin collecting this object.
created_bystringOptional
The email of the user creating the folder. If this parameter is left empty, the value will default to 'API'.

Response

201 - Object creation successful

labelstring or null
The name of the object you've successfully created within your organization's library.
organization_idstring or nullformat: "uuid"
Your organization's unique identifier.
attributesmap from strings to strings or null
A map of attributes associated with the newly created object. These attributes will match the attributes within the library for this object.
collection_notestring or null
A collection note to be shown to users when they begin collecting this object. This value will be null if a collection note was not entered during object creation.
detection_item_folder_idstring or null
The folder id of the folder your newly created object resides in within your organization's library. If you did not specify a folder during object creation, this value will be null.
created_bystring or null
The name of the object you'd like to create within your organization's library.

Errors