SAP Cloud Platform Open Connectors

Connector and Formula Instance Account APIs

Use the /accounts/instances and endpoints to list your connector and formula instances.

List Connector Instances

GET /accounts/instances

GET /accounts/{id}/instances

Retrieve a list of the authenticated connector instances associated with an account. 

The endpoints to retrieve connector instances by account are:

  • GET /accounts/instances
    • Retrieve a list of authenticated connector instances based on the account associated with the logged in user or the Organization and User Secret passed with the request
  • GET/accounts/{id}/instances
    • Retrieve a list of authenticated connector instances within an account by passing the account id with the request.

Path Parameters

Only used for GE/accounts/{id}/instances.

id
The unique identifier for an account within an organization.

Response Fields

See the element/instances documentation.

GET /accounts/instances Example Request

curl -X GET \
  https://api.openconnectors.us2.ext.hana.ondemand.com/elements/api-v2/accounts/instances \ 
  -H 'authorization: User sAfK7LJGNz5ZHcNrvdJvLI=f03WbTbH6aRKc0HJ3oOIi, Organization 58168435e3b9959a929eb04b6218b9a2' \
  -H 'Content-Type: application/json' \

GET /accounts/{id}/instances Example Request

curl -X GET \
https://api.openconnectors.us2.ext.hana.ondemand.com/elements/api-v2/accounts/156162/instances\
-H 'authorization: User sAfK7LJGNz5ZHcNrvdJvLI=f03WbTbH6aRKc0HJ3oOIi, Organization 58168435e3b9959a929eb04b6218b9a2' \
-H 'Content-Type: application/json' \

Example Response

{  
  "id":471196,
  "name":"MyElement",
  "token":"ABC/Dxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "element":{  
    "id":23,
    "name":"Salesforce Sales Cloud",
    "key":"sfdc",
    "image":"elements/provider_sfdc.png",
    "deleted":false,
    "typeOauth":true,
    "trialAccount":false,
    "transformationsEnabled":false,
    "bulkDownloadEnabled":false,
    "bulkUploadEnabled":false,
    "cloneable":false,
    "extendable":false,
    "beta":false,
    "extended":false
  },
  "elementId":23,
  "valid":true,
  "disabled":false,
  "maxCacheSize":0,
  "cacheTimeToLive":0,
  "configuration":{  

  },
  "eventsEnabled":false,
  "traceLoggingEnabled":false,
  "cachingEnabled":false,
  "externalAuthentication":"none",
  "user":{  
    "id":178542
  }
}

List Formula Instances

GET /accounts/{id}/formulas/{formulaId}/instances

Retrieve a list of the formula instances associated with a formula template within a specific account.

Path Parameters

id
The unique identifier for an account within an organization.
formulaId
The unique id assigned to a formula template.

Response Fields

See the element/instances documentation.

Example Request

curl -X GET \
  https://api.openconnectors.us2.ext.hana.ondemand.com/elements/api-v2/accounts/156162/formulas/4078/istances/ \ 
  -H 'authorization: User sAfK7LJGNz5ZHcNrvdJvLI=f03WbTbH6aRKc0HJ3oOIi, Organization 58168435e3b9959a929eb04b6218b9a2' \
  -H 'Content-Type: application/json' \

Example Response

[  
  {  
    "id":30717,
    "formula":{  
      "id":4078,
      "active":true,
      "debugLoggingEnabled":true,
      "singleThreaded":false
    },
    "name":"test",
    "createdDate":"2017-09-19T19:24:47Z",
    "active":true,
    "settings":{  

    },
    "configuration":{  
      "destinationInstance":"438535",
      "originInstance":"438534"
    }
  }
]