---
title: "Create an API key"
method: POST
path: "/auth/create-key"
tags: ["Auth"]
---

# Create an API key

`POST /auth/create-key`

Create a new API key scoped to a team. The key inherits the team's access — projects created with it are owned by that team. The raw key is returned once, so store it securely. Omit both teamId and team to use your personal team.

## Request body

- object
  - `name` string — A label for the key.
  - `team` string — Team id or slug to scope the key to. The authenticated user must be a member. Defaults to your personal team.

## Response `200`

API key created

- object
  - `key` string, required — The raw API key. Shown once.
  - `keyPrefix` string, required — First 10 characters for identification.
  - `name` string, required

---

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