putty
API ReferenceLedger

List the caller's secrets

Returns the caller's secrets by name and metadata. Values are never included at any depth. Pass `?projectId=` to include that project's secrets as well; a project secret and a user secret of the same name both appear, and the project one is the one that wins inside that project.

GET
/secrets

Returns the caller's secrets by name and metadata. Values are never included at any depth. Pass ?projectId= to include that project's secrets as well; a project secret and a user secret of the same name both appear, and the project one is the one that wins inside that project.

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

projectId?string

Include this project's secrets in the response alongside the user-scoped ones.

Length1 <= length

Response Body

application/json

application/json

application/json

application/json

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