---
title: "Create a project key"
method: POST
path: "/v0/projects/{project}/keys"
tags: ["projects", "keys"]
---

# Create a project key

`POST /v0/projects/{project}/keys`

Create a new API key for a project. The plaintext key is only returned once in the response. Requires `manage` permission on the project.

## Path parameters

- `project` string, required

## Request body

- JsonNewProjectKey
  - `name` string, required
  - `ttl` integer, nullable — The time-to-live (TTL) for the key in seconds. If not provided, the key will not expire for over 128 years.

## Response `201`

successful creation

- JsonProjectKeyCreated
  - `creation` string, date-time, required
  - `expiration` string, date-time, required
  - `key` string, required
  - `name` string, required
  - `project` string, uuid, required
  - `uuid` string, uuid, required

## Other responses

- `4XX` — Error
- `5XX` — Error

---

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