---
title: "POST /v1/secret"
method: POST
path: "/v1/secret"
tags: ["secret"]
---

# POST /v1/secret

`POST /v1/secret`

## Request

- Base URL: `https://api.octoai.cloud`
- URL: `https://api.octoai.cloud/v1/secret`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/octoml/apis/octoai-api/docs/v1/secret/post.ts> (a function with typed inputs; its response is checked against the schema)

Create new secret

## Request body

- SecretKeyValue
  - `key` string, required: Secret key
  - `value` string, required: Secret value

## Response `201`

A description of the new secret

- SecretKeyValue
  - `key` string, required: Secret key
  - `value` string, required: Secret value

---

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