Jump to

• Request
• Response
• Examples

Update an Integration

patch

/rest/v16/integrationVendors/{id}

This endpoint updates an existing integration.

Request

Supported Media Types

• application/json

Path Parameters

• id(required): integer
  The unique integer identifier for the integration.

Body ()

Root Schema : integrationVendor-request

Type: object

Show Source

• cert: string
  Title: Certificate

  The string value for the certificate.
• certName: string
  Title: Certificate Name

  The string value for the certificate name.
• integrationType: string
  Title: Integration Type

  The string value for the type of integrationn.
• loginEndpoint: string
  Title: Login Endpoint

  The string value for the login endpoint.
• properties: object properties
• vendorName: string
  Title: Vendor Name

  The string value for the name of the vendor.

{
    "type":"object",
    "properties":{
        "cert":{
            "type":"string",
            "description":"The string value for the certificate.",
            "title":"Certificate"
        },
        "certName":{
            "type":"string",
            "description":"The string value for the certificate name.",
            "title":"Certificate Name"
        },
        "loginEndpoint":{
            "type":"string",
            "description":"The string value for the login endpoint.",
            "title":"Login Endpoint"
        },
        "integrationType":{
            "type":"string",
            "description":"The string value for the type of integrationn.",
            "title":"Integration Type"
        },
        "vendorName":{
            "type":"string",
            "description":"The string value for the name of the vendor.",
            "title":"Vendor Name"
        },
        "properties":{
            "type":"object",
            "properties":{
                "items":{
                    "type":"array",
                    "items":{
                        "type":"object",
                        "properties":{
                            "name":{
                                "type":"string",
                                "description":"Integration property name.",
                                "title":"Property Name"
                            },
                            "value":{
                                "type":"string",
                                "description":"Integration property value.",
                                "title":"Property Value"
                            }
                        }
                    }
                }
            }
        }
    }
}

Nested Schema : properties

Type: object

Show Source

• items: array items

{
    "type":"object",
    "properties":{
        "items":{
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "name":{
                        "type":"string",
                        "description":"Integration property name.",
                        "title":"Property Name"
                    },
                    "value":{
                        "type":"string",
                        "description":"Integration property value.",
                        "title":"Property Value"
                    }
                }
            }
        }
    }
}

Nested Schema : items

Type: array

Show Source

• Array of: object items

{
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "name":{
                "type":"string",
                "description":"Integration property name.",
                "title":"Property Name"
            },
            "value":{
                "type":"string",
                "description":"Integration property value.",
                "title":"Property Value"
            }
        }
    }
}

Nested Schema : items

Type: object

Show Source

• name: string
  Title: Property Name

  Integration property name.
• value: string
  Title: Property Value

  Integration property value.

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"Integration property name.",
            "title":"Property Name"
        },
        "value":{
            "type":"string",
            "description":"Integration property value.",
            "title":"Property Value"
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

Default Response

The updated integration details.

Body ()

Root Schema : integrationVendor

Match All

Show Source

• object integrationVendor-request
• object integrationVendor-allOf[1]

{
    "allOf":[
        {
            "$ref":"#/definitions/integrationVendor-request"
        },
        {
            "type":"object",
            "properties":{
                "id":{
                    "type":"integer",
                    "description":"The unique integer identifier for the integration.",
                    "title":"Id"
                }
            }
        }
    ]
}

Nested Schema : integrationVendor-request

Type: object

Show Source

• cert: string
  Title: Certificate

  The string value for the certificate.
• certName: string
  Title: Certificate Name

  The string value for the certificate name.
• integrationType: string
  Title: Integration Type

  The string value for the type of integrationn.
• loginEndpoint: string
  Title: Login Endpoint

  The string value for the login endpoint.
• properties: object properties
• vendorName: string
  Title: Vendor Name

  The string value for the name of the vendor.

{
    "type":"object",
    "properties":{
        "cert":{
            "type":"string",
            "description":"The string value for the certificate.",
            "title":"Certificate"
        },
        "certName":{
            "type":"string",
            "description":"The string value for the certificate name.",
            "title":"Certificate Name"
        },
        "loginEndpoint":{
            "type":"string",
            "description":"The string value for the login endpoint.",
            "title":"Login Endpoint"
        },
        "integrationType":{
            "type":"string",
            "description":"The string value for the type of integrationn.",
            "title":"Integration Type"
        },
        "vendorName":{
            "type":"string",
            "description":"The string value for the name of the vendor.",
            "title":"Vendor Name"
        },
        "properties":{
            "type":"object",
            "properties":{
                "items":{
                    "type":"array",
                    "items":{
                        "type":"object",
                        "properties":{
                            "name":{
                                "type":"string",
                                "description":"Integration property name.",
                                "title":"Property Name"
                            },
                            "value":{
                                "type":"string",
                                "description":"Integration property value.",
                                "title":"Property Value"
                            }
                        }
                    }
                }
            }
        }
    }
}

Nested Schema : integrationVendor-allOf[1]

Type: object

Show Source

• id: integer
  Title: Id

  The unique integer identifier for the integration.

{
    "type":"object",
    "properties":{
        "id":{
            "type":"integer",
            "description":"The unique integer identifier for the integration.",
            "title":"Id"
        }
    }
}

Nested Schema : properties

Type: object

Show Source

• items: array items

{
    "type":"object",
    "properties":{
        "items":{
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "name":{
                        "type":"string",
                        "description":"Integration property name.",
                        "title":"Property Name"
                    },
                    "value":{
                        "type":"string",
                        "description":"Integration property value.",
                        "title":"Property Value"
                    }
                }
            }
        }
    }
}

Nested Schema : items

Type: array

Show Source

• Array of: object items

{
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "name":{
                "type":"string",
                "description":"Integration property name.",
                "title":"Property Name"
            },
            "value":{
                "type":"string",
                "description":"Integration property value.",
                "title":"Property Value"
            }
        }
    }
}

Nested Schema : items

Type: object

Show Source

• name: string
  Title: Property Name

  Integration property name.
• value: string
  Title: Property Value

  Integration property value.

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"Integration property name.",
            "title":"Property Name"
        },
        "value":{
            "type":"string",
            "description":"Integration property value.",
            "title":"Property Value"
        }
    }
}

Back to Top

Examples

The following example shows how to update an existing integration by submitting a PATCH request to the REST resource using cURL. For more information about cURL, see Use cURL.

curl -X POST -i -H "Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQg" -H "Accept: application/json"
https://sitename.oracle.com/rest/v16/integrationVendors/3022874193

Request Body Sample

{
  "properties": {
    "items": [{
        "name": "cpqClientId",
        "value": "836954009fe54f1382d0ba1d607a038d"
      }, {
        "name": "oAuthProviderScope",
        "value": "urn:opc:idm:__myscopes__"
      }
    ]
  }
}

Response Body Sample

{
  "integrationType": "oAuthProvider",
  "vendorName": "Identity Cloud Service",
  "loginEndpoint": "https://idp.oracle.com",
  "properties": {
    "items": [{
        "name": "resourceEP",
        "value": "/admin/v1/SigningCert/jwk"
      }, {
        "name": "clientId",
        "value": "836954009fe54f1382d0ba1d607a038d"
      }, {
        "name": "tokenEP",
        "value": "/oauth2/v1/token"
      }, {
        "name": "oAuthProviderScope",
        "value": "urn:opc:idm:__myscopes__"
      }, {
        "name": "retrieveCertificate",
        "value": "true"
      }, {
        "name": "cpqClientId",
        "value": "836954009fe54f1382d0ba1d607a038d"
      }, {
        "name": "issuer",
        "value": "https://identity.oraclecloud.com/"
      }
    ]
  },
  "id": 3022874193,
  "links": [{
      "rel": "self",
      "href": "https://sitename.oracle.com/rest/v16/integrationVendors/3022874193"
    }
  ]
}

Back to Top