putty
API ReferenceLedger

Ask the user for a secret

Creates a request for the user to enter a value in the dashboard. The value is never part of this request and never comes back through it: the user types it into a secure input, which stores it with `PUT /secrets/{name}` and marks the request `set`.

POST
/secrets/requests

Creates a request for the user to enter a value in the dashboard. The value is never part of this request and never comes back through it: the user types it into a secure input, which stores it with PUT /secrets/{name} and marks the request set.

Authorization

bearerAuth
AuthorizationBearer <token>

A bearer token. The Account routes accept a Privy access token; the MCP transport accepts an sk- API key issued by POST /account/api-keys.

In: header

Request Body

application/json

The name to ask for and why the value is needed.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/secrets/requests" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "description": "string"  }'
{  "id": "string",  "name": "string",  "description": "string",  "scope": "user",  "projectId": "string",  "status": "pending",  "createdAt": "string"}