> ## Documentation Index > Fetch the complete documentation index at: https://exa.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > The Exa API is served at https://api.exa.ai. Authenticate with `Authorization: Bearer $EXA_API_KEY` (or `x-api-key: $EXA_API_KEY`); create keys at https://dashboard.exa.ai/api-keys?utm_source=docs&utm_medium=docs&utm_campaign=markdown_instructions. Every way an agent can get access to Exa is described at https://exa.ai/auth.md. > Prefer the official SDKs, `exa-py` (`pip install exa-py`) and `exa-js` (`npm install exa-js`); both read `EXA_API_KEY` from the environment. > Tool-using agents can call Exa without writing code through the hosted MCP server at https://mcp.exa.ai/mcp, or install the Exa agent skill with `npx skills add exa-labs/agent-skills` (skill file: https://exa.ai/docs/skill.md). > The OpenAPI specs at https://exa.ai/docs/exa-spec.yaml and https://exa.ai/docs/team-management-spec.yaml are the source of truth for request and response schemas. # Create API key > Create a new API key for your team with optional name and rate limit configuration. > [card] [Get your Exa API key](https://dashboard.exa.ai/api-keys?utm_source=docs\&utm_medium=docs\&utm_campaign=get_key_card) > > Create a key in the dashboard. New accounts start with free credits. > [!NOTE] > > The Team Management API is enabled per team. It authenticates with a service account API key, which is created from the **Service keys** tab on the [API keys page](https://dashboard.exa.ai/api-keys?utm_source=docs\&utm_medium=docs\&utm_campaign=team_management_access) once the feature is enabled for your team. Contact [support@exa.ai](mailto:support@exa.ai) to request access. ## OpenAPI ````yaml team-management-spec.yaml POST /api-keys openapi: 3.1.0 info: version: 1.0.0 title: Team Management API description: >- API for managing API keys within teams. Provides CRUD operations for creating, listing, updating, and deleting API keys with team-based access controls. The API is enabled per team. Contact support@exa.ai to request access. servers: - url: https://admin-api.exa.ai/team-management security: - apikey: [] paths: /api-keys: post: tags: - Team Management summary: Create API key description: >- Creates a new API key for the authenticated team. Optionally specify a name, rate limit, and budget for the API key. The response returns the new key in `secret`. Use `publicId` to refer to the key in later requests. operationId: create-api-key requestBody: required: true content: application/json: schema: type: object properties: name: type: string description: Optional name for the API key example: Production API Key rateLimit: type: integer description: Optional rate limit for the API key (requests per second) example: 1000 budgetCents: type: - integer - 'null' minimum: 0 description: >- Optional spending budget for the API key in the team's current billing period, in cents. It resets when the next billing period starts. Set to null to remove the budget. example: 5000 additionalProperties: false responses: '200': description: API key created successfully content: application/json: schema: type: object properties: apiKey: type: object properties: id: type: string format: uuid deprecated: true description: >- Same value as `secret`, kept for backward compatibility. Use `publicId` to identify the key. publicId: type: string description: >- Stable identifier of the API key. Use it in `/api-keys/{id}` paths. It does not change when the key is rotated. example: key_a1B2c3D4e5F6g7H8i9J0 secret: type: string description: >- The API key. Send it in the `x-api-key` header of Exa API requests and keep it in your secrets manager. name: type: string description: Name of the API key rateLimit: type: - integer - 'null' description: Rate limit in requests per second budgetCents: type: - integer - 'null' description: >- Spending budget for the API key in the team's current billing period, in cents isOverBudget: type: boolean description: Whether the API key is currently over its budget teamId: type: string format: uuid description: Team ID this key belongs to userId: type: string format: uuid description: User ID who created this key createdAt: type: string format: date-time description: When the key was created '400': description: Bad Request - Invalid parameters content: application/json: schema: type: object properties: error: type: string examples: - No user found for team - Rate limit cannot exceed team's limit of 500 QPS - >- Unexpected parameters: invalidParam. Allowed: name, rateLimit, budgetCents. '401': description: Unauthorized - Invalid or missing service key content: application/json: schema: type: object properties: error: type: string example: Unauthorized security: - apikey: [] x-codeSamples: - lang: bash label: Create API key with name and rate limit source: | curl -X POST 'https://admin-api.exa.ai/team-management/api-keys' \ -H 'x-api-key: YOUR-SERVICE-KEY' \ -H 'Content-Type: application/json' \ -d '{ "name": "Production API Key", "rateLimit": 1000 }' - lang: python label: Create API key with name and rate limit source: | import requests headers = { 'x-api-key': 'YOUR-SERVICE-KEY', 'Content-Type': 'application/json' } data = { 'name': 'Production API Key', 'rateLimit': 1000 } response = requests.post( 'https://admin-api.exa.ai/team-management/api-keys', headers=headers, json=data ) print(response.json()) - lang: javascript label: Create API key with name and rate limit source: > const response = await fetch('https://admin-api.exa.ai/team-management/api-keys', { method: 'POST', headers: { 'x-api-key': 'YOUR-SERVICE-KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ name: 'Production API Key', rateLimit: 1000 }) }); const result = await response.json(); console.log(result); - lang: bash label: Create API key without optional parameters source: | curl -X POST 'https://admin-api.exa.ai/team-management/api-keys' \ -H 'x-api-key: YOUR-SERVICE-KEY' \ -H 'Content-Type: application/json' \ -d '{}' components: securitySchemes: apikey: type: apiKey in: header name: x-api-key description: Service API key for team authentication ````