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

# DialNexa API Keys

> Create and manage DialNexa API keys, including key names, one-time raw key display, edit, delete, and regenerate behavior for existing keys.

DialNexa API keys are organization-level credentials used by external systems to access DialNexa APIs. The Keys page lets users create named keys, see the raw key once, copy it immediately, edit key names, delete keys, and create a new key with expiration behavior for previous keys.

<Warning>
  The raw API key is shown once. Once the dialog closes, the dashboard will not be your memory palace.
</Warning>

## API Key Actions

These actions are available from the Keys page.

| Action             | Behavior                                                        |
| ------------------ | --------------------------------------------------------------- |
| Create first key   | Creates a named API key and shows the raw key once.             |
| Create another key | Asks whether to expire the previous key now or in 24 hours.     |
| Copy raw key       | Copies the newly created key while the one-time dialog is open. |
| Edit key name      | Changes the label used in the table.                            |
| Delete key         | Removes the selected key.                                       |

## Create A Key Safely

<Steps>
  <Step title="Open Keys">
    Use the workspace where the external system should connect.
  </Step>

  <Step title="Choose Add Key then API Key">
    Enter a name that identifies the system or environment.
  </Step>

  <Step title="Copy the raw key immediately">
    Store it in your secret manager.
  </Step>

  <Step title="Close the dialog only after storing">
    The raw key will not be shown again.
  </Step>

  <Step title="Rotate old keys intentionally">
    Use now or 24 hour expiration based on migration risk.
  </Step>
</Steps>

## API Key Mistakes

<AccordionGroup>
  <Accordion title="Using a key from another workspace">
    Keys are organization-scoped.
  </Accordion>

  <Accordion title="Naming every key production">
    Use system and environment names.
  </Accordion>

  <Accordion title="Closing before copying">
    Create a new key and rotate if the raw value was lost.
  </Accordion>

  <Accordion title="Sharing in chat">
    Use a secret manager, not messages or docs.
  </Accordion>
</AccordionGroup>

## Related Reading

<CardGroup cols={2}>
  <Card title="Key Rotation" icon="refresh-cw" href="/api-access/key-rotation">
    Rotate keys safely.
  </Card>

  <Card title="Webhook Secrets" icon="key-round" href="/api-access/webhook-secrets">
    Manage event verification secrets.
  </Card>

  <Card title="External Webhooks" icon="webhook" href="/api-access/external-webhooks">
    Configure event receivers.
  </Card>
</CardGroup>