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

Update or rotate a secret

PUT
/v1/secrets/:id
PUT
/v1/secrets/:id
$curl -X PUT https://api.runtype.com/v1/secrets/id \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{}'
1{
2  "data": {
3    "id": "sec_9f8b7c6d5e4a3b2c1d0e",
4    "key": "DATABASE_PASSWORD",
5    "description": "Primary database password for production environment",
6    "valuePreview": "************",
7    "status": "active",
8    "version": 3,
9    "lastRotatedAt": "2024-06-10T09:15:00Z",
10    "phantomToken": "pt_4a3b2c1d0e9f8b7c6d5e",
11    "createdAt": "2023-12-01T12:00:00Z",
12    "updatedAt": "2024-06-10T09:15:00Z"
13  }
14}
Was this page helpful?
Previous

Delete a secret

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

idstringRequired

Request

This endpoint expects an object.
valuestringOptional8-10000 characters
descriptionstringOptional<=500 characters
expectedVersionintegerOptional>=0

Response

Secret updated
dataobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
500
Internal Server Error