# API Keys

## Creating a Tenant API Key

Create and manage Tenant API Keys for access to your Tenant within the Contextual.io tenant workspace.

Steps to create a new Tenant API Key:

1. **Navigate to the API Keys Page**
   * Go to the Tenant API > API Keys page in your Contextual tenant workspace.
2. **Create a New API Key**
   * Click the **"+"** icon in the upper right corner of the data grid.
3. **Enter a Name**
   * **API Key Name**: Provide a friendly name for your API Key. This name will be displayed in various tables and lists.
   * **Format**: The name should consist of lowercase letters, numbers, and dashes, and can be up to 256 characters long.
   * **Note**: You can change this name at any time.
4. **Enter a Description**
   * **API Key Description**: Provide a description for your API Key to help identify its purpose.
   * **Format**: The description can include letters, numbers, spaces, dashes, and most special characters.
   * **Note**: The description can be modified at any time.
5. **Save Your API Key**
   * Once you have entered the required information, click the **Create** button to generate the API Key.

## Notes

* **Security**: Handle your Client Secret with care. Consider a process to rotate it periodically to maintain security.
* **Permissions**: Review and adjust permissions regularly to ensure they align with your security policies and usage needs.


---

# 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.contextual.io/documentation-and-resources/tenants/what-is-the-tenant-api/api-keys.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.