This guide covers how to:

• Install the Validio CLI and SDK.
• Create an API key and authorize requests to interact with the Validio Platform.
• Use the CLI to, for example, print output, store credentials, and manage Sources.

Install the Validio CLI and SDK

The Validio SDK and CLI are published as Python packages on PyPI as validio-cli and validio-sdk, respectively.

You can use a Python package installer, such as ‘pip’, to install the SDK and CLI in your desired environment:

Install the CLI and SDK

pip install validio-cli

Install only the SDK

pip install validio-sdk

Create API key in the Validio platform

All requests to interact with the Validio platform through the API requires authorization with an API Key. You need to request an API key to use the Validio platform through the Validio API. For more information, see Managing API Keys.

🚧

Caution

The API key credentials cannot be obtained again. If you lose your credentials, you must either create a new API key or regenerate the credentials for your existing API key.

Configure default API credentials

When using the CLI or SDK, you can configure the default API credentials by running validio config. The API key credentials are stored locally on your disk and used whenever you access the Validio platform.

When using the SDK, you can also pass the API key credentials directly to the client, without storing them locally on your disk. For more information on how to store these credentials and use them with the CLI or SDK by default, refer to Store credentials.

API Keys and Namespaces

The API key has a global role, similar to the global role for Users, that determines access rights for non-namespaced resources such as users, namespaces, and tags.

If an API key has the global role Admin and you use the Validio CLI to create a namespace, that API key is automatically added with Admin role to the namespace. However if you create an API key using the UI, you will need to manually add the API key to each namespace that it needs to access. For more information, see Managing Namespaces.

Use the Validio CLI

You can now use the Validio CLI to interact with the Validio platform directly from the command-line interface.

In this example, the CLI prints a short summary:

validio credentials get
NAME                     TYPE      AGE
my_gcp_credentials       GCP       7d
my_demo_credentials      DEMO      7d

For more information and examples, refer to Validio CLI documentation.