Returns all Alert resources.
GET/Alerts
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
Request
Query Parameters
Allows for query filters according to RFC-7644, Section 3.4.2.2 - not all operations are supported.
Set to true if the Alert name is passed instead of the Alert id.
Allows sorting the results by a resource's attributes.
Default value: ascending
Determines what order to sort results in.
Default value: 1
Determines the starting index of the result set.
Default value: 1000
Specifies the number of results per page.
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.
A comma-separated list of attributes to exclude from the response. Some attributes cannot be excluded.
Responses
- 200
Returned all SCIM resources for this endpoint.
- application/json
- application/scim+json
- Schema
- Example (from schema)
Schema
- Array [
- Array [
- ]
- Array [
- Array [
- Array [
- ]
- ]
- ]
- Array [
- ]
- ]
Number of resources returned for this endpoint.
The starting index of the resource set list. Can be specified with startIndex query parameter.
SCIM Schema used for response.
Resources undefined[]
Unique identifier of the Alert.
Name of the Alert, auto-generated by the SCIM Server.
Display name of the Alert.
Type of the Alert.
attributes undefined[]
A list of attributes of the Alert.
The attribute value.
The attribute key.
application object
The corresponding Application object of the Alert.
The Application associated with the Alert.
The URI of the SCIM resource representating the Alert application.
The name of the Alert Application.
actions undefined[]
Not empty if action was taken on the Alert.
Possible values: [WORKFLOW
, CERTIFICATION
, NOTIFICATION
]
The type of action performed as a result of the Alert.
The name of the Alert Definition that triggered the action.
Typically actions create other objects, a certificationId or workflowId as a result of the action taken.
result undefined[]
The Task Result of the Alert.
The name of the Task Result for the Alert action.
The name of the Workflow used in the Alert action task result.
notifications undefined[]
Notifications to send when a Alert action is generated.
The name of configured notifications for Alert action results.
Display name for the Alert action notification.
A list of email addresses to send an Alert action notification.
The Alert DateTime, this could have different meanings based on the type of alert.
The DateTime of the last time the alert was processed, this does not indicate the system took action on the Alert.
Unique Identifier of the Alert in the native system.
Unique Identifier of the target object which caused the Alert.
The type of SailPointObject the target is.
User friendly display name of the target object.
meta undefined[]
Metadata for the Alert.
DateTime when the Alert was created.
URL to the Alert.
DateTime of Alert last modification.
Alert version.
Resource type of the metadata subject.
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": "[email protected], [email protected]"
}
]
}
]
}
],
"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
- Array [
- Array [
- ]
- Array [
- Array [
- Array [
- ]
- ]
- ]
- Array [
- ]
- ]
Number of Alert resources returned.
The starting index of the resource set list. Can be specified with startIndex query parameter.
SCIM Schema used for response.
Resources undefined[]
The SCIM resources returned for this endpoint.
Unique identifier of the Alert.
Name of the Alert, auto-generated by the SCIM Server.
Display name of the Alert.
Type of the Alert.
attributes undefined[]
A list of attributes of the Alert.
The attribute value.
The attribute key.
application object
The corresponding Application object of the Alert.
The Application associated with the Alert.
The URI of the SCIM resource representating the Alert application.
The name of the Alert Application.
actions undefined[]
Not empty if action was taken on the Alert.
Possible values: [WORKFLOW
, CERTIFICATION
, NOTIFICATION
]
The type of action performed as a result of the Alert.
The name of the Alert Definition that triggered the action.
Typically actions create other objects, a certificationId or workflowId as a result of the action taken.
result undefined[]
The Task Result of the Alert.
The name of the Task Result for the Alert action.
The name of the Workflow used in the Alert action task result.
notifications undefined[]
Notifications to send when a Alert action is generated.
The name of configured notifications for Alert action results.
Display name for the Alert action notification.
A list of email addresses to send an Alert action notification.
The Alert DateTime, this could have different meanings based on the type of alert.
The DateTime of the last time the alert was processed, this does not indicate the system took action on the Alert.
Unique Identifier of the Alert in the native system.
Unique Identifier of the target object which caused the Alert.
The type of SailPointObject the target is.
User friendly display name of the target object.
meta undefined[]
Metadata for the Alert.
DateTime when the Alert was created.
URL to the Alert.
DateTime of Alert last modification.
Alert version.
Resource type of the metadata subject.
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": "[email protected], [email protected]"
}
]
}
]
}
],
"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"
]
]
}
]
}