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

# Create API key

`POST /api/api-key`

## Request body

- CreateApiKeyInputDto
  - `description` string, required
  - `role` 'USER' | 'QUANTIFIER' | 'FORWARDER' | 'ADMIN' | 'ROOT' | 'API_KEY_READWRITE' | 'API_KEY_READ' | 'API_KEY_DISCORD_BOT' | 'API_KEY_SETUP_WEB', required

## Response `201`

API key created

- CreateApiKeyResponseDto
  - `_id` string, required
  - `name` string, required
  - `description` string, required
  - `hash` string, required
  - `role` 'USER' | 'QUANTIFIER' | 'FORWARDER' | 'ADMIN' | 'ROOT' | 'API_KEY_READWRITE' | 'API_KEY_READ' | 'API_KEY_DISCORD_BOT' | 'API_KEY_SETUP_WEB', required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `key` string, required

---

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