Mixedbread

Reconnect Gmail

Start Gmail OAuth that refreshes one installation's credentials, keeping its store.

GET
/v1/integrations/gmail/installations/{installation_id}/oauth/authorize

The person must sign in with the Google account already connected to the installation; the return URL otherwise reports error=reconnect_account_mismatch.

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

Api key to access Mixedbreads API

Path Parameters

installation_id*Installation Id

Gmail installation ID

Formatuuid

Query Parameters

reference?|

Opaque value echoed back as reference on the return URL, so your app can match the outcome to the user who started the flow

Response Body

Redirect to Google OAuth

response?unknownapplication/json
Example Request
curl -s -o /dev/null -w '%{redirect_url}' \
  'https://api.mixedbread.com/v1/integrations/gmail/installations/2f1c9a8e-6b4d-4e3a-9c1f-7d8e5b6a4c21/oauth/authorize?reference=user-42' \
  -H 'Authorization: Bearer YOUR_API_KEY'
Example Response
null