Disconnect a hosted connection and optionally revoke provider token

post/connections/{connection_id}/disconnect

Request

  • Base URL: https://api.gravityads.dev (the document declares no server; this is the origin it was published from)
  • URL: https://api.gravityads.dev/connections/{connection_id}/disconnect
  • Auth: HTTP bearer

Request body

confirmation'disconnect connection' required

Required guardrail for disconnecting a stored OAuth connection.

reasonstring
revoke_provider_tokenboolean

When true, attempts a redacted provider token revoke before marking the connection disconnected.

Response

Connection disconnect result

status'connection_disconnected' | 'connection_disconnect_not_found' | 'connection_disconnect_unconfigured' | 'connection_disconnect_degraded' required
sourcestring
tenant_idstring required
connection_idstring required
disconnected_countinteger required
database_url_configuredboolean required
platform_revoke_calledboolean required
hosted_auth_contextobject
raw_secrets_returnedfalse required

Changes

No recorded changes to this operation across all 1 revision of this API.