---
title: "Create Secret"
method: POST
path: "/secrets"
tags: ["secrets", "Secrets"]
---

# Create Secret

`POST /secrets`

Create Secret

## Response `201`

The Secrets object.

- SecretEntity — SecretEntity model
  - `id` integer — Secret ID.
  - `workspace_id` integer — Workspace ID. 0 means the default workspace.
  - `name` string — Secret name.
  - `description` string — Internal description for your reference.
  - `secret_type` 'basic' | 'token' | 'headers' | 'certificate' | 'key_value' — Secret type.
  - `metadata` object — Non-secret metadata for the Secret type.
  - `value_field_names` string[] — Names of configured secret value fields. Secret values are never returned.
  - `created_at` string, date-time — Secret create date/time.
  - `updated_at` string, date-time — Secret update date/time.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `405` — Method Not Allowed
- `409` — Conflict
- `412` — Precondition Failed
- `422` — Unprocessable Entity
- `423` — Locked
- `429` — Too Many Requests

---

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