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

Submit secret values from intake screen

POST
/v1/secrets/intake/submit
POST
/v1/secrets/intake/submit
$curl -X POST https://api.runtype.com/v1/secrets/intake/submit \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "source": {
>    "type": "manual"
>  },
>  "items": {
>    "0": {},
>    "value": [
>      {}
>    ]
>  }
>}'
1{
2  "success": true,
3  "manifest": {
4    "source": {
5      "type": "manual",
6      "key": "intake-session-202406",
7      "productId": "prod_987654321"
8    },
9    "title": "Database Credentials Intake",
10    "items": [
11      {
12        "itemId": "db_password",
13        "secretKey": "DB_PASSWORD",
14        "status": "configured",
15        "secretId": "sec_123abc",
16        "displayName": "Database Password",
17        "description": "Password for the primary database user",
18        "required": true,
19        "placeholder": "Enter your database password",
20        "helpText": "Use a strong password with at least 12 characters",
21        "docsUrl": "https://runtype.com/docs/secrets/database-password",
22        "version": 3
23      }
24    ],
25    "configurationStatus": "configured",
26    "pendingConfigurationCount": 0,
27    "description": "Manifest for submitted database secret values",
28    "returnUrl": "https://app.runtype.com/secrets/dashboard",
29    "handoff": {
30      "type": "url",
31      "url": "https://app.runtype.com/secrets/handoff/session/abc123",
32      "expiresAt": "2024-07-01T12:00:00Z"
33    }
34  }
35}
Was this page helpful?
Previous

Generate dashboard URL for configuring missing secrets

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Request

This endpoint expects an object.
sourceobjectRequired
itemslist of objectsRequired
returnUrlstringOptional

Response

Submit result with refreshed manifest
successboolean
manifestobject

Errors

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