---
title: "Registers an API Key"
method: POST
path: "/superuser/api-keys"
tags: ["API Keys"]
---

# Registers an API Key

`POST /superuser/api-keys`

Register an API Key for the user. User should input a name for the key, include an RSA Public Key in .pem format, and a signature which is obtained by signing the SHA256 hash of the name, used to verify that your Public Key works as expected

## Request body

- CreateApiKeyInput
  - `name` string, required
  - `signature` string, required
  - `publicKey` string, required

## Response `201`

API key registered

- CreateApiKeyOutput
  - `apiKey` string

## Other responses

- `400` — Input could not be validated
- `401` — Authorization failure
- `429` — Rate limited
- `500` — Error internal to the server which probably shouldn't have happened, try again later

---

[API](https://skmtc.net/brla/apis/brla-superuser-api.md) · [All operations](https://skmtc.net/brla/apis/brla-superuser-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brla/brla-superuser-api/revisions/236b95ba5c14/schema)