Disconnect an app
Disconnects one app: revokes its OAuth grant with its access and refresh tokens, so the app must sign in again. Other apps stay connected. Disconnecting the calling app (`current`) ends its own access. To disconnect every app, sign out everywhere with `POST /me/sign-out`. Personal access tokens cannot call this endpoint.
/me/connections/{id}Authorization
bearerAuth Send Authorization: Bearer <token> with one of: an app session access token from /auth/verify-otp or /auth/refresh; an OAuth access token from /oauth/token issued for the API origin (its scopes are its permissions); or a personal access token starting with optima_pat_ (see /docs/personal-access-tokens). Personal access tokens cannot create or list tokens, revoke other tokens, sign out, or delete or restore the account. Content routes need the permission of their layer: audio:read/audio:write for recordings, turns:read/turns:write for turns, contacts, source signals, and events, and insights:read/insights:write for suggestions and session summaries; search and recall need turns:read and insights:read. A request without the permission, or for an account whose layer is turned off, returns 403 FORBIDDEN. See /docs/authentication#scopes.
In: header
Path Parameters
^[A-Za-z0-9_-]{8,128}$Header Parameters
Send 1 to pin the documented API contract. If omitted, the latest version is selected.
"1"Value in
- "1"
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/me/connections/string" \ -H "X-API-Version: 1"List connected apps GET
Lists the apps connected to your account, newest first: one item per OAuth grant. Each installation of an Optima app is its own connection; a third-party app has one. `current` marks the grant of the calling app. Uses the usual `limit` and `cursor` pagination. Personal access tokens cannot call this endpoint.
Restore your account POST
Restores a deleted account. Before its `erase_at` the account comes back with all its data, its private workspace, and the webhook endpoints the deletion disabled; after that it starts with a new, empty private workspace. Revoked tokens and OAuth grants stay revoked. Restoring an active account has no effect.