---
title: "POST /v1/projects/{projectOrProductUID}/secrets"
method: POST
path: "/v1/projects/{projectOrProductUID}/secrets"
tags: ["project"]
---

# POST /v1/projects/{projectOrProductUID}/secrets

`POST /v1/projects/{projectOrProductUID}/secrets`

Create a new project secret

## Request body

- CreateProjectSecretRequest
  - `name` string, required — The secret name (alphanumeric and underscores only).
  - `value` string, required — The secret value (encrypted at rest, never returned after creation).

## Response `201`

Secret created successfully

- ProjectSecret — Metadata for a project secret. The value is never returned.
  - `created` string, date-time, required — When the secret was first created.
  - `created_by` string, required — The actor who created the secret.
  - `modified` string, date-time — When the secret was last updated.
  - `modified_by` string — The actor who last updated the secret.
  - `name` string, required — The secret name (alphanumeric and underscores only).

## Other responses

- `400` — The response body in case of an API error.
- `409` — The response body in case of an API error.
- `default` — The response body in case of an API error.

---

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