Returns all Alert resources.​
This endpoint returns all Alert resources.
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.
The schemas related to Alerts are:
- urn:ietf:params:scim:schemas:core:1.0:Alert
- urn:ietf:params:scim:schemas:core:1.0:AlertInput
Query Parameters
- filter string
Allows for query filters according to RFC-7644, Section 3.4.2.2 - not all operations are supported.
- lookupByName boolean
Set to true if the Alert name is passed instead of the Alert id.
- sortBy string
Allows sorting the results by a resource's attributes.
- sortOrder string
Default value:
ascending
Determines what order to sort results in.
Example: descending - startIndex integer
Default value:
1
Determines the starting index of the result set.
- count integer
Default value:
1000
Specifies the number of results per page.
- 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
Returned all SCIM resources for this endpoint.
- application/json
- application/scim+json
- Schema
- Example (from schema)
Schema
- totalResults integer
Number of resources returned for this endpoint.
- startIndex integer
The starting index of the resource set list. Can be specified with startIndex query parameter.
- schemas string[]
SCIM Schema used for response.
Resources undefined[]
id stringUnique identifier of the Alert.
name stringName of the Alert, auto-generated by the SCIM Server.
displayName stringDisplay name of the Alert.
type stringType of the Alert.
attributes undefined[]
A list of attributes of the Alert.
value stringThe attribute value.
key stringThe attribute key.
application object
The corresponding Application object of the Alert.
value stringThe Application associated with the Alert.
$ref objectThe URI of the SCIM resource representating the Alert application.
displayName stringThe name of the Alert Application.
actions undefined[]
Not empty if action was taken on the Alert.
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-timeThe Alert DateTime, this could have different meanings based on the type of alert.
lastProcessed date-timeThe DateTime of the last time the alert was processed, this does not indicate the system took action on the Alert.
nativeId stringUnique Identifier of the Alert in the native system.
targetId stringUnique Identifier of the target object which caused the Alert.
targetType stringThe type of SailPointObject the target is.
targetDisplayName stringUser friendly display name of the target object.
meta undefined[]
Metadata for the Alert.
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.
schemas string[]A list of the schemas used for Alerts.
{
"totalResults": "1,",
"startIndex": 1,
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:ListResponse"
],
"Resources": [
{
"id": "c0a8019c7fe11678817fe18984351477",
"name": "0000000001",
"displayName": "Hello World!",
"type": "Permission",
"attributes": [
{
"value": "Grackle5.Test.Sailpoint.com",
"key": "bamName"
}
],
"application": {
"value": "Active_Directory",
"$ref": "http://localhost:8080/identityiq/scim/v2/Applications/7f00000180281df7818028bfed100826",
"displayName": "Active_Directory"
},
"actions": [
{
"type": "WORKFLOW",
"alertDefinitionName": "lowSeverityAlertDefinition",
"resultId": "7f00000180281df7818028c109ea1742",
"result": [
{
"name": "string",
"workflowName": "LCM Provisioning",
"notifications": [
{
"name": "lowLevelAlertNotification",
"displayName": "lowLevelAlert result notification",
"emailAddresses": "amanda.ross@demoexample.com, alice.ford@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-03-31T14:52:40.245-05:00",
"location": "http://localhost:8080/identityiq/scim/v2/Alerts/c0a8019c7fe11678817fe18984351477",
"lastModified": "2022-03-31T14:52:40.265-05:00",
"version": "W\"1650050901217\"",
"resourceType": "Alert"
}
],
"schemas": [
[
"urn:ietf:params:scim:schemas:sailpoint:1.0:AlertInput",
"urn:ietf:params:scim:schemas:sailpoint:1.0:Alert"
]
]
}
]
}
- Schema
- Example (from schema)
Schema
- totalResults integer
Number of Alert resources returned.
- startIndex integer
The starting index of the resource set list. Can be specified with startIndex query parameter.
- schemas string[]
SCIM Schema used for response.
Resources undefined[]
The SCIM resources returned for this endpoint.
id stringUnique identifier of the Alert.
name stringName of the Alert, auto-generated by the SCIM Server.
displayName stringDisplay name of the Alert.
type stringType of the Alert.
attributes undefined[]
A list of attributes of the Alert.
value stringThe attribute value.
key stringThe attribute key.
application object
The corresponding Application object of the Alert.
value stringThe Application associated with the Alert.
$ref objectThe URI of the SCIM resource representating the Alert application.
displayName stringThe name of the Alert Application.
actions undefined[]
Not empty if action was taken on the Alert.
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-timeThe Alert DateTime, this could have different meanings based on the type of alert.
lastProcessed date-timeThe DateTime of the last time the alert was processed, this does not indicate the system took action on the Alert.
nativeId stringUnique Identifier of the Alert in the native system.
targetId stringUnique Identifier of the target object which caused the Alert.
targetType stringThe type of SailPointObject the target is.
targetDisplayName stringUser friendly display name of the target object.
meta undefined[]
Metadata for the Alert.
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.
schemas string[]A list of the schemas used for Alerts.
{
"totalResults": "1500,",
"startIndex": 1,
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:ListResponse"
],
"Resources": [
{
"id": "c0a8019c7fe11678817fe18984351477",
"name": "0000000001",
"displayName": "Hello World!",
"type": "Permission",
"attributes": [
{
"value": "Grackle5.Test.Sailpoint.com",
"key": "bamName"
}
],
"application": {
"value": "Active_Directory",
"$ref": "http://localhost:8080/identityiq/scim/v2/Applications/7f00000180281df7818028bfed100826",
"displayName": "Active_Directory"
},
"actions": [
{
"type": "WORKFLOW",
"alertDefinitionName": "lowSeverityAlertDefinition",
"resultId": "7f00000180281df7818028c109ea1742",
"result": [
{
"name": "string",
"workflowName": "LCM Provisioning",
"notifications": [
{
"name": "lowLevelAlertNotification",
"displayName": "lowLevelAlert result notification",
"emailAddresses": "amanda.ross@demoexample.com, alice.ford@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-03-31T14:52:40.245-05:00",
"location": "http://localhost:8080/identityiq/scim/v2/Alerts/c0a8019c7fe11678817fe18984351477",
"lastModified": "2022-03-31T14:52:40.265-05:00",
"version": "W\"1650050901217\"",
"resourceType": "Alert"
}
],
"schemas": [
[
"urn:ietf:params:scim:schemas:sailpoint:1.0:AlertInput",
"urn:ietf:params:scim:schemas:sailpoint:1.0:Alert"
]
]
}
]
}