integrations

Create or update an OAuth integration connection for the signed-in user.

Create or update an OAuth integration connection for the signed-in user. Names are normalized to a canonical lowercase-kebab provider key. Partial updates merge into the existing connection; matching client credentials reuse a shared OAuth app across connections. Do not persist access or refresh tokens here or with secretSet — /connect/oauth and integrationTokenRefresh write those on the connection. authorization.scopes is reconnect metadata: the list the next /connect/oauth visit requests, not the current access token. After widening scopes, tell the user the token is unchanged until they reconnect, then ask whether to reconnect each affected account at /connect/oauth?provider=<connection-name>. Scopes are per connection; sibling accounts that share an OAuth app keep their own lists. This capability cannot change usageMode or add requiredHosts / retarget tokenUrl to an unapproved host. Platform (built-in) connections cannot be updated here — reconnect at /connect/oauth?provider=<name> to change scopes, or integrationDelete first to replace with a bring-your-own app.

Org permission: integration:write.

put/v1/integrations/{name}

Request

  • Base URL: https://api.kody.codes
  • URL: https://api.kody.codes/v1/integrations/{name}
  • Auth: HTTP bearer

Path parameters

namestring required

Request body

tokenUrlstring uri
apiBaseUrlstring uri nullable
flow'pkce' | 'confidential' | 'device'
usePkceboolean nullable
clientIdstring
requiredHostsstring[]
tokenExchangeStyle'form' | 'basic-json' | 'basic-form' nullable
deviceAuthorizationUrlstring uri nullable
accountLabelstring nullable
logoBase64string nullable

Base64-encoded OAuth app logo (SVG, PNG, JPEG, or WebP). Kody fits the image to 256px WebP before storage. Omit to keep the current logo, pass null to clear it and re-fetch the provider favicon.

Response

Success.

Changes

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