---
title: Before you begin
description: Request API access for your organization and create an API key.
sidebar:
  order: 1
---
To call the Doss API you need three things:

- A Doss account
- API access enabled for your organization
- An API key, created by an admin in your organization

## Request API access

The Doss API is in closed release, so it isn't turned on for any organization by default. To request access, your enterprise admin or account owner contacts your Doss account team. After Doss enables access, you can get an API token from [app.doss.com](https://app.doss.com) when you log in with an admin account. Until you generate the key and have an active key, the endpoints will not be accessible and will error out.

## Create an API key (admins)

API keys belong to your organization, not to an individual user. Only admins can create or revoke them.

1. Sign in to Doss with your admin credentials.
1. Click on your name on the left nav and open Account. In the Account page, navigate to the API section.
1. Click **Create API key**.
1. Enter a name for the key, for ex: enterprise-doss-data and choose an expiry date if needed. If you do not choose one, the API key does not expire.
1. Copy the key and store it in your secrets manager. Doss shows the full key only once.
1. Once you have created the key, click on Edit Permissions to give read permissions to the required data (tables / columns).
1. Once you save this configuration, you can update permissions at any point.

:::tip
You can create any number of API keys for your account currently.
:::

![The API section of Doss account settings, with the Create API key button and a list of existing keys](https://cdn.sanity.io/images/7oqendzw/production/ce56bb0b53bf8796b4e2da78fa65bcefa79d5ca0-2880x1800.png)

![The API key created dialog, showing the new key once with Copy and Set permissions options](https://cdn.sanity.io/images/7oqendzw/production/9e9c06bed11e092980a3815237eb0e491d169cc1-2880x1800.png)

![The API key list, with an active key's Rotate and Revoke actions open](https://cdn.sanity.io/images/7oqendzw/production/540fb1e746b89642fd2fdb83d66918dce7e0e721-2880x1800.png)

## Manage API keys

- **See your key:** **Name → Account → API** lists key's name, creator, creation date and last use.
- **Revoke a key:** click **Revoke** next to the key. Requests using it fail with `401 invalid_api_key`.

If a key may have been exposed, revoke it immediately and contact your account team.
