Bulk Update Partner Organization and/or Host Company Details

patch

/rest/v16/companies

This endpoint updates company details for multiple partner organizations, include host company, in one web services request.

Request

Supported Media Types
Body ()
Root Schema : Company Details
Type: object
Title: Company Details
Show Source
Nested Schema : companies
Type: array
Show Source
Nested Schema : Company Details
Type: object
Title: Company Details
Show Source
Nested Schema : Currency
Type: object
Title: Currency
Base currency of the company. Value holds the currency code.
Show Source
Nested Schema : Base Language
Type: object
Title: Base Language
Base language of the company. Value holds the language code.
Show Source
Nested Schema : Date/Time Format
Type: object
Title: Date/Time Format
Company preferred date time format.
Show Source
Nested Schema : Number Format
Type: object
Title: Number Format
Preferred number format of the company.
Show Source
Nested Schema : Supported Currencies
Type: object
Title: Supported Currencies
Currencies that are supported by the company.
Show Source
Nested Schema : Supported Languages
Type: object
Title: Supported Languages
Languages that are supported by the company (supportedLanguages are mandatory only for host company update).
Show Source
Nested Schema : TimeZone of the company
Type: object
Title: TimeZone of the company
Company preferred timezone.
Show Source
Nested Schema : Units
Type: object
Title: Units
Company preferred units.
Show Source
Nested Schema : items
Type: array
Show Source
Nested Schema : Currency Details
Type: object
Title: Currency Details
Show Source
Nested Schema : items
Type: array
Show Source
Nested Schema : language
Type: object
Show Source
Back to Top

Response

Supported Media Types

Default Response

List of companies.
Body ()
Root Schema : company-collection
Type: object
Show Source
Nested Schema : List of Companies
Type: array
Title: List of Companies
List of companies.
Show Source
Nested Schema : Company Details
Type: object
Title: Company Details
Show Source
Nested Schema : Currency
Type: object
Title: Currency
Base currency of the company. Value holds currency code.
Show Source
Nested Schema : Base Language
Type: object
Title: Base Language
Base language of the company. Value holds the language code.
Show Source
Nested Schema : Date/Time Format
Type: object
Title: Date/Time Format
Company preferred date time format.
Show Source
Nested Schema : Number Format
Type: object
Title: Number Format
Preferred number format of the company.
Show Source
Nested Schema : Style Sheets
Type: object
Title: Style Sheets
StyleSheets of the company.
Show Source
Nested Schema : Supported Currencies
Type: object
Title: Supported Currencies
Currencies that are supported by the company.
Show Source
Nested Schema : Supported Languages
Type: object
Title: Supported Languages
Languages that are supported by the company (supported languages are mandatory only for host company updates).
Show Source
Nested Schema : TimeZone of the company
Type: object
Title: TimeZone of the company
Company preferred timezone.
Show Source
Nested Schema : Translations
Type: object
Title: Translations
Translations of the company.
Show Source
Nested Schema : Units
Type: object
Title: Units
Company preferred units.
Show Source
Nested Schema : items
Type: array
Show Source
Nested Schema : companyStyleSheet-collection
Type: object
Show Source
Nested Schema : Style Sheet Collection
Type: array
Title: Style Sheet Collection
List of style sheets.
Show Source
Nested Schema : Style Sheet
Type: object
Title: Style Sheet
Show Source
Nested Schema : items
Type: array
Show Source
Nested Schema : Currency Details
Type: object
Title: Currency Details
Show Source
Nested Schema : items
Type: array
Show Source
Nested Schema : language
Type: object
Show Source
Nested Schema : items
Type: array
Show Source
Nested Schema : Company Translations
Type: object
Title: Company Translations
Show Source
Nested Schema : Company Translations List
Type: array
Title: Company Translations List
Show Source
Nested Schema : Company Translation
Type: object
Title: Company Translation
Show Source
Nested Schema : Translation Language
Type: object
Title: Translation Language
Show Source
Back to Top

Examples

The following example shows how to update company details for multiple partner organizations, include host company, in one web services request by submitting a PATCH request to the REST resource using cURL. For more information about cURL, see Use cURL.

curl -X PATCH -i -H "Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQg" -H "Content-type: application/json" -H "Accept: application/json"
https://sitename.oracle.com/rest/v16/companies

Request Body Sample

{
  "companies": [{
      "login": "a_Co1BM",
      "maximumUser": 20,
      "access": "denied"
    }, {
      "maximumUser": 10,
      "login": "a_Co2BM" "enableSSO": false
    }
  ]
}

Response Body Sample

{
  "items": [{
      "name": "a_Co1BM",
      "login": "A1BM",
      "subscriptionPlan": "FullAccessWithESales",
      "baseLanguage": {
        "value": "en",
        "displayValue": "English"
      },
      "units": {
        "value": 1,
        "displayValue": "English"
      },
      "numberFormat": {
        "value": 0,
        "displayValue": "####.##"
      },
      "dateTimeFormat": {
        "value": 0,
        "displayValue": "MM/dd/yyyy h:mm a"
      },
      "timeZone": {
        "value": "America/Chicago",
        "displayValue": "(GMT-6:00 GMT-5:00) Chicago"
      },
      "baseCurrency": {
        "value": "USD",
        "displayValue": "US Dollar"
      },
      "country": "United States",
      "email": "noreply@bigmachines.com",
      "enabledForSSO": true,
      "activeLicensedUsers": 145,
      "access": "Denied",
      "maximumUsers": 18
    }, {
      "name": "po5",
      "login": "po5",
      "subscriptionPlan": "BuyAccess",
      "baseLanguage": {
        "value": "en",
        "displayValue": "English"
      },
      "units": {
        "value": 2,
        "displayValue": "Metric"
      },
      "numberFormat": {
        "value": 0,
        "displayValue": "####.##"
      },
      "dateTimeFormat": {
        "value": 2,
        "displayValue": "dd/MM/yyyy HH:mm"
      },
      "timeZone": {
        "value": "America/Los_Angeles",
        "displayValue": "(GMT-8:00 GMT-7:00) Los Angeles"
      },
      "baseCurrency": {
        "value": "CNY",
        "displayValue": "Chinese Yuan Renminbi"
      },
      "state": "CA",
      "phoneNumber": "650-403-6325",
      "email": "junk@bigmachines.com",
      "faxNumber": "650-403-6325",
      "address1": "5 Waters Park Dr",
      "address2": "Po5 suite 240-5",
      "city": "SanMateo",
      "zip": "94403",
      "access": "Granted",
      "maximumUsers": 18,
      "enabledForSSO": false,
      ....
    }
  ]
}
Back to Top