Skip to main content

​
Creating an API key

To create an API key, log into the Tilebox Console. Navigate to Settings -> API Keys and click the “Create API Key” button.
Keep your API keys secure. Deactivate any keys if you suspect they have been compromised.
Tilebox Console

​
Set up environment variable

Set TILEBOX_API_KEY in your shell environment (optional but recommended). That way, the Tilebox CLI and SDK clients automatically pick it up. The following commands persist the variable for future terminal sessions and also make it available in the current session. 
echo 'export TILEBOX_API_KEY="<tbx-api-...>"' >> ~/.bashrc
source ~/.bashrc
Open a new terminal after setting the variable to confirm your shell loads it automatically.

​
Manual SDK authentication

In case you didn’t configure your shell environment, you can also pass your API key as the token parameter when creating an instance of the SDK clients. 
from tilebox.datasets import Client as DatasetsClient
from tilebox.workflows import Client as WorkflowsClient

datasets_client = DatasetsClient(token="<tbx-api-...>")
workflows_client = WorkflowsClient(token="<tbx-api-...>")
If you set your API key as an environment variable named TILEBOX_API_KEY, you can skip the token parameter when creating a client.