/json/users/{user}/oauth2/resources/labels

AM-specific endpoint used to create, delete, and query UMA user and star labels.

Action	HTTP Method
Create	POST
Query	GET
Delete	DELETE

Tip

Use the AM API Explorer for detailed information about this endpoint, and to test it against your deployed AM instance.

In the AM console, click the Help icon, and then go to API Explorer > users > {user} > oauth2 > resources > labels.

You must compose the path to the token endpoint addressing the specific realm where the token will be issued. For example, https://openam.example.com:8443/openam/json/realms/root/realms/subrealm1/users/{user}/oauth2/resources/labels.

The labels endpoint does not support any parameters. To authenticate to the endpoint, send the SSO token of the resource owner as the value of the iplanetDirectoryPro header.

To create a label, make an HTTP POST call to the endpoint, adding the description of the label as a JSON document in the body. For example:

{
  "name" : "My Favorites",
  "type" : "STAR"
  "resourceSetIDs": [
      "UMA_resource_ID_1234567890",
      "UMA_resource_ID_0987654321"
  ]
}

The value of the type object can be USER, for user labels, and STAR, for star labels. For more information about the different types, see Managing UMA Labels.

The resourceSetIDs object is an array of UMA resource IDs that the label applies to. It is not mandatory; if you do not add it, the label will be created without any resource associated, and you will need to update the resource to add it to the label, since the labels endpoint does not support updating labels.

For examples, see "How to Manage UMA User and Favorite Labels".