Skip to content

Vault Endpoints

There are two API endpoints relevant to vaults: /v2/vaults and /v2/objects. Vaults are top-level entities that can be conceptually thought of like filesystems. Vaults can contain any number of Objects. Objects can be either files, folders, or SolveBio datasets.

Vaults

For more information about Vaults endpoints, see the Vaults Reference.

Method HTTP Request Description
create POST /v2/vaults Create a vault.
list GET /v2/vaults List vaults.
update PUT /v2/vaults/{VAULT_ID} Update a vault.
delete DELETE /v2/vaults/{VAULT_ID} Delete a vault.
get GET /v2/vaults/{VAULT_ID} Retrieve metadata about a vault.

Objects

For more information about Objects endpoints, see the Objects Reference.

Method HTTP Request Description
create POST /v2/objects Create an object.
list GET /v2/objects List objects.
update PUT /v2/objects/{OBJECT_ID} Update an object.
delete DELETE /v2/objects/{OBJECT_ID} Delete an object.
get GET /v2/objects/{OBJECT_ID} Retrieve metadata about an object.
create POST /v2/object_copy_tasks Copy an object from one vault into another (skips datasets).
list GET /v2/object_copy_tasks List object copy tasks created by the current user.
get GET /v2/object_copy_tasks/{TASK_ID} Retrieve metadata about an object copy task.