Activate OIC Integrations as programatcally

How to Activate the Latest Version of an OIC Integration Automatically

In Oracle Integration (OIC), each integration can have multiple versions. When deploying updates, you often need to activate the latest version automatically instead of doing it manually. This blog will guide you through creating an OIC integration that uses REST APIs to fetch the latest version of an integration and activate it with just one call.

🔹 Why Automate Activation?

• Speeds up DevOps and CI/CD processes.
• Reduces manual effort and human error.
• Makes deployments repeatable and reliable.

🔹 Key REST APIs Used

Purpose	HTTP Method	Endpoint
Get all versions of an integration	GET	/ic/api/integration/v1/integrations/{integrationId}/versions
Activate a specific version	POST	/ic/api/integration/v1/integrations/{integrationId}/versions/{version}/activate

🔹 Steps to Build the Integration

1. Create a new App-Driven Orchestration Integration
   • Name it ACTIVATE_LATEST_VERSION.
   • Add a REST trigger with /activateLatest (POST method).
2. Call the OIC REST API to Get Versions

   Use the REST Adapter to call the versions API and pass the integrationId (for example: MyIntegration).

3. Extract the Latest Version

   Use an Assign or Mapper step to filter the highest version from the response JSON.

4. Activate the Latest Version

   Use another REST Adapter invoke to call the /activate endpoint with the extracted version.

5. Send Confirmation Response

   Return a response back to the caller with details of the activated version.

🔹 Sample Activation Request

POST https://<OIC_HOST>/ic/api/integration/v1/integrations/MyIntegration/versions/05.01.0000/activate

Authorization: Basic <base64-encoded-credentials>

Content-Type: application/json

  

🔹 Sample Response

{

  "name": "MyIntegration",

  "version": "05.01.0000",

  "status": "ACTIVATED"

}

  

Pro Tip: Instead of hardcoding, make your integration accept integrationId as an input parameter. This way, the same integration can activate the latest version of any OIC integration.

✅ Conclusion

By leveraging OIC REST APIs, you can fully automate the activation of the latest integration version. This approach is highly useful in CI/CD pipelines, automated deployments, and reduces manual dependency in production rollouts. Next time you promote an integration, let OIC activate the latest version for you—automatically!