Skip to content

List secrets​

GET
/v1/secrets

Names and metadata only. No endpoint in this API returns a secret value — a secret is write-only by construction, not by policy.

Authorizations​

apiKey

Scoped API key. Scopes are read ⊂ write ⊂ admin. A call needing more scope than the key holds returns 403 insufficient_scope.

Type
HTTP (bearer)

Parameters​

Query Parameters

cursor

Opaque pagination cursor; pass back next_cursor from the previous page.

Type
string
limit
Type
integer
Maximum
100
Default
50

Responses​

A page of secrets.

application/json
JSON
{
  
"data": [
  
  
{
  
  
  
"id": "sec_01JX9",
  
  
  
"name": "slack_token",
  
  
  
"description": "Slack incoming-webhook token",
  
  
  
"version": 1,
  
  
  
"created_at": "string",
  
  
  
"updated_at": "string"
  
  
}
  
],
  
"next_cursor": "string"
}

Playground​

Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

Emithook · a Finnoto product