Issue embedded app runtime token

Issues or refreshes a short-lived runtime API key for the public app host page. The response is intended to stay in memory and be forwarded to the iframe after the iframe runtime signals readiness.

POST/api/v1/experimental/apps/{handle}/runtime-token

Issues or refreshes a short-lived runtime API key for the public app host page. The response is intended to stay in memory and be forwarded to the iframe after the iframe runtime signals readiness.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

appSessionId?string

Response Body

`application/json`

curl -X POST "https://loading/api/v1/experimental/apps/{handle}/runtime-token" \  -H "Content-Type: application/json" \  -d '{}'

{
  "apiKey": "andi_runtime_live_123",
  "baseApiUrl": "https://andiapi.com/api/v1/experimental",
  "workspaceHandle": "acme-growth-team",
  "permissions": {
    "data": [
      "read"
    ]
  },
  "accessMode": "public",
  "expiresAt": "2026-03-08T16:05:00.000Z",
  "refreshAfter": "2026-03-08T16:04:00.000Z",
  "appSessionId": "appsess_123"
}

{
  "issues": [
    {
      "_tag": "Pointer",
      "path": [
        "string"
      ],
      "message": "string"
    }
  ],
  "message": "string",
  "_tag": "HttpApiDecodeError"
}

{
  "code": "not_found",
  "message": "The requested resource was not found."
}

{
  "code": "internal_error",
  "message": "An unexpected server error occurred."
}

Issue embedded app runtime token

Request Body

Response Body

200application/json

400application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`