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

# Developer Zone

> Create and manage API tokens for your Enterprise organisation.

## Overview

**Developer Zone** is where Enterprise organisations create and manage API tokens for the 9Pic API. Each token lets an external service (your website, a partner app, an internal tool) read your organisation's data through the API.

<Warning>
  **Enterprise plan only.** Developer Zone is available on the Enterprise plan. On Trial, Pay As You Go, and Pro, the sidebar item is faded with a **lock** icon — clicking it shows an **Enterprise Plan Required** message instead of opening the page. Contact 9Pic to upgrade.
</Warning>

<Frame caption="Developer Zone on an Enterprise organisation">
  <img src="https://assets.9pic.ai/docs/dashboard-guide/developer-zone/developer-zone-landing.webp" alt="Developer Zone page on an Enterprise organisation showing the Admin API Tokens card with an empty state and Create Token button" />
</Frame>

## Open Developer Zone

<Steps>
  <Step title="Open the dashboard">
    Log in to [admin.9pic.ai](https://admin.9pic.ai).
  </Step>

  <Step title="Select your Enterprise organisation">
    Use the organisation selector in the sidebar. If your active organisation is not on Enterprise, Developer Zone shows an upgrade message instead.
  </Step>

  <Step title="Click Developer Zone">
    Click **Developer Zone** in the sidebar. The Admin API Tokens panel opens.
  </Step>
</Steps>

<Note>
  If no organisation is selected, the page asks you to choose one from the sidebar first.
</Note>

## Admin API Tokens

The Admin API Tokens panel lists every token your organisation has created. Each row shows:

| Column         | What it means                                                                                                 |
| :------------- | :------------------------------------------------------------------------------------------------------------ |
| **Token**      | The first five characters of the token followed by `***`. The full token is never shown again after creation. |
| **Status**     | **Active** (the token can be used) or **Inactive** (the token is paused and cannot be used).                  |
| **Created By** | The email of the team member who created the token.                                                           |
| **Created At** | The date the token was created.                                                                               |
| **Actions**    | An **Active/Inactive** toggle and a **Delete** button.                                                        |

The card header links to the **API documentation** in a new tab so developers can jump straight to authentication and endpoint details.

<Info>
  Each organisation can have up to **10 tokens** at a time. When you reach the limit, the **Create Token** button is disabled and a message tells you to delete an existing token first.
</Info>

## Create a Token

<Steps>
  <Step title="Click Create Token">
    In the Admin API Tokens card, click **Create Token** in the top right.
  </Step>

  <Step title="Confirm creation">
    A confirmation dialog explains that the full token will be shown only once. Click **Create Token** to continue, or **Cancel** to go back.
  </Step>

  <Step title="Copy the token">
    A second dialog shows the full token in a read-only field. Click the copy icon next to it to copy the token to your clipboard. Store it somewhere safe.
  </Step>

  <Step title="Click Done">
    Click **Done** to close the dialog. The new token now appears in the table with its masked preview and an **Active** status.
  </Step>
</Steps>

<Warning>
  The full token value is shown **only once**, right after it is created. After you close the dialog, only the masked preview is visible. If you lose a token, delete it and create a new one — there is no way to view the full value again.
</Warning>

<Tip>
  Use a separate token for each integration. That way you can deactivate or delete one without breaking the others.
</Tip>

## Activate or Deactivate a Token

Use the **Active/Inactive** switch in the token row to pause or resume a token without deleting it.

* Turn the switch **off** to deactivate the token. Any service using it loses access immediately.
* Turn the switch **on** to reactivate the token. The original token value continues to work.

<Note>
  Deactivating is reversible. If you only need to temporarily block a token (for example while you investigate a leak), deactivate it instead of deleting it.
</Note>

## Delete a Token

<Steps>
  <Step title="Find the token">
    Open Developer Zone and find the token row in the Admin API Tokens table.
  </Step>

  <Step title="Click the delete button">
    Click the red trash icon in the **Actions** column for that row.
  </Step>

  <Step title="Confirm deletion">
    Read the confirmation dialog. Click **Delete** to confirm, or **Cancel** to go back.
  </Step>
</Steps>

<Warning>
  Deletion is permanent. Any service still using the deleted token will immediately lose access to the API and cannot be recovered — you must create a new token and update those services.
</Warning>

## Use the Token with the API

Once you have a token, use it as a bearer credential when calling the 9Pic API. Endpoint details, request examples, and response shapes live in the **API Reference** tab of these docs.

<CardGroup cols={2}>
  <Card title="API Authentication" icon="key" href="/api-reference/authentication">
    How to send your token with each API request.
  </Card>

  <Card title="API Reference" icon="book" href="/api-reference">
    Endpoints, conventions, errors, and response models.
  </Card>
</CardGroup>

## Common Questions

<AccordionGroup>
  <Accordion title="Developer Zone looks greyed out with a lock. Why?">
    On Trial, Pay As You Go, and Pro plans the Developer Zone sidebar item stays visible but faded, with a **lock** icon and an "Enterprise plan required" tooltip. Clicking it shows an **Enterprise Plan Required** message instead of opening the page. Contact 9Pic to upgrade.
  </Accordion>

  <Accordion title="How many tokens can I create?">
    Each Enterprise organisation can have up to **10 active or inactive tokens** at a time. Delete an existing token if you need to create a new one beyond that limit.
  </Accordion>

  <Accordion title="I lost a token. Can I retrieve it?">
    No. The full token value is shown only once, right after creation. If you lose it, delete the token from the table and create a new one, then update any service that was using the old token.
  </Accordion>

  <Accordion title="What happens to API calls when I deactivate a token?">
    Calls using a deactivated token fail with an authentication error. Reactivate the token to restore access — the original token value continues to work.
  </Accordion>

  <Accordion title="Who can create or delete tokens?">
    Anyone who can open Developer Zone for the selected Enterprise organisation. The **Created By** column records the email of the team member who created each token.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="API Authentication" icon="key" href="/api-reference/authentication">
    Use your new token to call the 9Pic API.
  </Card>

  <Card title="Credits" icon="coins" href="/dashboard-guide/credits">
    Review your Enterprise plan, credits, and subscription details.
  </Card>
</CardGroup>
