---
title: "@dynatrace-sdk/shared-errors"
description: Shared error classes for autogenerated Dynatrace SDK packages.
---

@dynatrace-sdk/shared-errors

Shared error classes for autogenerated Dynatrace SDK packages.

``bash
npm install @dynatrace-sdk/shared-errors
`




Classes

$3

Base error for all client SDKs. All other errors extend this class.

#### Constructors

##### new ApiClientError(name,message?,cause?)

#### Parameters

| Name | Type |
| --- | --- |
|name^*required|string|
|message|string|
|cause|any|

#### Properties

| Name | Type | Description |
| --- | --- | --- |
|cause|any| |
|errorType^*required|ErrorType| |
|isApiClientError^*required|true| |

$3

Dedicated error response class for errors thrown by API Gateway.
Autogenerated SDK Clients have built-in handler for API Gateway errors that throws this error.

#### Constructors

##### new ApiGatewayError(response,body)

#### Parameters

| Name | Type |
| --- | --- |
|response^*required|HttpClientResponse|
|body^*required|ApiGatewayErrorResponseBody|

#### Properties

| Name | Type | Description |
| --- | --- | --- |
|body^*required|ApiGatewayErrorResponseBody| |
|cause|any| |
|code^*required|number| |
|errorType^*required|ErrorType| |
|isApiClientError^*required|true| |
|isApiGatewayError^*required|true| |
|isClientRequestError^*required|true| |
|response^*required|HttpClientResponse| |
|retryAfterSeconds^*required|undefined | number| |

$3

Generic error class for service errors, used to handle both expected and unexpected service-level errors.

#### Constructors

##### new ClientRequestError(name,response,body,message?,cause?)

#### Parameters

| Name | Type |
| --- | --- |
|name^*required|string|
|response^*required|HttpClientResponse|
|body^*required|DTO|
|message|string|
|cause|any|

#### Properties

| Name | Type | Description |
| --- | --- | --- |
|body^*required|DTO| |
|cause|any| |
|errorType^*required|ErrorType| |
|isApiClientError^*required|true| |
|isClientRequestError^*required|true| |
|response^*required|HttpClientResponse| |

$3

Dedicated error class for errors related to response serialization.
Thrown when received service response can't be deserialized.

#### Constructors

##### new InvalidResponseError(name,nestedError,body,expectedType?,message?,response?)

#### Parameters

| Name | Type |
| --- | --- |
|name^*required|string|
|nestedError^*required|any|
|body^*required|any|
|expectedType|string|
|message|string|
|response|any|

#### Properties

| Name | Type | Description |
| --- | --- | --- |
|cause|any| |
|errorType^*required|ErrorType| |
|expectedType|string| |
|isApiClientError^*required|true| |
|isInvalidResponseError^*required|true| |
|nestedError|Error| |
|response^*required|any| |
|responseBody^*required|any| |

Functions

$3





$3





$3





$3

Types

$3

Reference for ApiGatewayError details object. Contains information about received API Getaway error.

#### Properties

| Name | Type | Description |
| --- | --- | --- |
|constraintViolations|Array<ConstraintViolation>|An array of ConstraintViolation object, refer to ConstraintViolation object reference for more details. |
|errorCode|string|

String value representing a more detailed error information than the http response code alone. Must be a single word in CamelCase, and all possible values must be documented.

|
|errorCodeProperties|Object| |
|errorRef|string|UUID string that represents a reference of the error into e.g., the log file of the service. |
|missingPermissions|Array<string>|

Must be an array of strings containing a complete list of missing IAM permissions necessary to successfully execute the request. Should be set if the API returns a 403 - Forbidden response in case of missing OAuth user permissions.

|
|missingScopes|Array<string>|

Must be an array of strings containing a complete list of missing IAM scopes necessary to successfully execute the request. Should be set if the API returns a 403 - Forbidden response in case of missing OAuth scopes.

|
|traceId|string|String containing a 32-character hex integer value that is used for tracing. |

$3

Common API error structure, established by Dynatrace API guidelines.

#### Properties

| Name | Type | Description |
| --- | --- | --- |
|code^*required|number|

The error code should be set to the HTTP error code by default.

The error code may be set to an API-specific error code which must be properly documented.

|
|details|T|

Additional details about the error may be added in a details field. Refer to CommonErrorDetails

|
|help|string|

An additional help field may be added which must be a URL to further information on how to deal with the error.

This may be some detailed error documentation page or a link to the Dynatrace support system, etc.

|
|message^*required|string|The error message should be short and precise, it should not contain details. |

$3

CommonApiError details object reference. Contains common API error information.
This object is used to convey additional information about the error like e.g., which query parameter exactly violated a precondition.

Details may contain any fields to further describe the error

#### Properties

| Name | Type | Description |
| --- | --- | --- |
|constraintViolations|Array<ConstraintViolation>|An array of ConstraintViolation object, refer to ConstraintViolation object reference for more details. |
|errorCode|string|

String value representing a more detailed error information than the http response code alone. Must be a single word in CamelCase, and all possible values must be documented.

|
|errorRef|string|UUID string that represents a reference of the error into e.g., the log file of the service. |
|missingPermissions|Array<string>|

Must be an array of strings containing a complete list of missing IAM permissions necessary to successfully execute the request. Should be set if the API returns a 403 - Forbidden response in case of missing OAuth user permissions.

|
|missingScopes|Array<string>|

Must be an array of strings containing a complete list of missing IAM scopes necessary to successfully execute the request. Should be set if the API returns a 403 - Forbidden response in case of missing OAuth scopes.

|
|traceId|string|String containing a 32-character hex integer value that is used for tracing. |

$3

Contains information about an input parameter (path, query or request body)
that violated some validation rule of the service API and caused the warning.

May contain additional fields further describing the warning.

#### Properties

| Name | Type | Description |
| --- | --- | --- |
|message^*required|string|Mandatory field message describing the warning. |
|parameterLocation|string|Describes the general location of the violating parameter (query parameter, request body, etc.) |
|path|string|Refers to the violating parameter within the parameterLocation. |

$3

Basic error envelope, that enforces all error to have mandatory "error" property.

#### Properties

| Name | Type | Description |
| --- | --- | --- |
|error^*required|T|

error object must have two mandatory fields (code, message) and may have two additional fields (help, details): refer to the CommonApiError for more details.

|