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 > Artifact API > Add groups to an organization

Add groups to an organization

Details

URI	`/artifact/<organization_id>/group`
Method	POST
Parameters	`userIdentifier=<user_id>` Required; the user ID you want to use as credentials for this API call. For steps to get the UserIdentifier value see Get userIdentifier.
Returns	200 - Ok 401 - Not authorized 404 - Object not found 500 - Server exception

You must specify the role for each group in the request body. The valid roles are as follows:

For Consumer type organizations:

SERVICE_CONSUMER
CONSUMER_ORGANIZATION_ADMINISTRATOR

For Provider type organizations:

CONSUMER_SERVICE_ADMINISTRATOR
CONTENT_MANAGER
CSA_ADMIN
RESOURCE_SUPPLY_MANAGER
SERVICE_BUSINESS_MANAGER
SERVICE_DESIGNER
SERVICE_OPERATIONS_MANAGER

Example

The following URL is sent:

https://<host>:<port>/csa/rest/artifact/8a81818f3d1421e7013d1423635a0003/group?userIdentifier=90d96588360da0c701360da0f1d5f483

The following XML is sent:

<GroupList>
  <group>
    <displayName>My-Group-Name</displayName>
    <distinguishedName>
      cn=TestConsumer,ou=ConsumerGroup,ou=CSAGroups
    </distinguishedName>
    <role>
      <name>SERVICE_CONSUMER</name>
    </role>
  </group>
  <group>
    <displayName>Another-Group-Name</displayName>
    <distinguishedName>
      cn=TestConsumer2,ou=ConsumerGroup,ou=CSAGroups
    </distinguishedName>
    <role>
      <name>SERVICE_CONSUMER</name>
    </role>
  </group>
 </GroupList>

The following XML is returned:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<GroupList>
  <count>2</count>
  <limit>2</limit>
  <group>
    <isCriticalSystemObject>false</isCriticalSystemObject>
    <name>My-Group-Name</name>
    <displayName>My-Group-Name</displayName>
    <disabled>false</disabled>
    <distinguishedName>
      cn=TestConsumer,ou=ConsumerGroup,ou=CSAGroups
    </distinguishedName>
    <role>
      <isCriticalSystemObject>false</isCriticalSystemObject>
      <name>SERVICE_CONSUMER</name>
      <disabled>false</disabled>
    </role>
  </group>
  <group>
    <isCriticalSystemObject>false</isCriticalSystemObject>
    <name>Another-Group-Name</name>
    <displayName>Another-Group-Name</displayName>
    <disabled>false</disabled>
    <distinguishedName>
      cn=TestConsumer2,ou=ConsumerGroup,ou=CSAGroups
    </distinguishedName>
    <role>
      <isCriticalSystemObject>false</isCriticalSystemObject>
      <name>SERVICE_CONSUMER</name>
      <disabled>false</disabled>
    </role>
  </group>
</GroupList>

Send Help Center feedback