---
title: "Create API Key"
method: POST
path: "/api/v1/apikey"
tags: ["API Key"]
---

# Create API Key

`POST /api/v1/apikey`

Creates an API key and returns the Base64 encoded API key.
Expects the Base64 encoded master API key in the header.
Use the **master API key displayed** in the server console at startup.

WARNING: make sure to set the MASTER_KEY_SECRET environment variable to a secret, otherwise your generated API keys will be compromised.
For development purposes you may also use the SeekStorm server console command 'create' to create an demo API key 'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA='.

## Headers

- `apikey` string, required

## Request body

- object — Quota per API key
  - `indices_max` integer, required — number of indices per API key
  - `indices_size_max` integer, required — combined index size per API key in MB
  - `documents_max` integer, required — combined number of documents in all indices per API key
  - `operations_max` integer, required — operations per month per API key: index/update/delete/query doc
  - `rate_limit` integer, nullable — queries per sec per API key
  - `demo` boolean — create fixed demo api key instead of random api key for demo purposes (default=false)

## Response `200`

API key created, returns Base64 encoded API key

## Other responses

- `401` — master_apikey missing

---

[API](https://skmtc.net/seekstorm/apis/seekstorm-rest-api-documentation.md) · [All operations](https://skmtc.net/seekstorm/apis/seekstorm-rest-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/seekstorm/seekstorm-rest-api-documentation/versions/e27c994d79ce/schema)
