Update an Integration

Update an existing custom Integration by ID. Every update request must include the application authentication parameters.

Method Signature

Integration update(String id, String name, IntegrationConfiguration oauthConfig);

Parameters

ParameterTypeDescription
idStringThe id of the Integration to update
nameStringThe display name to apply to the Integration
oauthConfigIntegrationConfigurationThe configuration settings for the Integration
returnsIntegrationThe updated Integration

IntegrationConfiguration

NameTypeDescription
clientIdStringClient ID of the OAuth Application
clientSecretStringClient Secret of the OAuth Application
tokenPathStringToken Path of the OAuth Application
revokePathStringToken Revocation Path of the OAuth Application
authorizeBaseUrlStringThe base URL of the OAuth Application
siteStringThe website of the OAuth Application
scopesList<String>The list of Scopes to apply to Connections using the Integration
useBodyAuthBooleanBoolean indicating whether auth params should be sent to OAuth app in body

Example

/*
 * This example demonstrates updating an existing custom Integration
 */

import org.catalytic.sdk.CatalyticClient;
import org.catalytic.sdk.entities.Integration;
import org.catalytic.sdk.entities.IntegrationConfiguration;

public class Program {
  
    public static void main(String[] args) throws Exception {
      	
      	// Create and initialize the Catalytic SDK Client
    	CatalyticClient catalytic = new CatalyticClient();
        
        IntegrationConfiguration oauthConfig = new IntegrationConfiguration(
            "myOauthId",
            "myOauthSecret",
            "/token",
            "/revoke",
            new URI("https://example.com/"),
            new URI("https://example.com/oauth"),
            Arrays.asList("read", "write")
        );

      	// Update the Integration with id "my-example-integration"
      	Integration integration = catalytic.integrations().update("my-example-integration", oauthConfig);
        
        System.out.println("Update integration name: " + integration.getName());
    }
}