---
title: "Create a developer API key"
method: POST
path: "/v1/keys"
tags: ["Keys"]
---

# Create a developer API key

`POST /v1/keys`

## Request

- Base URL: `https://api.fairly.gg`
- URL: `https://api.fairly.gg/v1/keys`
- Auth: none declared

Returns the key once, in plain text. Only its SHA-256 hash is stored. Limited to 3 keys per IP per day.

## Request body

- CreateKeyRequest
  - `email` string, nullable, required
  - `project_name` string, nullable, required

## Response `201`

Created

- CreatedKeyModel
  - `api_key` string, required
  - `daily_quota` integer, required
  - `rate_limit_per_minute` integer, required
  - `created_at` string, date-time, required
  - `notice` string, required

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/fairly/apis/fairly-api.md) · [All operations](https://skmtc.dev/fairly/apis/fairly-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fairly/apis/fairly-api/revisions/9b21c64dffa2?raw)