This guide will help you create and manage API keys for the Writer API. All actions are performed in AI Studio.

​
About API keys

The Writer API uses token authentication for API requests. API keys are used as tokens, which you pass in the Authorization header of your requests: 
Authorization: Bearer <api-key>

​
API agents and API keys

Writer API keys are attached to AI Studio API agents. API permissions and scopes are set at the agent level. Within an API-based agent, you can create multiple API keys that share the permissions of the agent. To create keys with different permissions, create multiple API agents.

​
Create an API agent

  1. From the AI Studio home page, click on API Keys in the navigation menu. Select API Keys from the AI Studio home page
  2. Click the Create API agent button in the top right corner of the page. Click Create API agent button in right corner of the page
  3. Click on the agent’s name to rename it to something descriptive, and provide a short description of your agent to help you keep track of what it does. Rename the agent and provide a short description

​
Create an API key

Each API agent has a default API key, called Production. To create additional API keys:
  1. Navigate to the API application. From the AI Studio home page, click on API Keys in the navigation menu.
  2. Click on the API agent’s tile you want to generate a new key for.
  3. Click on Generate a new key. Click Generate a new key
  4. Give the key a name and click Generate.
  5. To see the API key value, click on Reveal key next to the key name. Click Reveal key to see the API key value
Store the API key in a secure location. We recommend using a .env file to store the key.

​
See your API agents and API keys

  1. From the AI Studio home page, click on API Keys in the navigation menu.
  2. Click on an individual agent’s tile to navigate to the agent. Click on an individual agent's tile to navigate to the agent
  3. To see the API key value, click on Reveal key next to the key name.

​
Manage API agent permissions

API permissions are set at the agent level. To manage API agent permissions:
  1. From the AI Studio home page, click on API Keys in the navigation menu.
  2. Click on an individual agent’s tile to navigate to the agent.
  3. Under Capabilities, toggle to enable or disable a specific capability for the API key. Toggle to enable or disable a specific capability for the API key
    Capabilities map to Writer API endpoints. Click Read more in the API Documentation column to learn more about the specific endpoints.

​
Delete an API agent

To delete an API agent:
  1. From the AI Studio home page, click on API Keys in the navigation menu.
  2. Click on the dropdown menu (…) next to the agent you want to delete, and select Delete. Click on the dropdown menu (...) next to the agent you want to delete, and select Delete
  3. Confirm the deletion by clicking Delete.

​
Delete an API key

To delete an API key:
  1. From the AI Studio home page, click on API Keys in the navigation menu.
  2. Click on an individual agent’s tile to navigate to the agent.
  3. Click on the dropdown menu (…) next to the key you want to delete, and select Revoke. Click on the dropdown menu (...) next to the key you want to delete, and select Revoke
  4. Confirm the deletion by clicking Revoke key.