Applications API

Applications represent SaaS products or environments.

List Applications

GET /v1/applications

Returns the applications visible to the current account.

Create Application

POST /v1/applications
Content-Type: application/json

{
  "name": "Acme SaaS",
  "routingMode": "proxy",
  "proxyOriginUrl": "https://app.example.com",
  "proxyRewriteRedirects": true,
  "proxyPreserveHost": false
}

The response includes an app secret once:

{
  "application": {
    "id": "app_123",
    "name": "Acme SaaS"
  },
  "secret": "cdk_sk_..."
}

Store the secret only on your server.

Get Application

GET /v1/applications/:applicationId

Update Application

PATCH /v1/applications/:applicationId
Content-Type: application/json

{
  "name": "Acme SaaS",
  "proxyOriginUrl": "https://app.example.com",
  "proxyRewriteRedirects": true,
  "proxyPreserveHost": false
}

Rotate Application Secret

POST /v1/applications/:applicationId/secret

The response includes the new secret once. Existing setup-session signing code must be updated immediately.

Delete Application

DELETE /v1/applications/:applicationId

Returns 204 No Content after the application is removed.