List Vendor Connector Mappings
GET/vendor-connector-mappings
Get a list of mappings between SaaS vendors and ISC connectors, detailing the connections established for correlation.
Responses
- 200
- 400
- 401
- 403
- 405
- 429
- 500
Successfully retrieved list.
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
The unique identifier for the vendor-connector mapping.
The name of the vendor.
The name of the connector.
The creation timestamp of the mapping.
The identifier of the user who created the mapping.
updatedAt
object
nullable
An object representing the nullable timestamp of the last update.
The timestamp when the mapping was last updated, represented in ISO 8601 format.
A flag indicating if the 'Time' field is set and valid.
updatedBy
object
nullable
An object representing the nullable identifier of the user who last updated the mapping.
The identifier of the user who last updated the mapping, if available.
A flag indicating if the 'String' field is set and valid.
deletedAt
object
nullable
An object representing the nullable timestamp of when the mapping was deleted.
The timestamp when the mapping was deleted, represented in ISO 8601 format, if applicable.
A flag indicating if the 'Time' field is set and valid, i.e., if the mapping has been deleted.
deletedBy
object
nullable
An object representing the nullable identifier of the user who deleted the mapping.
The identifier of the user who deleted the mapping, if applicable.
A flag indicating if the 'String' field is set and valid, i.e., if the mapping has been deleted.
[
{
"id": "78733556-9ea3-4f59-bf69-e5cd92b011b4",
"vendor": "Example Vendor",
"connector": "Example Connector",
"createdAt": "2024-03-13T12:56:19.391294Z",
"createdBy": "admin",
"updatedAt": {
"Time": "2024-03-14T12:56:19.391294Z",
"Valid": true
},
"updatedBy": {
"String": "user-67891",
"Valid": true
},
"deletedAt": {
"Time": "0001-01-01T00:00:00Z",
"Valid": false
},
"deletedBy": {
"String": "",
"Valid": false
}
},
{
"id": "78733556-9ea3-4f59-bf69-e5cd92b011b5",
"vendor": "Another Corporation",
"connector": "Another Connector",
"createdAt": "2024-04-13T11:46:19.391294Z",
"createdBy": "admin",
"updatedAt": {
"Time": "0001-01-01T00:00:00Z",
"Valid": false
},
"updatedBy": {
"String": "",
"Valid": false
},
"deletedAt": {
"Time": "0001-01-01T00:00:00Z",
"Valid": false
},
"deletedBy": {
"String": "",
"Valid": false
}
}
]
Client Error - Returned if the request body is invalid.
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
Array [
]
Fine-grained error code providing more detail of the error.
Unique tracking id for the error.
messages
object[]
Generic localized reason for error
The locale for the message text, a BCP 47 language tag.
Possible values: [DEFAULT
, REQUEST
, null
]
An indicator of how the locale was selected. DEFAULT means the locale is the system default. REQUEST means the locale was selected from the request context (i.e., best match based on the Accept-Language header). Additional values may be added in the future without notice.
Actual text of the error message in the indicated locale.
causes
object[]
Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
The locale for the message text, a BCP 47 language tag.
Possible values: [DEFAULT
, REQUEST
, null
]
An indicator of how the locale was selected. DEFAULT means the locale is the system default. REQUEST means the locale was selected from the request context (i.e., best match based on the Accept-Language header). Additional values may be added in the future without notice.
Actual text of the error message in the indicated locale.
{
"detailCode": "400.1 Bad Request Content",
"trackingId": "e7eab60924f64aa284175b9fa3309599",
"messages": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "The request was syntactically correct but its content is semantically invalid."
}
],
"causes": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "The request was syntactically correct but its content is semantically invalid."
}
]
}
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
- application/json
- Schema
- Example (from schema)
Schema
A message describing the error
{
"error": "JWT validation failed: JWT is expired"
}
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
- application/json
- Schema
- Example (from schema)
- 403
Schema
Array [
]
Array [
]
Fine-grained error code providing more detail of the error.
Unique tracking id for the error.
messages
object[]
Generic localized reason for error
The locale for the message text, a BCP 47 language tag.
Possible values: [DEFAULT
, REQUEST
, null
]
An indicator of how the locale was selected. DEFAULT means the locale is the system default. REQUEST means the locale was selected from the request context (i.e., best match based on the Accept-Language header). Additional values may be added in the future without notice.
Actual text of the error message in the indicated locale.
causes
object[]
Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
The locale for the message text, a BCP 47 language tag.
Possible values: [DEFAULT
, REQUEST
, null
]
An indicator of how the locale was selected. DEFAULT means the locale is the system default. REQUEST means the locale was selected from the request context (i.e., best match based on the Accept-Language header). Additional values may be added in the future without notice.
Actual text of the error message in the indicated locale.
{
"detailCode": "400.1 Bad Request Content",
"trackingId": "e7eab60924f64aa284175b9fa3309599",
"messages": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "The request was syntactically correct but its content is semantically invalid."
}
],
"causes": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "The request was syntactically correct but its content is semantically invalid."
}
]
}
An example of a 403 response object
{
"detailCode": "403 Forbidden",
"trackingId": "b21b1f7ce4da4d639f2c62a57171b427",
"messages": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "The server understood the request but refuses to authorize it."
}
]
}
Method Not Allowed - indicates that the server knows the request method, but the target resource doesn't support this method.
- application/json
- Schema
- Example (from schema)
Schema
A message describing the error
Description of the error
Unique tracking id for the error.
{
"errorName": "NotSupportedException",
"errorMessage": "Cannot consume content type",
"trackingId": "e7eab60924f64aa284175b9fa3309599"
}
Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again.
- application/json
- Schema
- Example (from schema)
Schema
A message describing the error
{
"message": " Rate Limit Exceeded "
}
Internal Server Error - Returned if there is an unexpected error.
- application/json
- Schema
- Example (from schema)
- 500
Schema
Array [
]
Array [
]
Fine-grained error code providing more detail of the error.
Unique tracking id for the error.
messages
object[]
Generic localized reason for error
The locale for the message text, a BCP 47 language tag.
Possible values: [DEFAULT
, REQUEST
, null
]
An indicator of how the locale was selected. DEFAULT means the locale is the system default. REQUEST means the locale was selected from the request context (i.e., best match based on the Accept-Language header). Additional values may be added in the future without notice.
Actual text of the error message in the indicated locale.
causes
object[]
Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
The locale for the message text, a BCP 47 language tag.
Possible values: [DEFAULT
, REQUEST
, null
]
An indicator of how the locale was selected. DEFAULT means the locale is the system default. REQUEST means the locale was selected from the request context (i.e., best match based on the Accept-Language header). Additional values may be added in the future without notice.
Actual text of the error message in the indicated locale.
{
"detailCode": "400.1 Bad Request Content",
"trackingId": "e7eab60924f64aa284175b9fa3309599",
"messages": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "The request was syntactically correct but its content is semantically invalid."
}
],
"causes": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "The request was syntactically correct but its content is semantically invalid."
}
]
}
An example of a 500 response object
{
"detailCode": "500.0 Internal Fault",
"trackingId": "b21b1f7ce4da4d639f2c62a57171b427",
"messages": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "An internal fault occurred."
}
]
}