iPaaS@ORACLE.CLOUD: #1109 - OIC Projects Factory API

Friday, December 12, 2025

#1109 - OIC Projects Factory API

Introduction

Essentially this post contains some note for myself, however, maybe interesting for others.

OIC Projects

Project Status

Projects have a status -

Running the REST API for GET Projects, I see the following values -

"status": "CONFIGURED",
"status": "ACTIVE",
"status": "DRAFT",

So what do these mean?

When I execute GET Projects in postman, I see this project has the "status": "CONFIGURED".

Now I activate the 2nd integration -

I re-run the GET Projects api call - and see "status": "ACTIVE".

The following project has the status = DRAFT -

"items": [
        {
            "cloneRestrict": "NONE",
            "code": "AA_DRAFT",
            "id": "AA_DRAFT",
          ...
            "name": "AA-DRAFT",
            ...
                "lockStatus": false,
                "locked": {},
                "projectRevisionId": 6,
                "serviceInstanceId": 0,
                "status": "DRAFT",
                "updated": {
                    "by": "niall.commiskey@oracle.com",
                    "date": "2025-12-12T12:19:54.696+0000"
                }
            },
            "type": "DEVELOPED",
            "viewRestricted": false
        },

Let's check it out -

I implement and activate Do A.

I run GET Projects again - and still see

"status": "DRAFT",

I implement and activate Do B.

Run Get Projects - and see "status": "ACTIVE".

So the takeaways are -

Active projects are those with all their integrations marked as active.

Configured projects are those with at least one integration marked as configured.

Draft projects are those with at least one integration marked as draft.

The corollary is, a Project with the status = DRAFT, could still have "live" integrations which are being invoked by clients; the same applies to projects with the status = CONFIGURED.

Project Type

Project type can have the following values -

"type": "DEVELOPED"
"type": "BA"

Projects that you yourself create from scratch, have the type = DEVELOPED.

Here's an extract from the postman response for such a project -

 {
            "cloneRestrict": "NONE",
            "code": "AA_DRAFT",
            "id": "AA_DRAFT",
       ...
            "name": "AA-DRAFT",
            "origin": {},
          ...
                "lockStatus": false,
                "locked": {},
            ...
            },
            "type": "DEVELOPED",
            "viewRestricted": false
        },

Now I create a project, based on a recipe -

I check this out in the GET Projects api response -

{

"id": "ORCL-R-ACONEX_UNIF_ISSU_SYNC",

...

"name": "Oracle Aconex Unifier Issues Sync",

"origin": {

"type": "R"

"simplifiedMode": false,

...

"status": "CONFIGURED",

"updated": {

"by": "niall.commiskey@oracle.com",

"date": "2025-12-12T12:48:37.462+0000"

}

"type": "DEVELOPED",

"viewRestricted": false

So recipes are a flavour of type=Developed, however, the origin value, "R", indicates it's a recipe.

Let's now add a Business Accelerator -

"cloneRestrict": "NONE",
"code": "OUTL-BA-CCB_OFSC",
...
  "mcpEnabled": false,
  "name": "OU CCB OFSC",
  "origin": {},
...
  "status": "CONFIGURED",
...
"type": "BA",
"viewRestricted": false

Here we see that the origin is empty, but type is set to BA.

Project Assets

 "state": {
   "assets": {
      "labelsRs": {
      "items": [
         {
           "code": "V1",
           "lastUpdated": "2025-12-12T12:10:36.664+0000",
           "name": "V1"
                       }
                   ]
                    }

Assets, in this context are deployments -

I add a 2nd deployment - 

MCP Enabled Project

I enable MCP in my project AA-2312.
I execute GET Projects and see - 
{
   ...
  "code": "AA_2312",
  "id": "AA_2312",
...
  "mcpEnabled": true,
  "mcpServerUrl": "https://yourOIC/ic/api/integration/v1/mcpservers/projects/AA_2312/mcp",
  "name": "AA-2312",

I enable MCP