putty
API ReferenceLedger

List the caller's pending secret requests

Returns the requests the model has made for a value, newest first. Each one is a prompt the dashboard renders as a secure input: the user types the value there, never in chat. The model is told only whether a request is `pending`, `set`, or `declined`; it never learns the value.

GET
/secrets/requests/requests

Returns the requests the model has made for a value, newest first. Each one is a prompt the dashboard renders as a secure input: the user types the value there, never in chat. The model is told only whether a request is pending, set, or declined; it never learns the value.

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

Query Parameters

status?string

Filter by status. Omit for all of the caller's requests.

Value in

  • "pending"
  • "set"
  • "declined"

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/secrets/requests/requests"
{  "requests": [    {      "id": "string",      "name": "string",      "description": "string",      "scope": "user",      "projectId": "string",      "status": "pending",      "createdAt": "string"    }  ]}