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

Delete a secret

DELETE
/v1/secrets/:id
DELETE
/v1/secrets/:id
$curl -X DELETE https://api.runtype.com/v1/secrets/id \
> -H "Authorization: Bearer <token>" \
> -H "Content-Type: application/json" \
> -d '{}'
1{
2 "success": true,
3 "deletedId": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
4 "referenceCount": 0
5}
Was this page helpful?
Previous

Check which secret keys exist, are missing, or revoked

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

idstringRequired

Response

Secret deleted
successboolean
deletedIdstring
referenceCountinteger

Errors

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