Create a Secret Key

A secret key authenticates your integrations with Datature Vi through the Vi SDK. The carousel below walks through creating one from your organization settings. Access scope and permission level are not in the create dialog yet; Datature Vi will make them customizable in a future release.

1

Navigate to the Secret Keys tab

From your organization dashboard, click Settings at the bottom of the left sidebar and select the Members tab.

Next →

You should see

The new key appears in the table. Last Used starts at Never and updates after the first authenticated request.

Access scope and permission level pickers are not in the product UI yet. Datature Vi will add them in a future release so you can customize each key. Until then, new keys keep full organization access. The sections below describe how scope and permissions will work once you can set them.

Access scope

Access scope controls which resource categories the key can reach.

When customization is available, new keys can start with all three scopes enabled. You will be able to narrow the scope to follow the principle of least privilege: give each key access only to what it needs. A key used by an annotation pipeline, for example, could use Dataset Access only.

Permission levels

The permission level controls what operations the key can perform within its allowed scopes.

When both controls are available, you will pair the permission level with the access scope for fine-grained control. For example, a key with Dataset Access + Read Only can list datasets and download annotations but cannot upload new images or start training runs.

Verify the key was created

After closing the dialog, your new key appears in the Secret Keys table.

Next steps