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

Get secret metadata

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

Update or rotate a secret

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

idstringRequired

Response

Secret detail
dataobject

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error