{"id":3457,"date":"2026-05-06T13:59:32","date_gmt":"2026-05-06T13:59:32","guid":{"rendered":"https:\/\/www.bohort.nl\/?p=3457"},"modified":"2026-05-06T14:13:45","modified_gmt":"2026-05-06T14:13:45","slug":"oracle-integration-cloud-automating-project-deployments","status":"publish","type":"post","link":"https:\/\/www.bohort.nl\/en\/2026\/05\/06\/oracle-integration-cloud-automating-project-deployments\/","title":{"rendered":"Oracle Integration Cloud: Automating Project Deployments"},"content":{"rendered":"

Importing the CAR Is Easy \u2014 Activating It Is the Trap<\/h3>\n\n\n\n

If you’ve ever tried to setup automated OIC Project deployment and if, like me, you went looking for one in the docs, you probably wasted half an afternoon before realising what’s actually going on.<\/p>\n\n\n\n

This post walks through what I learned automating CAR file promotion between OIC environments.<\/p>\n\n\n\n

The Setup<\/h3>\n\n\n\n

A common CI\/CD scenario for OIC: you’ve built a project in your dev instance, exported the deployment as a .car<\/code> file (let’s say TEST_PROJECT-01.00.0001.car<\/code>), and now you want a pipeline to push it to test or prod and turn it on. Two steps, conceptually:<\/p>\n\n\n\n

    \n
  1. Import<\/strong> the CAR into the target environment.<\/li>\n\n\n\n
  2. Activate<\/strong> the deployment so the integrations actually start handling traffic.<\/li>\n<\/ol>\n\n\n\n

    Step 1 is well-documented and works exactly as advertised. Step 2 is where it gets interesting.<\/p>\n\n\n\n

    Step 1 \u2014 Import the CAR<\/h3>\n\n\n\n

    This one’s straightforward. Post the archive to the projects archive endpoint:<\/p>\n\n\n\n

    curl -X POST \\\n  'https:\/\/<OIC_HOST>\/ic\/api\/integration\/v1\/projects\/archive' \\\n  -H 'Authorization: Bearer <TOKEN>' \\\n  -H 'Accept: application\/json' \\\n  -H 'Content-Type: multipart\/form-data' \\\n  -F 'type=application\/octet-stream' \\\n  -F 'file=@TEST_PROJECT-01.00.0001.car'\n<\/code><\/pre>\n\n\n\n
    OIC unpacks the archive, creates the project (or merges into an existing one), and registers the deployment manifest. At this point everything is imported but inactive<\/strong> \u2014 the integrations exist with status CONFIGURED<\/code>, not ACTIVATED<\/code>.<\/p>\n\n\n\n
    Step 2 \u2014 The Plot Twist: There Is No “Activate Deployment” Endpoint<\/h3>\n\n\n\n
    I went looking in the documentation for a REST endpoint to activate the deployment. Unfortunately it doesn’t exist. Here’s the complete list of REST operations Oracle exposes for project deployments, according to the documentationlink<\/a>:<\/p>\n\n\n\n
    Method<\/th>Path<\/th>Purpose<\/th><\/tr><\/thead>
    POST<\/code><\/td>\/ic\/api\/integration\/v1\/projects\/{projectId}\/deployments<\/code><\/td>Create deployment<\/td><\/tr>
    GET<\/code><\/td>\/ic\/api\/integration\/v1\/projects\/{projectId}\/deployments<\/code><\/td>List deployments<\/td><\/tr>
    GET<\/code><\/td>\/ic\/api\/integration\/v1\/projects\/{projectId}\/deployments\/{id}<\/code><\/td>Get deployment<\/td><\/tr>
    POST<\/code><\/td>\/ic\/api\/integration\/v1\/projects\/{projectId}\/deployments\/{id}<\/code><\/td>Update deployment<\/td><\/tr>
    DELETE<\/code><\/td>\/ic\/api\/integration\/v1\/projects\/{projectId}\/deployments\/{id}<\/code><\/td>Delete deployment<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    <\/p>\n\n\n\n
    That’s it. Five endpoints, none of which activate anything.<\/p>\n\n\n\n
    This is weird, because in the OIC console there is an Activate<\/strong> button for every project deployment.<\/p>\n\n\n\n
    So what does the Activate<\/strong> button in the console actually do? Indeed, it calls a REST API. Let’s go ahead and try if we can use this REST API in our pipeline.<\/p>\n\n\n\n
    Step 3 \u2014 Replicating the Activate Button<\/h3>\n\n\n\n
    The easy way to figure this out is to watch via chrome developertools which Endpoint is called when you click the Activate<\/strong> button on a project deployment in Oracle Integration Cloud (OIC) Gen 3.<\/p>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    And there you have it. <\/p>\n\n\n\n
    Method<\/th>Path<\/th>Purpose<\/th><\/tr><\/thead>
    POST<\/code><\/td>\/ic\/api\/integration\/v1\/projects\/{projectId}\/activate<\/code><\/td>Activate a deployment<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    3a. Activate the deployment<\/h4>\n\n\n\n
    Now you can simply invoke that REST API to activate a deployment.<\/p>\n\n\n\n
      \n
    • The required body is just   {\"traceType\"<\/code>:  “PRODUCTION”, “label\": \"01.00.0000\"}<\/code>.<\/li>\n<\/ul>\n\n\n\n
      curl -X POST \\\n  'https:\/\/<OIC_HOST>\/ic\/api\/integration\/v1\/projects\/{projectId}\/activate' \\\n  -H 'Authorization: Bearer <TOKEN>' \\\n  -H 'Accept: application\/json' \\\n  -H 'X-HTTP-Method-Override:PATCH' \\\n  -d  $body \\<\/code><\/pre>\n\n\n\n
      To deactivate later,  you can use the similar way to find out which endpoint to use.<\/p>\n\n\n\n
      Method<\/th>Path<\/th>Purpose<\/th><\/tr><\/thead>
      POST<\/code><\/td>\/ic\/api\/integration\/v1\/projects\/{projectId}\/deactivate<\/code><\/td>Deactivate a deployment<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      <\/p>\n\n\n\n
        \n
      • The required body is just   {<\/code>“label\": \"01.00.0000\"}<\/code>.<\/li>\n<\/ul>\n\n\n\n
        That’s the full “import and activate” sequence in a CI\/CD context.<\/p>\n\n\n\n
        Takeaways<\/h3>\n\n\n\n
          \n
        • Importing a CAR<\/strong> is one clean REST call to \/projects\/archive<\/code>.<\/li>\n\n\n\n
        • Activating the resulting deployment<\/strong> is also<\/em> a single call \u2014 however, it is not found in the Oracle Documentation<\/li>\n\n\n\n
        • The console’s Activate<\/strong> button is calling the API. <\/li>\n<\/ul>\n\n\n\n
          \n
          \n
          \"\"<\/figure>\n<\/div><\/div>\n<\/div>","protected":false},"excerpt":{"rendered":"
          Importing the CAR Is Easy \u2014 Activating It Is the Trap If you’ve ever tried to setup automated OIC Project deployment and if, like me, you went looking for one…<\/p>","protected":false},"author":1,"featured_media":3462,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_kadence_starter_templates_imported_post":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"_kad_post_classname":"","footnotes":""},"categories":[101,118,119],"tags":[122,4,121,5,103,120,123],"class_list":["post-3457","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oic","category-oracle-integration-cloud","category-projects","tag-activation","tag-bohort","tag-deployments","tag-luc-bors","tag-oracle-integration-cloud","tag-projects","tag-rest-api"],"_links":{"self":[{"href":"https:\/\/www.bohort.nl\/en\/wp-json\/wp\/v2\/posts\/3457","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.bohort.nl\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.bohort.nl\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.bohort.nl\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.bohort.nl\/en\/wp-json\/wp\/v2\/comments?post=3457"}],"version-history":[{"count":5,"href":"https:\/\/www.bohort.nl\/en\/wp-json\/wp\/v2\/posts\/3457\/revisions"}],"predecessor-version":[{"id":3464,"href":"https:\/\/www.bohort.nl\/en\/wp-json\/wp\/v2\/posts\/3457\/revisions\/3464"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.bohort.nl\/en\/wp-json\/wp\/v2\/media\/3462"}],"wp:attachment":[{"href":"https:\/\/www.bohort.nl\/en\/wp-json\/wp\/v2\/media?parent=3457"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.bohort.nl\/en\/wp-json\/wp\/v2\/categories?post=3457"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.bohort.nl\/en\/wp-json\/wp\/v2\/tags?post=3457"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}