Creates a new entity, sending entity data in the request body.
/entities/create API is called for an entity that already exists in our system, it is treated it as an upsert and an update on the existing entity is performed. The response to the request will then contain the entry
Unit21 selectively ignores upserts if the request is identical to a previous request. The response to any ignored upsert will contain the field
If you want to perform strict validation and not perform an upsert on conflict, specifying
options.upsert_on_conflict: false will result in the API responding with a 409 error code indicating that this entity cannot be overwritten.
To turn a placeholder entity into an entity in the Unit21 system, use this endpoint.
Whitelisted entities cannot be updated through the
Updates to an entity's
general_data.entity_id are not allowed.
Instruments can be associated with entities by providing the IDs of these instruments within the
instrument_ids section of the request. If the instrument doesn't already exist, Unit21 creates a placeholder instrument.
We recommend that you create entities prior to running verification. In the event you wish to run a verification on an entity immediately, Unit21 recommends that you wait at-least 2 minutes for your entity data to be fully processed. You will receive a 423 error code if an entity is busy. When a 200 response is received, the data has been successfully stored on the Unit21 backend; however, it may take a few additional seconds to process that data so that it becomes available in subsequent API calls, in the frontend UI, and/or for verification purposes.
Follow the links for more information: