Skip to main content

[Early Access] Clear wearable credentials

DELETE /v1/wearables/{provider}/credentials
devhttps://api.sandbox.ovok.com

Early Access — interfaces may change without notice.

Remove the stored OAuth credentials for a wearable provider. Existing patient connections that were issued under the old credentials keep working until their access tokens expire; the next webhook signature verification (Polar) or token refresh (both providers) will start to fail and the patient will need to reconnect. Admin-only.

Parameters

NameInTypeRequiredDescription
providerpathstringyesWearable provider slug whose stored credentials should be cleared. Currently strava or polar.

Responses

CodeDescription
200Success.
400The request could not be operated by the server.
401The resource owner or authorization server denied the request.
404The requested resource could not be found.
422The request could not be validated by the server.
500The server encountered an unexpected condition. Please try again later.

200WearableCredentialsStatusDto (application/json)

Status view of a project's wearable OAuth credentials. Returned by GET / PUT / DELETE — raw secrets are never surfaced, only their presence and the last 4 chars of the stored clientId.

  • configured: boolean (required) — True when both clientId and clientSecret are on file for this provider.
  • clientIdLast4: string (required) — Last 4 characters of the stored clientId, for visual confirmation. null when no clientId is on file.
  • hasSecret: boolean (required) — True when a clientSecret is on file. The value itself is never returned.
  • hasWebhookSecret: boolean (required) — True when a webhookSecret is on file. Required for inbound signature verification on Polar; optional on Strava.

Example

{
"configured": true,
"clientIdLast4": "XY34",
"hasSecret": true,
"hasWebhookSecret": true
}