REST API to create a connection to Oracle Integration Cloud using Task Manager

REST Resource

POST /HyperionPlanning/rest/fcmapi/{api_version}/{module}/connections

Required Roles

Service Administrator

Request

Supported Media Types: application/json

Parameters:

The following table summarizes the client request parameters for Basic authentication and OAuth 2.0 authentication.

Table 19-7 Parameters

Name	Description	Type	Required	Default
`api_version`	Version of the API you're developing with (must be v1)	Path	Yes	None
`module`	The name of the module for which to create a connection. Set this value to FCM.	Path	Yes	None
`url`	The URL of the Integration Cloud environment. Note: The URL must be provided only till the server name, which is oraclecloud.com.	Payload	Yes	None
`authType`	Type of authentication: Basic OAuth Note: The parameter is applicable only for OAuth 2.0 authentication type.	Payload	Yes	None
`oauthProperties`	Specify the access token, client ID, and scope of the URL for OAuth 2.0 authentication. Note: The parameter is applicable only for OAuth 2.0 authentication type.	Payload	Payload	None
`username`	A username with the Service Administrator predefined role. Note: This parameter is applicable only for basic authentication type.	Payload	Yes	None
`password`	The encrypted password for the user. For security reasons, only an encrypted password is allowed. Use the EPM Automate encrypt command to generate the encrypted password. See encrypt . Note: This parameter is applicable only for basic authentication type.	Payload	Yes	None
`type`	The type of connection. For Oracle Integration Cloud, set this value to ICS.	Payload	Yes	None

Example of Request Body- Basic Authentication

{
    "url": "<URL of Oracle Integration Cloud>",
    "username": "<NEW_USERNAME>",
    "password": "<NEW_PASSWORD>",
    "type" : "ICS"
    "authType": "BASIC"
}

Example of Request Body- OAuth 2.0 Authentication

{
     "url": "<URL of Oracle Integration Cloud>",
      "type": "ICS",
      "authType": "OAUTH2",
      "oauthProperties": {
                "accessTokenUrl": "<Access token URL>",
                "clientId": "<Client ID>",
                "scope": "<Scope URL>",
                "clientSecret": "<EPMAUTOMATE Encrypted password>"
            }
}

Response

Supported Media Type: application/json

Table 19-8 Parameters

Parameters	Description
`details`	In case of errors, details are published with the error string.

Example of Response Body

{
  "details": "Connection created successfully."
}