# Managing workspace configurations

In this guide, you'll learn how to manage essential configurations for your Paradime workspace. Proper configuration management ensures consistency, security, and flexibility across your analytics engineering projects.

**Estimated completion time:** 10 minutes

{% hint style="warning" %}

### Prerequisites

* An [**admin role**](https://docs.paradime.io/app-help/documentation/settings/users/role-based-access-control) In Paradime to create workspaces
  {% endhint %}

### What you'll learn

* [Manage dbt™ versions for your workspace](#id-1.-managing-dbt-tm-versions-in-paradime-workspaces)
* [Create and Manage environment variables](#id-2.-setting-up-environment-variables)
* [Create and manage API keys](#id-3.-managing-api-keys)

***

### 1. Managing dbt™ Versions in Paradime Workspaces

Paradime allows you to centrally manage the dbt™ version for your entire workspace, ensuring consistency across both the Code IDE and Bolt scheduler for all users. This feature is crucial for maintaining compatibility and leveraging the latest dbt™ functionalities across your projects.

{% embed url="<https://www.youtube.com/watch?v=xJFzaTTfvvs>" %}

#### View your current dbt version:&#x20;

1. Navigate to your account settings.
2. Select the `Workspace` tab.
3. Under the project settings section, find the current dbt™ version configuration.

#### Upgrade or downgrade your dbt ™version

{% hint style="warning" %}
Before changing the dbt™ version, ensure that your projects are compatible with the new version to avoid any potential issues.
{% endhint %}

* Click the `Edit` button next to the current dbt™ version.
* Select the desired dbt™ version from the dropdown menu.
* Click the `Save` button to apply the changes.

Once saved, all users in the workspace will inherit this dbt™ version, which applies to both the Code IDE and the Bolt scheduler.

***

### 2. Setting Up Environment Variables

Environment variables allow you to securely store and use sensitive information or configuration details in Paradime. These variables can be managed in two different contexts:

{% hint style="info" %}

* **Bolt Schedule Environment Variables**: For production jobs (requires Admin access)
* **Code IDE Environment Variables**: For development work
  {% endhint %}

{% embed url="<https://www.youtube.com/watch?v=FPIphtub40k>" %}

#### Add a New Environment Variable

1. From any page in the Paradime application, Click **Settings**
2. Navigate to **Workspaces > Environment Variables**
3. Choose where to add your variable:
   1. **For production jobs**: In the Bolt Schedules section, click **Add New**
   2. **For development work**: In the Code IDE section, click **Add New**
4. Configure your variable:
   1. Enter Key name
   2. Enter Value
   3. Click Save icon (💾)

{% hint style="success" %}

#### When Variables Take Effect

* **Bolt Schedules**: Variables are automatically injected into your dbt™ project at runtime
* **Code IDE**: Variables are immediately available in your development environment
  {% endhint %}

#### Managing Environment Variables

* **Edit**: Click the 'Edit' button (✎) next to the variable
* **Delete**: Click the 'Delete' button (🗑️) next to the variable
* Remember to save your changes

{% hint style="warning" %}

#### Important notes

* Bolt Schedule variables require Admin access to manage
* Environment variables are environment-specific (development vs. production)
* For detailed information, see:
  * [Bolt Schedules Environment Variables](https://docs.paradime.io/app-help/documentation/settings/environment-variables/bolt-schedule-env-variables)
  * [Code IDE Environment Variables](https://docs.paradime.io/app-help/documentation/settings/environment-variables/code-ide-env-variables)
    {% endhint %}

***

### 3. Managing API Keys

API keys in Paradime provide secure, programmatic access to your workspace resources. They are essential for integrating Paradime with other tools and automating workflows. Each API key is scoped to a specific workspace, ensuring isolation and security of your data and configurations.

{% embed url="<https://youtu.be/TEeNQVhlKdA>" %}

#### Generate a New API Key

1. Navigate to your account settings.
2. Select the "Workspace" tab.
3. Scroll to API key section  and click on the `+ Generate API Key`
4. Provide a name for the key (e.g., 'My New API Key').
5. Optional: Set a lifetime for the key by specifying the number of days until expiration.
6. Click `Create` to save.
7. After creation, securely store your API key, secret, and endpoint.

#### Define API Key Capabilities

Choose the capabilities you want to enable for this API key, you can find all the capabilities and access in the [API docs](https://docs.paradime.io/app-help/developers/generate-api-keys). Select the appropriate capabilities based on your intended use of the API key.

{% hint style="info" %}
**Important Note on API Key Scope:** API keys in Paradime are scoped to specific workspaces. This means:

* Each API key is tied to the workspace in which it was created.
* An API key generated in one workspace cannot be used to access or manage resources in another workspace.
  {% endhint %}

#### Managing API Keys

To manage existing API keys:

* View all generated keys in the API key section of your workspace settings.
* Delete keys that are no longer needed or may have been compromised.

{% hint style="info" %}
**Best Practice:** Regularly review your API keys, rotate them periodically, and ensure each key has only the necessary capabilities for its intended use.
{% endhint %}

***

{% hint style="info" %}

### Related Documentation

* [Upgrade dbt™ core version](https://docs.paradime.io/app-help/documentation/settings/dbt/upgrade-dbt-core-version)
* [Environment Variables](https://docs.paradime.io/app-help/documentation/settings/environment-variables)
* [API Keys](https://docs.paradime.io/app-help/developers/generate-api-keys)
  {% endhint %}

***

### Summary

You've now learned how to manage dbt™ versions, set up environment variables, and handle API keys in your Paradime workspace. These skills will help you maintain a secure and efficient analytics engineering environment.

Next, we'll explore [Managing Users in the Workspace](https://docs.paradime.io/app-help/guides/paradime-101/getting-started-with-your-paradime-workspace/managing-workspace-configurations) to ensure proper access control and collaboration in your Paradime projects.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.paradime.io/app-help/guides/paradime-101/getting-started-with-your-paradime-workspace/managing-workspace-configurations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.