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
- Create a new App-Driven Orchestration Integration
- Name it
ACTIVATE_LATEST_VERSION. - Add a REST trigger with
/activateLatest(POST method).
- Name it
- Call the OIC REST API to Get Versions
Use the REST Adapter to call the versions API and pass the
integrationId(for example:MyIntegration). - Extract the Latest Version
Use an Assign or Mapper step to filter the highest version from the response JSON.
- Activate the Latest Version
Use another REST Adapter invoke to call the
/activateendpoint with the extracted version. - 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"
}
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!
