---
title: "Store API keys once; values are encrypted and never returned. Actions: set (name, value, allowed_hosts), list, delete. Free: 25 secrets."
method: POST
path: "/api/v1/secrets"
tags: ["secrets"]
---

# Store API keys once; values are encrypted and never returned. Actions: set (name, value, allowed_hosts), list, delete. Free: 25 secrets.

`POST /api/v1/secrets`

## Request

- Base URL: `https://cloudforbots.com`
- URL: `https://cloudforbots.com/api/v1/secrets`
- Auth: HTTP bearer

## Request body

- object
  - `action` 'set' | 'list' | 'delete', required
  - `name` string
  - `value` string
  - `allowed_hosts` string[]

## Response `200`

ok

---

[API](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api.md) · [All operations](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api/revisions/1afdb5648693?raw)