Returns an Alert resource based on id.​
>The Alert resource with matching id is returned.
Attributes to include in the response can be specified with the attributes query parameter.
Attributes to exclude from the response can be specified with the excludedAttributes query parameter.
Path Parameters
- alertId string required
id of Alert resource.
Query Parameters
- attributes string
A comma-separated list of attributes to return in the response. This query parameter supersedes excludedAttributes, so providing the same attribute(s) to both will result in the attribute(s) being returned.
- excludedAttributes string
A comma-separated list of attributes to exclude from the response. Some attributes cannot be excluded.
- 200
Returns a single Alert resource based on the id.
- application/json
- Schema
- Example (from schema)
Schema
- id string
Unique identifier of the Alert.
- name string
Name of the Alert, auto-generated by the SCIM Server.
- displayName string
Display name of the Alert.
- type string
Type of the Alert.
attributes undefined[]
A list of attributes of the Alert.
value stringThe attribute value.
key stringThe attribute key.
application undefined[]
The corresponding Application object of the Alert.
value stringThe Application associated with the Alert.
$ref stringThe URI of the SCIM resource representating the Alert application.
displayName stringThe name of the Alert Application. OPTIONAL and READ-ONLY.
actions undefined[]
Alert actions.
type stringPossible values: [
WORKFLOW
,CERTIFICATION
,NOTIFICATION
]The type of action performed as a result of the Alert.
alertDefinitionName stringThe name of the Alert Definition that triggered the action.
resultId stringTypically actions create other objects, a certificationId or workflowId as a result of the action taken.
result undefined[]
The Task Result of the Alert.
name stringThe name of the Task Result for the Alert action.
workflowName stringThe name of the Workflow used in the Alert action task result.
notifications undefined[]
Notifications to send when a Alert action is generated.
name stringThe name of configured notifications for Alert action results.
displayName stringDisplay name for the Alert action notification.
emailAddresses stringA list of email addresses to send an Alert action notification.
- alertDate date-time
The Alert DateTime, this could have different meanings based on the type of alert.
- lastProcessed date-time
The DateTime of the last time the Alert was processed, this does not indicate the system took action on the Alert.
- nativeId string
Unique Identifier of the Alert in the native system.
- targetId string
Unique Identifier of the target object which caused the Alert.
- targetType string
The type of SailPointObject the target is.
- targetDisplayName string
User friendly display name of the target object.
meta object
created date-timeDateTime when the Alert was created.
location stringURL to the Alert.
lastModified date-timeDateTime of Alert last modification.
version stringAlert version.
resourceType stringResource type of the metadata subject.
{
"id": "c0a8019c7ffa186e817ffb80170a0195",
"name": "0000000002",
"displayName": "Workflow Alert",
"type": "Business Process Alert",
"attributes": [
{
"value": "Windows File Server (Agent)",
"key": "applicationType"
}
],
"application": [
{
"value": "SAP",
"$ref": "http://localhost:8080/identityiq/scim/v2/Applications/7f00000180281df7818028bfed100826",
"displayName": "SAP Financial App"
}
],
"actions": [
{
"type": "Certification",
"alertDefinitionName": "certLauncher",
"resultId": "7f00000180281df7818028c109ea1742",
"result": [
{
"name": "Alert 0000000001 Certification Result",
"workflowName": "refreshCerficationSchedule",
"notifications": [
{
"name": 9,
"displayName": "Certification Refresh Notification for James.Smith",
"emailAddresses": "james.smith@demoexample.com"
}
]
}
]
}
],
"alertDate": "2022-03-31T14:52:40.265-05:00",
"lastProcessed": "2022-03-31T14:52:40.260-05:00",
"nativeId": "420bebfb-c87a-406f-930c-29e06feb47bc",
"targetId": "c0a8019c7fe51750817fe634a6b10171",
"targetType": "Certification",
"targetDisplayName": "Manager Certification",
"meta": {
"created": "2022-04-05T15:52:30.090-05:00",
"location": "http://localhost:8080/identityiq/scim/v2/Alerts/c0a8019c7ffa186e817ffb80170a0195",
"lastModified": "2022-04-05T15:52:30.119-05:00",
"version": "W\"1649191950119\"",
"resourceType": "Alert"
}
}