Before You Start
- Changing
authType: Changing theauthTypedeletes all existing user connections to this integration. Users will need to reconnect.
Base URL
Required Scopes
This endpoint requires theINTEGRATION_API scope.
Parameters
Path Parameters
Request Body
Auth Types
Auth Field Schema
Each auth field defines a credential input that users fill in when connecting to the integration.The
slug must be unique within the integration. The field id is auto-generated — do not include it in the request.Field Types
OAuth Client Schema
Only relevant whenauthType is OAUTH or OAUTH_DCR.
Example: API Key Authentication
Response Format
Success Response (200 OK)
Behavior
- Auth fields are fully replaced on every call — the entire array is deleted and recreated.
- Changing
authTypedeletes all existing user connections and any previous OAuth client configuration. - Setting
authTypetoNONE,API_KEY, orSERVICE_ACCOUNTdeletes any existing OAuth client. - OAuth credentials (
clientId,clientSecret) are encrypted before storage.
Error Handling
Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on API Key Best Practices.