Bulk Update Partner Organization and/or Host Company Details
patch
/rest/v19/companies
This endpoint updates company details for multiple partner organizations, include host company, in one web services request.
Request
Supported Media Types
- application/json
Nested Schema : companies
Type:
Show Source
array-
Array of:
object Company Details
Title:
Company Details
Nested Schema : Company Details
Type:
objectTitle:
Show Source
Company Details-
address1:
string
Title:
Address 1Company address1. -
address2:
string
Title:
Address 2Company address2. -
baseCurrency:
object Currency
Title:
CurrencyBase currency of the company. Value holds the currency code. -
baseLanguage:
object Base Language
Title:
Base LanguageBase language of the company. Value holds the language code. -
city:
string
Title:
CityCity of the company. -
country:
string
Title:
CountryCountry of the company. -
dateTimeFormat:
object Date/Time Format
Title:
Date/Time FormatCompany preferred date time format. -
email:
string
Title:
EmailEmail of the company. -
enabledForSSO:
boolean
Title:
Enabled For SSOIs the company enabled for user login with SSO credentials? -
faxNumber:
string
Title:
Fax NumberFax number of the company. -
login(required):
string
Title:
Login NameCompany login name. -
maximumUsers:
number
Title:
Maximum UsersThe maximum number of active users that the company allows to provide access. -
name:
string
Title:
NameName of the company. -
numberFormat:
object Number Format
Title:
Number FormatPreferred number format of the company. -
phoneNumber:
integer
Title:
Phone NumberPhone number of the company. -
state:
string
Title:
StateState province of the company. -
supportedCurrencies:
object Supported Currencies
Title:
Supported CurrenciesCurrencies that are supported by the company. -
supportedLanguages:
object Supported Languages
Title:
Supported LanguagesLanguages that are supported by the company (supportedLanguages are mandatory only for host company update). -
timeZone:
object TimeZone of the company
Title:
TimeZone of the companyCompany preferred timezone. -
units:
object Units
Title:
UnitsCompany preferred units. -
zip:
string
Title:
Zip CodeZip code.
Nested Schema : Currency
Type:
objectTitle:
CurrencyBase currency of the company. Value holds the currency code.
Show Source
-
displayValue:
string
Title:
Display ValueDisplay value. -
value:
string
Title:
ValueValue
Nested Schema : Base Language
Type:
objectTitle:
Base LanguageBase language of the company. Value holds the language code.
Show Source
-
displayValue:
string
Title:
Display ValueDisplay value. -
value:
string
Title:
ValueValue
Nested Schema : Date/Time Format
Type:
objectTitle:
Date/Time FormatCompany preferred date time format.
Show Source
-
displayValue:
string
Title:
Display ValueDisplay value. -
value:
number
Title:
ValueValue.
Nested Schema : Number Format
Type:
objectTitle:
Number FormatPreferred number format of the company.
Show Source
-
displayValue:
string
Title:
Display ValueDisplay value. -
value:
number
Title:
ValueValue.
Nested Schema : Supported Currencies
Type:
objectTitle:
Supported CurrenciesCurrencies that are supported by the company.
Show Source
Nested Schema : Supported Languages
Type:
objectTitle:
Supported LanguagesLanguages that are supported by the company (supportedLanguages are mandatory only for host company update).
Show Source
Nested Schema : TimeZone of the company
Type:
objectTitle:
TimeZone of the companyCompany preferred timezone.
Show Source
-
displayValue:
string
Title:
Display ValueDisplay value. -
value:
number
Title:
ValueValue.
Nested Schema : Units
Type:
objectTitle:
UnitsCompany preferred units.
Show Source
-
displayValue:
string
Title:
Display ValueDisplay value. -
value:
number
Title:
ValueValue.
Nested Schema : items
Type:
Show Source
array-
Array of:
object Currency Details
Title:
Currency Details
Nested Schema : Currency Details
Type:
objectTitle:
Show Source
Currency Details-
currencyCode:
string
Title:
Currency CodeCurrency code. -
currencyName:
string
Title:
Currency NameCurrency name. -
isBaseCurrency:
boolean
Title:
Is Base CurrencyIs base currency? -
isEnabled:
boolean
Title:
Is EnabledIs enabled? -
precision:
integer
Title:
Precision ValuePrecision value.
Nested Schema : language
Type:
Show Source
object-
languageCode:
string
Title:
Language CodeLanguage Code -
languageNumber:
integer
Title:
Language NumberUnique language number.
Response
Supported Media Types
- application/json
Default Response
List of companies.
Root Schema : company-collection
Type:
Show Source
object-
items:
array List of Companies
Title:
List of CompaniesList of companies.
Nested Schema : List of Companies
Type:
arrayTitle:
List of CompaniesList of companies.
Show Source
-
Array of:
object Company Details
Title:
Company Details
Nested Schema : Company Details
Type:
objectTitle:
Show Source
Company Details-
access:
string
Title:
AccessCompany access status to login granted/denied. -
activeLicensedUsers:
number
Title:
Active Licensed UsersNumber of active users. -
address1:
string
Title:
Address 1Company address 1. -
address2:
string
Title:
Address 2Company address 2. -
baseCurrency:
object Currency
Title:
CurrencyBase currency of the company. Value holds currency code. -
baseLanguage:
object Base Language
Title:
Base LanguageBase language of the company. Value holds the language code. -
city:
string
Title:
CityCity of the company. -
country:
string
Title:
CountryCountry of the company. -
dateTimeFormat:
object Date/Time Format
Title:
Date/Time FormatCompany preferred date time format. -
email:
string
Title:
EmailEmail of the company. -
enabledForSSO:
boolean
Title:
Enabled for SSOIs the company enabled for user login with SSO credentials? -
faxNumber:
string
Title:
Fax NumberFax of the company. -
links:
array Links
Title:
LinksLinks to the related objects. -
login:
string
Title:
Login NameCompany login name. -
maximumUsers:
number
Title:
Maximum UsersThe maximum number of active users that the company allows to provide access. -
name:
string
Title:
NameName of the company. -
numberFormat:
object Number Format
Title:
Number FormatPreferred number format of the company. -
phoneNumber:
integer
Title:
Phone NumberPhone number of the company. -
state:
string
Title:
StateState province of the company. -
styleSheets:
object Style Sheets
Title:
Style SheetsStyleSheets of the company. -
subscriptionPlan:
string
Title:
Subscription PlanSubscription plan. -
supportedCurrencies:
object Supported Currencies
Title:
Supported CurrenciesCurrencies that are supported by the company. -
supportedLanguages:
object Supported Languages
Title:
Supported LanguagesLanguages that are supported by the company (supported languages are mandatory only for host company updates). -
timeZone:
object TimeZone of the company
Title:
TimeZone of the companyCompany preferred timezone. -
translations:
object Translations
Title:
TranslationsTranslations of the company. -
units:
object Units
Title:
UnitsCompany preferred units. -
zip:
string
Title:
Zip CodeZip code.
Nested Schema : Currency
Type:
objectTitle:
CurrencyBase currency of the company. Value holds currency code.
Show Source
-
displayValue:
string
Title:
Display ValueDisplay value. -
value:
string
Title:
ValueValue
Nested Schema : Base Language
Type:
objectTitle:
Base LanguageBase language of the company. Value holds the language code.
Show Source
-
displayValue:
string
Title:
Display ValueDisplay value. -
value:
string
Title:
ValueValue
Nested Schema : Date/Time Format
Type:
objectTitle:
Date/Time FormatCompany preferred date time format.
Show Source
-
displayValue:
string
Title:
Display ValueDisplay value. -
value:
number
Title:
ValueValue.
Nested Schema : Links
Type:
arrayTitle:
LinksLinks to the related objects.
Show Source
-
Array of:
object reference links
Title:
reference linksReference links for the Parent, Self, Children and Related as applicable
Nested Schema : Number Format
Type:
objectTitle:
Number FormatPreferred number format of the company.
Show Source
-
displayValue:
string
Title:
Display ValueDisplay value. -
value:
number
Title:
ValueValue.
Nested Schema : Style Sheets
Type:
objectTitle:
Style SheetsStyleSheets of the company.
Show Source
Nested Schema : Supported Currencies
Type:
objectTitle:
Supported CurrenciesCurrencies that are supported by the company.
Show Source
Nested Schema : Supported Languages
Type:
objectTitle:
Supported LanguagesLanguages that are supported by the company (supported languages are mandatory only for host company updates).
Show Source
Nested Schema : TimeZone of the company
Type:
objectTitle:
TimeZone of the companyCompany preferred timezone.
Show Source
-
displayValue:
string
Title:
Display ValueDisplay value. -
value:
number
Title:
ValueValue.
Nested Schema : Translations
Type:
objectTitle:
TranslationsTranslations of the company.
Show Source
Nested Schema : Units
Type:
objectTitle:
UnitsCompany preferred units.
Show Source
-
displayValue:
string
Title:
Display ValueDisplay value. -
value:
number
Title:
ValueValue.
Nested Schema : reference links
Type:
objectTitle:
reference linksReference links for the Parent, Self, Children and Related as applicable
Show Source
-
href:
string
Title:
URL to the related objectURL to the related object -
name:
string
-
rel:
string
Title:
Link Relationship to the current objectDefault Value:selfLink Relationship to the current object
Nested Schema : companyStyleSheet-collection
Type:
Show Source
object-
items:
array Style Sheet Collection
Title:
Style Sheet CollectionList of style sheets. -
links:
array Links
Title:
LinksLinks to current objects.
Nested Schema : Style Sheet Collection
Type:
arrayTitle:
Style Sheet CollectionList of style sheets.
Show Source
-
Array of:
object Style Sheet
Title:
Style Sheet
Nested Schema : Links
Type:
arrayTitle:
LinksLinks to current objects.
Show Source
-
Array of:
object reference links
Title:
reference linksReference links for the Parent, Self, Children and Related as applicable
Nested Schema : Style Sheet
Type:
objectTitle:
Show Source
Style Sheet-
links:
array Links
Title:
LinksLinks to current objects. -
name:
string
Title:
Style Sheet NameUnique name for the style sheet.
Nested Schema : Links
Type:
arrayTitle:
LinksLinks to current objects.
Show Source
-
Array of:
object reference links
Title:
reference linksReference links for the Parent, Self, Children and Related as applicable
Nested Schema : items
Type:
Show Source
array-
Array of:
object Currency Details
Title:
Currency Details
Nested Schema : Currency Details
Type:
objectTitle:
Show Source
Currency Details-
currencyCode:
string
Title:
Currency CodeCurrency code. -
currencyName:
string
Title:
Currency NameCurrency name. -
isBaseCurrency:
boolean
Title:
Is Base CurrencyIs base currency? -
isEnabled:
boolean
Title:
Is EnabledIs enabled? -
precision:
integer
Title:
Precision ValuePrecision value.
Nested Schema : language
Type:
Show Source
object-
languageCode:
string
Title:
Language CodeLanguage Code -
languageNumber:
integer
Title:
Language NumberUnique language number.
Nested Schema : items
Type:
Show Source
array-
Array of:
object Company Translations
Title:
Company Translations
Nested Schema : Company Translations
Type:
objectTitle:
Show Source
Company Translations-
items:
array Company Translations List
Title:
Company Translations List -
links:
array Links
Title:
LinksLinks to current objects.
Nested Schema : Company Translations List
Type:
arrayTitle:
Show Source
Company Translations List-
Array of:
object Company Translation
Title:
Company Translation
Nested Schema : Links
Type:
arrayTitle:
LinksLinks to current objects.
Show Source
-
Array of:
object reference links
Title:
reference linksReference links for the Parent, Self, Children and Related as applicable
Nested Schema : Company Translation
Type:
objectTitle:
Show Source
Company Translation-
language:
object Translation Language
Title:
Translation Language -
links:
array Links
Title:
LinksLinks to current objects. -
name:
string
Title:
Company Translation NameCompany translation name in specific language.
Nested Schema : Translation Language
Type:
objectTitle:
Show Source
Translation Language-
languageCode:
string
Title:
Language CodeTranslation message language name. -
languageNumber:
string
Title:
Language NumberLanguage sequence number in supported language list. -
links:
array Links
Title:
LinksLinks to current objects.
Nested Schema : Links
Type:
arrayTitle:
LinksLinks to current objects.
Show Source
-
Array of:
object reference links
Title:
reference linksReference links for the Parent, Self, Children and Related as applicable
Nested Schema : Links
Type:
arrayTitle:
LinksLinks to current objects.
Show Source
-
Array of:
object reference links
Title:
reference linksReference links for the Parent, Self, Children and Related as applicable
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 -H "Authorization: Bearer <token>" -H "Content-type: application/json" -H "Accept: application/json" https://sitename.oracle.com/rest/v19/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,
....
}
]
}