Lists all sources in IdentityNow.
GET {{baseUrl}}/sources
This end-point lists all the sources in IdentityNow.
A token with ORGADMIN, SOURCEADMIN, SOURCESUBADMIN, or ROLESUBADMIN authority is required to call this API.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
limit | number | Max number of results to return. | |
See V3 API Standard Collection Parameters for more information. | |||
offset | number | Offset into the full result set. Usually specified with limit to paginate through the results. | |
See V3 API Standard Collection Parameters for more information. | |||
count | boolean | If true it will populate the X-Total-Count response header with the number of results that would be returned if limit and offset were ignored. |
Since requesting a total count can have a performance impact, it is recommended not to send count=true if that value will not be used.
See V3 API Standard Collection Parameters for more information. |
| filters
| string | | Filter results using the standard syntax described in V3 API Standard Collection Parameters
Filtering is supported for the following fields and operators:
id: eq, in, ge, gt, le, lt, ne, isnull, sw
name: co, eq, in, sw, ge, gt, ne, isnull
type: eq, in, ge, gt, ne, isnull, sw
owner.id: eq, in, ge, gt, le, lt, ne, isnull, sw
features: ca, co
created: eq
modified: eq
managementWorkgroup.id: eq, ge, gt, in, le, lt, ne, isnull, sw
description: eq, sw
authoritative: eq, ne, isnull
healthy: isnull
status: eq, in, ge, gt, le, lt, ne, isnull, sw
connectionType: eq, ge, gt, in, le, lt, ne, isnull, sw
connectorName: eq, ge, gt, in, ne, isnull, sw
category: co, eq, ge, gt, in, le, lt, ne, sw |
| sorters
| string | | Sort results using the standard syntax described in V3 API Standard Collection Parameters
Sorting is supported for the following fields: type, created, modified, name, owner.name, healthy, status, id, description, owner.id, accountCorrelationConfig.id, accountCorrelationConfig.name, managerCorrelationRule.type, managerCorrelationRule.id, managerCorrelationRule.name, authoritative, managementWorkgroup.id, connectorName, connectionType |
| for-subadmin
| string | | Filter the returned list of sources for the identity specified by the parameter, which is the id of an identity with the role SOURCE_SUBADMIN. By convention, the value me indicates the identity id of the current user.
Subadmins may only view Sources which they are able to administer; all other Sources will be filtered out when this parameter is set. If the current user is a SOURCE_SUBADMIN but fails to pass a valid value for this parameter, a 403 Forbidden is returned. |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
RESPONSES
status: OK
[{"name":"My Source","owner":{"type":"IDENTITY","id":"2c91808568c529c60168cca6f90c1313","name":"MyName"},"connector":"active-directory","id":"2c91808568c529c60168cca6f90c1324","description":"This is the corporate directory.","cluster":{"name":"Corporate Cluster","id":"2c9180866166b5b0016167c32ef31a66","type":"CLUSTER"},"accountCorrelationConfig":{"type":"ACCOUNT_CORRELATION_CONFIG","id":"2c9180855d191c59015d28583727245a","name":"Directory [source-62867] Account Correlation"},"accountCorrelationRule":{"type":"RULE","id":"2c918085708c274401708c2a8a760001","name":"Example Rule"},"managerCorrelationMapping":{"accountAttributeName":"manager","identityAttributeName":"manager"},"managerCorrelationRule":{"type":"RULE","id":"2c918085708c274401708c2a8a760001","name":"Example Rule"},"beforeProvisioningRule":{"type":"RULE","id":"2c918085708c274401708c2a8a760001","name":"Example Rule"},"schemas":[{"type":"CONNECTOR_SCHEMA","name":"account"},{"type":"CONNECTOR_SCHEMA","name":"group"}],"passwordPolicies":[{"type":"PASSWORD_POLICY","name":"Corporate Password Policy"},{"type":"PASSWORD_POLICY","name":"Vendor Password Policy"}],"features":["PROVISIONING","NO_PERMISSIONS_PROVISIONING","GROUPS_HAVE_MEMBERS"],"type":"OpenLDAP - Direct","connectorClass":"sailpoint.connector.LDAPConnector","connectorAttributes":{"healthCheckTimeout":30,"authSearchAttributes":["cn","uid","mail"]},"deleteThreshold":10,"authoritative":false,"managementWorkgroup":{"type":"GOVERNANCE_GROUP","id":"2c91808568c529c60168cca6f90c2222","name":"My Management Workgroup"},"healthy":true,"status":"SOURCE_STATE_HEALTHY","since":"2021-09-28T15:48:29.380Z","connectorId":"active-directory","connectorName":"Active Directory","connectionType":"file","connectorImplementationId":"delimited-file","created":"2022-02-08T14:50:03.827Z","modified":"2024-01-23T18:08:50.897Z","credentialProviderEnabled":false,"category":"CredentialProvider"},{"name":"My Source","owner":{"type":"IDENTITY","id":"2c91808568c529c60168cca6f90c1313","name":"MyName"},"connector":"active-directory","id":"2c91808568c529c60168cca6f90c1324","description":"This is the corporate directory.","cluster":{"name":"Corporate Cluster","id":"2c9180866166b5b0016167c32ef31a66","type":"CLUSTER"},"accountCorrelationConfig":{"type":"ACCOUNT_CORRELATION_CONFIG","id":"2c9180855d191c59015d28583727245a","name":"Directory [source-62867] Account Correlation"},"accountCorrelationRule":{"type":"RULE","id":"2c918085708c274401708c2a8a760001","name":"Example Rule"},"managerCorrelationMapping":{"accountAttributeName":"manager","identityAttributeName":"manager"},"managerCorrelationRule":{"type":"RULE","id":"2c918085708c274401708c2a8a760001","name":"Example Rule"},"beforeProvisioningRule":{"type":"RULE","id":"2c918085708c274401708c2a8a760001","name":"Example Rule"},"schemas":[{"type":"CONNECTOR_SCHEMA","name":"account"},{"type":"CONNECTOR_SCHEMA","name":"group"}],"passwordPolicies":[{"type":"PASSWORD_POLICY","name":"Corporate Password Policy"},{"type":"PASSWORD_POLICY","name":"Vendor Password Policy"}],"features":["PROVISIONING","NO_PERMISSIONS_PROVISIONING","GROUPS_HAVE_MEMBERS"],"type":"OpenLDAP - Direct","connectorClass":"sailpoint.connector.LDAPConnector","connectorAttributes":{"healthCheckTimeout":30,"authSearchAttributes":["cn","uid","mail"]},"deleteThreshold":10,"authoritative":false,"managementWorkgroup":{"type":"GOVERNANCE_GROUP","id":"2c91808568c529c60168cca6f90c2222","name":"My Management Workgroup"},"healthy":true,"status":"SOURCE_STATE_HEALTHY","since":"2021-09-28T15:48:29.380Z","connectorId":"active-directory","connectorName":"Active Directory","connectionType":"file","connectorImplementationId":"delimited-file","created":"2022-02-08T14:50:03.827Z","modified":"2024-01-23T18:08:50.897Z","credentialProviderEnabled":false,"category":"CredentialProvider"}]