> ## Documentation Index
> Fetch the complete documentation index at: https://docs.typewise.app/llms.txt
> Use this file to discover all available pages before exploring further.

# API keys

> Create and manage API keys for programmatic access to your workspace data.

API keys let external systems access your workspace through the
[Tickets API](/guides/integrations/tickets-api). Each key is scoped to a single
workspace and carries a fixed set of permissions.

<Note>
  Only **Admin** users can create and manage API keys.
</Note>

***

## Create a key

<Steps>
  <Step title="Open API Keys">
    Go to **Workspace Settings** and select the **API Keys** tab.
  </Step>

  <Step title="Create">
    Click **Create API key** and enter a descriptive name (e.g. "Zapier
    integration" or "Reporting pipeline").
  </Step>

  <Step title="Copy the key">
    The full key is displayed **once**. Copy it immediately and store it in a
    secure location. You won't be able to view it again.
  </Step>
</Steps>

<img src="https://mintcdn.com/typewise/uHmX9HthHvSg2Onl/images/documentation/settings/api-keys/api-keys-list.png?fit=max&auto=format&n=uHmX9HthHvSg2Onl&q=85&s=70b36eb34a01cea18bef925cee8da4ba" alt="API Keys tab in Workspace Settings" width="3257" height="2038" data-path="images/documentation/settings/api-keys/api-keys-list.png" />

<img src="https://mintcdn.com/typewise/uHmX9HthHvSg2Onl/images/documentation/settings/api-keys/api-keys-create-dialog.png?fit=max&auto=format&n=uHmX9HthHvSg2Onl&q=85&s=c5973b1cfa87eabdf5bce6c75b0a0eda" alt="Create API key dialog" width="3257" height="2038" data-path="images/documentation/settings/api-keys/api-keys-create-dialog.png" />

<img src="https://mintcdn.com/typewise/uHmX9HthHvSg2Onl/images/documentation/settings/api-keys/api-keys-reveal.png?fit=max&auto=format&n=uHmX9HthHvSg2Onl&q=85&s=48945f710485dbc16b3f63c796cfb962" alt="Your API key: copy it before you close this dialog" width="3257" height="2038" data-path="images/documentation/settings/api-keys/api-keys-reveal.png" />

***

## Rotate a key

Rotating replaces the current key with a new one.

<Warning>
  The old key stops working immediately after rotation. Update your
  integrations before rotating to avoid service disruption.
</Warning>

<Steps>
  <Step title="Find the key">
    In the **API Keys** tab, locate the key you want to rotate.
  </Step>

  <Step title="Rotate">
    Open the key's action menu and select **Rotate**. Confirm the action.
  </Step>

  <Step title="Copy the new key">
    Copy the new key and update any integrations that use it.
  </Step>
</Steps>

<img src="https://mintcdn.com/typewise/uHmX9HthHvSg2Onl/images/documentation/settings/api-keys/api-keys-actions.png?fit=max&auto=format&n=uHmX9HthHvSg2Onl&q=85&s=2d0475561cff3b767dc53e16ef15aff1" alt="Row menu with Rotate and Delete" width="3257" height="2038" data-path="images/documentation/settings/api-keys/api-keys-actions.png" />

***

## Delete a key

Deleting a key revokes it permanently. Any integration using the key will
receive `401 Unauthorized` responses.

<Steps>
  <Step title="Find the key">
    In the **API Keys** tab, locate the key you want to delete.
  </Step>

  <Step title="Delete">
    Open the key's action menu and select **Delete**. Confirm the action.
  </Step>
</Steps>

***

## Permissions

Each key is created with the `tickets:read` permission, which grants read-only
access to the [Tickets API](/guides/integrations/tickets-api).

***

## See also

* [Tickets API](/guides/integrations/tickets-api): Query tickets
  programmatically with filtering, sorting, and pagination
* [User Management](/documentation/settings/user-management): Manage user access
  and roles