For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
User GuideDeveloper GuidesAPI Reference
User GuideDeveloper GuidesAPI Reference
    • Overview
  • Runtype API
      • GETList secrets (metadata only)
      • POSTCreate a secret
      • GETGet secret metadata
      • PUTUpdate or rotate a secret
      • DELDelete a secret
      • POSTCheck which secret keys exist, are missing, or revoked
      • POSTGet intake manifest for secret configuration
      • POSTSubmit secret values from intake screen
      • POSTGenerate dashboard URL for configuring missing secrets
Dashboard
LogoLogo
Runtype APISecrets

List secrets (metadata only)

GET
/v1/secrets
GET
/v1/secrets
$curl https://api.runtype.com/v1/secrets \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json"
1{
2  "data": [
3    {
4      "id": "a3f1c9e2-7b4d-4f8a-9d2e-5b6c7d8e9f01",
5      "key": "DATABASE_PASSWORD",
6      "description": "Password for the production database",
7      "valuePreview": "************",
8      "status": "active",
9      "version": 3,
10      "lastRotatedAt": "2024-05-10T12:45:00Z",
11      "phantomToken": "pt_9f8e7d6c5b4a3e2d1c0b",
12      "createdAt": "2023-11-01T08:30:00Z",
13      "updatedAt": "2024-05-10T12:45:00Z"
14    }
15  ],
16  "total": 1
17}
Was this page helpful?
Previous

Create a secret

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Response

Secrets list
datalist of objects
totalinteger

Errors

401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error