Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

Cloud Service Automation4.90

Develop > Application Programming Interface > Legacy APIs > Catalog API > Update catalog categories

Update catalog categories

Details

URI	`/catalog/<catalog_id>/category/<category_id>`
Method	PUT
Parameters	`userIdentifier=<user_id>` Required; the user ID you want to use as credentials for this API call. See Get userIdentifier for the steps required to get the userIdentifier value.
Returns	200 - Ok (Indicates the REST call executed without error. See XML return content for details on categories updated.) 401 - Not authorized 404 - Object not found 500 - Server exception

Note that any CatalogCategory elements not specified in the request body will be left unchanged.

Example

The following URL was sent:

https://<host>:<port>/csa/rest/catalog/8a81818f3d02fb7e013d0308894a0004/ category/8a81818f3d128500013d1341a5c6000d ?userIdentifier=90d96588360da0c701360da0f1d5f483

The following XML was sent in the request:


<CatalogCategory>
  <displayName>Changing first example category name</displayName>
  <iconUrl>/catalog/category/x.png</iconUrl>
  <description>New description for first example category</description>
</CatalogCategory>

The following XML was returned:


<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Catalog>
  <id>8a81818f3d02fb7e013d0308894a0004</id>
  <isCriticalSystemObject>false</isCriticalSystemObject>
  <description>Default catalog for the organization.</description>
  <iconUrl>
    /csa/images/library/briefcase-consumer_default_img-60.png
  </iconUrl>
  <name>Catalog_QA_ORG</name>
  <displayName>QA Org Catalog</displayName>
  ...
  <catalogCategory> ... </catalogCategory>
  ...
  <catalogCategory>
    <id>8a81818f3d128500013d1341a5c6000d</id>
    <isCriticalSystemObject>false</isCriticalSystemObject>
    <description>description for catalog category</description>
    <iconUrl>/catalog/category/x.png</iconUrl>
    <name>CHANGING_FIRST_EXAMPLE_CATEGORY_NAME</name>
    <displayName>Changing first example category name</displayName>
    <disabled>false</disabled>
  </catalogCategory>
  ...
</Catalog>

Send Help Center feedback