Associating Teams to REST API Resources

You can use the REST API to associate an existing team child resource to existing supported REST API resources. You can see which teams are supported by looking at the REST Integration Tags page in the Oracle CRM On Demand user interface. For more information about REST API Integration Tags, see Customizing REST API Integration Tags.

When you add a team child resource to an Oracle CRM On Demand resource, you must specify the FullName field value in the REST API request.

The following details are for a POST request to associate an existing team to a Custom Object resource on the Oracle CRM On Demand Server:

  • URL: https://<host>/OnDemand/user/Rest/latest/CustomObjects4/1QA2-238N93/child/CustomObject4Teams

  • HTTP Method: POST

  • Content-Type: application/vnd.oracle.adf.resource+json

  • Request body:

{
  "CustomObject4Teams":[
    {
    "UserId":"ABCD-1234", 
    "TeamRole":"Owner",
    "AccessCode":"Full"
    }
  ]
}

Where UserId is the row ID of the user.

The following are the details for the response to a successful request and the links to the associated team:

  • HTTP Code: 201

  • Content-Type: application/vnd.oracle.adf.resource+json

  • Response body:

{
  "CustomObject4Teams":[{
    "FullName":"user1 user1",
    "TeamRole":"Owner",
    "AccessCode":"Full",
  "links":{
    "self":{
      "rel":"self",
      "href":"/OnDemand/user/Rest/028/CustomObjects4/1QA2-238N93/child/CustomObject4Teams/1QA2-2458T6"},
    "canonical":{
      "rel":"canonical",
      "href":"/OnDemand/user/Rest/028/CustomObjects4/1QA2-238N93/child/CustomObject4Teams/1QA2-2458T6"},
    "parent":{
      "rel":"parent",
      "href":"/OnDemand/user/Rest/028/CustomObjects4/1QA2-238N93"}
    }
  }
 ]
}