POST /v1/secrets

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

description?string

Lengthlength <= 500

value*string

The credential. Write-only: no endpoint ever returns it. Printable ASCII, space or tab only (it is written verbatim into a request header).

Lengthlength <= 4096

allow*array<string>

Exact hostnames. No wildcards.

Items1 <= items <= 32

headers*array<string>

Items1 <= items <= 16

on_echo?string

Default"block"

Value in

"block"
"redact"

Response Body

`application/json`

curl -X POST "https://example.com/v1/secrets" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "value": "string",    "allow": [      "string"    ],    "headers": [      "string"    ]  }'

{  "id": "string",  "name": "string",  "description": "string",  "current_gen": 0,  "allow": [    "string"  ],  "headers": [    "string"  ],  "on_echo": "block",  "created_at": "string",  "created_by": "string",  "last_used_at": "string"}

Empty

Authorization

Request Body

Response Body

201application/json

401

`application/json`