Manage Named IDs
A named ID represents a menu selection and contains the list of possible values in a menu. The namedIDs resource is a collection of menu selections of a particular resource. For example, the accounts resource has emails, phones, and profile as named IDs. The named ID profile has Administrator, Marketing Manager, and Sales Manager as its possible values. You can use the Connect REST API to perform the following tasks:
Retrieve a List of Named IDs of a Resource
Use the GET method with the following syntax to view the list of named IDs for a specific instance of a resource (that is, an object):
https://your_site_interface/services/rest/connect/version/namedIDs/resource
Request Body
There are no elements in the request body for this task.
Response Body
Returns an array of named IDs of a resource.
Example URL
Using GET with the following URL returns the list of named IDs for the incidents resource:
https://mysite.example.com/services/rest/connect/v1.4/namedIDs/accounts
Example Response
{
"emailNotification": {
"links": [
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/namedIDs/accounts/emailNotification"
}
]
},
"emails": {
"links": [
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/namedIDs/accounts/emails"
}
]
},
"phones": {
"links": [
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/namedIDs/accounts/phones"
}
]
},
"profile": {
"links": [
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/namedIDs/accounts/profile"
}
]
},
"salesSettings": {
"links": [
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/namedIDs/accounts/salesSettings"
}
]
},
"staffGroup": {
"links": [
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/namedIDs/accounts/staffGroup"
}
]
},
"links": [
{
"rel": "self",
"href": "https://mysite.example.com/services/rest/connect/v1.4/namedIDs/accounts"
},
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/namedIDs/accounts"
},
{
"rel": "describedby",
"href": "https://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/namedIDs/accounts",
"mediaType": "application/schema+json"
}
]
}
View a Specific Named ID of a Resource
Use GET with the following syntax to view a named ID of a specific instance of a resource (that is, an object):
https://your_site_interface/services/rest/connect/version/namedIDs/resource/namedID_name
The following table lists the request path parameter:
Name | Description |
---|---|
namedID_name |
Name of the named ID, for example, profile |
Request Body
There are no elements in the request body for this task.
Response Body
Returns the specific named ID of the resource.
Example URL
severity
named ID of the incidents resource:
https://mysite.example.com/services/rest/connect/v1.4/namedIDs/accounts/profile
Example Response
{
"items": [
{
"id": 12,
"lookupName": "Administrator",
"links": [
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/namedIDs/accounts/profile/12"
}
]
},
{
"id": 6,
"lookupName": "Marketing Manager",
"links": [
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/namedIDs/accounts/profile/6"
}
]
},
{
"id": 7,
"lookupName": "Sales Manager",
"links": [
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/namedIDs/accounts/profile/7"
}
]
},
{
"id": 10,
"lookupName": "Sales Representative",
"links": [
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/namedIDs/accounts/profile/10"
}
]
},
{
"id": 8,
"lookupName": "Service Manager",
"links": [
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/namedIDs/accounts/profile/8"
}
]
},
{
"id": 19,
"lookupName": "SsoProfile",
"links": [
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/namedIDs/accounts/profile/19"
}
]
}
],
"links": [
{
"rel": "self",
"href": "https://mysite.example.com/services/rest/connect/v1.4/namedIDs/accounts/profile"
},
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/namedIDs/accounts/profile"
},
{
"rel": "describedby",
"href": "https://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/namedIDs/accounts/profile",
"mediaType": "application/schema+json"
}
]
}