Get SDK connection status
Returns the current lifecycle state for an app-owned SDK connection. Pending connections self-heal to authorized when their underlying Curae-hosted handoff session has already completed.
/api/sdk/v1/connections/{connectionId}Returns the current lifecycle state for an app-owned SDK connection. Pending connections self-heal to authorized when their underlying Curae-hosted handoff session has already completed.
Authorization
platformApiKey CuraeAI Platform API key using the format Bearer . Keys are opaque credentials such as cae_live_..., not JWTs.
In: header
Path Parameters
Response Body
application/json
application/problem+json
curl -X GET "https://example.com/api/sdk/v1/connections/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "connection": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "customerAccountId": "d8c60791-7301-441c-98e8-5bea9a162d9b", "appUserId": "string", "status": "PENDING", "dataPackages": [ "clinical_summary" ], "authorizedAt": "2019-08-24T14:15:22Z", "expiresAt": "2019-08-24T14:15:22Z", "revokedAt": "2019-08-24T14:15:22Z", "actionRequiredReason": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }}{ "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "code": "string", "details": {}, "retryable": true}Create an SDK patient connection POST
Starts a connection-oriented Curae Connect flow for the SDK app's authenticated user coordinate. The response returns a durable `connection.id` used as `connectionId` in subsequent SDK gateway request bodies. If user action is required, `nextAction` contains a Curae-hosted webview URL to open.
Revoke an SDK connection POST
Monotonically revokes an app-owned SDK connection and terminates connection-authorized access. Internal enforcement artifacts are not exposed on the public API.