---
title: "Create Key"
method: POST
path: "/v1/projects/{project_id}/keys"
tags: ["keys"]
---

# Create Key

`POST /v1/projects/{project_id}/keys`

## Request

- Base URL: `https://api.sonenta.dev`
- URL: `https://api.sonenta.dev/v1/projects/{project_id}/keys`
- Auth: none declared

## Path parameters

- `project_id` string, required

## Request body

- AppRoutesKeysKeyCreateIn
  - `namespace_uuid` string, required
  - `name` string, required
  - `description` string, nullable
  - `context` string, nullable
  - `plurals` boolean
  - `max_length` integer, nullable
  - `screenshots` string[]
  - `type` 'text' | 'heading' | 'label' | 'caption' | 'badge' | 'tooltip' | 'error_message' | 'toast' | 'button' | 'link' | 'menu_item' | 'input_placeholder' | 'input_label' | 'image' | 'icon' | 'meta_title' | 'meta_description'
  - `type_source` 'default' | 'detected' | 'manual', nullable

## Response `201`

Successful Response

- KeyOut
  - `uuid` string, required
  - `project_uuid` string, required
  - `namespace_uuid` string, required
  - `name` string, required
  - `description` string, nullable, required
  - `context` string, nullable, required
  - `plurals` boolean, required
  - `max_length` integer, nullable, required
  - `screenshots` string[], required
  - `type` 'text' | 'heading' | 'label' | 'caption' | 'badge' | 'tooltip' | 'error_message' | 'toast' | 'button' | 'link' | 'menu_item' | 'input_placeholder' | 'input_label' | 'image' | 'icon' | 'meta_title' | 'meta_description'
  - `type_source` 'default' | 'detected' | 'manual'
  - `type_detected_at` string, date-time, nullable
  - `type_analyzed_at` string, date-time, nullable
  - `type_analyzed_scan_id` string, nullable
  - `status` 'active' | 'archived', required
  - `deleted_at` string, date-time, nullable
  - `deleted_by_uuid` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `referenced` boolean, nullable
  - `orphan` boolean, nullable

## Other responses

- `422`: Validation Error

---

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