Get product configuration summary | Runtype Documentation

{
  "configurationStatus": "configured",
  "configurationUrl": "https://dashboard.runtype.com/products/12345/configure",
  "pendingConfigurationCount": 0,
  "productId": "12345",
  "productName": "Runtype AI Assistant",
  "requirements": [
    {
      "itemId": "weather_api_key",
      "secretKey": "apiKey",
      "status": "configured",
      "description": "API key for accessing the external weather service",
      "displayName": "Weather API Key",
      "docsUrl": "https://docs.weatherapi.com/authentication",
      "helpText": "Enter your Weather API key here to enable weather data integration.",
      "placeholder": "Enter your API key",
      "required": true,
      "secretId": "secret_98765",
      "version": 2
    }
  ],
  "handoff": {
    "expiresAt": "2024-07-01T12:00:00Z",
    "type": "url",
    "url": "https://external-service.com/handoff/abc123"
  }
}

Get the secret configuration summary for a product. Never returns secret values — used to decide whether to show a “Configure secrets” prompt.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired

Response

Configuration summary

configurationStatusenum

configurationUrlstring

pendingConfigurationCountinteger>=0

productIdstring

productNamestring

requirementslist of objects

handoffobject

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error

$	curl https://api.runtype.com/v1/products/id/configuration \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json"