SnozeDevelopers
API referenceConnected Accounts

Connect one of your own accounts

Starts the provider's sign-in for an account that belongs to the caller alone: the result is a personal connected account, with no workspace install, no grant and nothing shared with anyone. Any workspace member may do this (a personal account needs no admin). Returns the sign-in URL to open; the callback sends the browser back to `redirectTo` inside the given workspace. Only Google Workspace is supported.

POST
/v1/me/connected-accounts/{provider}/connect

Authorization

apiKey
headerAuthorizationBearer <snoze_sk_…>

Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.

Path Parameters

provider*string

Request Body

application/json
  1. body
workspaceId*string
Lengthlength <= 200
redirectTo?|null
loginHint?|null

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X POST 'https://api.snoze.dev/v1/me/connected-accounts/string/connect' \  -H 'Content-Type: application/json' \  -d '{  "workspaceId": "string"}'
Example Response
{  "data": {    "url": "string",    "expiresAt": "string"  }}

Delete a connection

Removes the connection and its encrypted secret from the workspace; data sources and steps that referenced it fail on their next run rather than being rewritten. Requires `data_sources:write` and returns a not-found error for an unknown connection. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.

List my connected accounts

Returns every external account the signed-in user has connected, across all of their workspaces, with the workspaces each one is currently active in. Account-scoped rather than workspace-scoped: these credentials carry with the person, not the workspace. Encrypted secret material is never returned, only whether a secret is present and the account's health.