The filter parameter, as explained here.
Filtering is supported on the following fields:
idnamebuiltIndeprecatedapplicableScopetag.key and tag.valuepage-key. |\n|config.pageKey|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Cursor for the next page of results, obtained from nextPageKey in the previous response. Can't be used together with page. |\n|config.pageSize|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|How many items to return at one time (max 500) |\n|config.sort|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The sort parameter, as explained here.
Sorting is supported on the following fields:
nameThe version of the object for optimistic locking. You can use it to detect simultaneous modifications by different users.
It's generated upon retrieval (GET requests). If set on update (PUT request) or deletion, the update/deletion will be allowed only if there wasn't any change between the retrieval and the update.
|\n\n\n\n\n#### Returns\n\n| Return type | Status code | Description |\n|---|---|---|\n|void|204|No Content|\n\n\n#### Throws\n\n| Error Type | Error Message |\n|---|---|\n|BadRequest|Malformed request or invalid parameters.|\n|Unauthorized|API token or tenant missing or corrupt.|\n|Forbidden|Access forbidden. This usually happens because the user lacks the permission to access the specific endpoint, or because the target entity isn't accessible to the user.|\n|NotFound|Not found.|\n|TooManyRequests|The client has sent too many requests in a given amount of time and has been rate-limited.|\n|InternalServerError|Internal server error.|\n\n\nThe filter parameter, as explained here.
Filtering is supported on the following fields:
idnametag.key and tag.valuepage-key. |\n|config.pageKey|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Cursor for the next page of results, obtained from nextPageKey in the previous response. Can't be used together with page. |\n|config.pageSize|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|How many items to return at one time (max 500) |\n|config.sort|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The sort parameter, as explained here.
Sorting is supported on the following fields:
nameThe version of the object for optimistic locking. You can use it to detect simultaneous modifications by different users.
It's generated upon retrieval (GET requests). If set on update (PUT request) or deletion, the update/deletion will be allowed only if there wasn't any change between the retrieval and the update.
|\n\n\n\n\n#### Returns\n\n| Return type | Status code | Description |\n|---|---|---|\n|void|200|Updated|\n\n\n#### Throws\n\n| Error Type | Error Message |\n|---|---|\n|BadRequest|Malformed request or invalid parameters.|\n|Unauthorized|API token or tenant missing or corrupt.|\n|Forbidden|Access forbidden. This usually happens because the user lacks the permission to access the specific endpoint, or because the target entity isn't accessible to the user.|\n|NotFound|Not found.|\n|Conflict|Optimistic locking failed, or the document is actively locked\\\\ \\\\ by another user, or some other conflict.|\n|TooManyRequests|The client has sent too many requests in a given amount of time and has been rate-limited.|\n|InternalServerError|Internal server error.|\n\n\n200). If not, the response contains the evaluationToken for further polling. |\n\n\n\n\n#### Returns\n\n| Return type | Status code | Description |\n|---|---|---|\n|[SloEvaluationResponse](#sloevaluationresponse)|200|SLO evaluation result|\n\n\n#### Throws\n\n| Error Type | Error Message |\n|---|---|\n|BadRequest|Malformed request or invalid parameters.|\n|Unauthorized|API token or tenant missing or corrupt.|\n|Forbidden|Access forbidden. This usually happens because the user lacks the permission to access the specific endpoint, or because the target entity isn't accessible to the user.|\n|Gone|The SLO Evaluation for the given evaluationToken isn't available anymore.|\n|TooManyRequests|The client has sent too many requests in a given amount of time and has been rate-limited.|\n|InternalServerError|Internal server error.|\n\n\nnow-7d) and ISO 8601 timestamps. |\n|timeframeTo|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The end of the timeframe. Supports relative time expressions (e.g. now-7d) and ISO 8601 timestamps. Defaults to now if omitted. |\n|warning|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)| |\n\n### CustomSli\n\n| Name | Type | Description |\n| --- | --- | --- |\n|filterSegments|FilterSegments|Represents a collection of filter segments. |\n|indicator*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |\n\n### Deprecation\n\n| Name | Type | Description |\n| --- | --- | --- |\n|deprecated*required|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|True if this template is deprecated and shouldn't be used for new SLOs. |\n|replacementTemplateId|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|If deprecated=true, this field may contain the ID of the template to use instead. |\n\n### Error\n\nAn error response as defined [here](https://dt-url.net/platform-services-error-handling).\n\n| Name | Type | Description |\n| --- | --- | --- |\n|code*required|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)| |\n|details|ErrorDetails|Optional details of the error |\n|message*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |\n\n### ErrorDetails\n\nOptional details of the error\n\n| Name | Type | Description |\n| --- | --- | --- |\n|constraintViolations|Array<ConstraintViolation>|A list of constraint violations of input parameters (path, query, request body) |\n|errorRef|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|reference to the error occurrence in the internal self-monitoring, logging, etc. |\n\n### ErrorEnvelope\n\n| Name | Type | Description |\n| --- | --- | --- |\n|error*required|Error|An error response as defined here. |\n\n### FilterSegment\n\nA filter segment is identified by an ID.\n\n| Name | Type | Description |\n| --- | --- | --- |\n|id*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The identifier of the filter segment. |\n|variables|Array<FilterSegmentVariable>| |\n\n### FilterSegmentVariable\n\nDefines a variable with a name and a list of values.\n\n| Name | Type | Description |\n| --- | --- | --- |\n|name*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The name of the variable. |\n|values*required|Array<[string](https://developer.mozilla.org/en-US/docs/Glossary/String)>|The list of values for this variable. |\n\n### FilterSegments\n\nRepresents a collection of filter segments.\n\n**type**: Array<FilterSegment>\n\n### Metadata\n\n| Name | Type | Description |\n| --- | --- | --- |\n|evaluatedSliQuery*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The resolved DQL query that was actually executed for this evaluation. |\n\n### MetadataResponse\n\n| Name | Type |\n| --- | --- |\n|metadata*required|Metadata|\n\n### ObjectiveTemplate\n\n| Name | Type | Description |\n| --- | --- | --- |\n|applicableScope*required|\"SERVICE\" | \"HOST\" | \"APPLICATION\" | \"CLOUD_APPLICATION\" | \"KUBERNETES_CLUSTER\" | \"CLOUD_APPLICATION_NAMESPACE\" | \"ALL\"| |\n|builtIn*required|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)| |\n|deprecation|Deprecation| |\n|description|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |\n|externalId|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|An optional user-provided external identifier for the objective template. Must be unique across all objective templates. |\n|id*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |\n|indicator*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |\n|name*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |\n|tags|Array<[string](https://developer.mozilla.org/en-US/docs/Glossary/String)>|A list of tags for this objective template. Tags can be plain strings (e.g. myTag) or key-value pairs separated by a colon (e.g. Stage:DEV). To include a literal colon in a tag, escape it with a backslash (e.g. key\\\\:value). |\n|variables*required|Array<TemplateVariable>| |\n|version|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The version of the object for optimistic locking. You can use it to detect simultaneous modifications by different users.
It's generated upon retrieval (GET requests). If set on update (PUT request) or deletion, the update/deletion will be allowed only if there wasn't any change between the retrieval and the update.
|\n\n### ObjectiveTemplateConfig\n\n| Name | Type | Description |\n| --- | --- | --- |\n|applicableScope*required|\"SERVICE\" | \"HOST\" | \"APPLICATION\" | \"CLOUD_APPLICATION\" | \"KUBERNETES_CLUSTER\" | \"CLOUD_APPLICATION_NAMESPACE\" | \"ALL\"| |\n|description|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |\n|externalId|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|An optional user-provided external identifier for the objective template. Must be unique across all objective templates. |\n|indicator*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |\n|name*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |\n|tags|Array<[string](https://developer.mozilla.org/en-US/docs/Glossary/String)>|A list of tags for this objective template. Tags can be plain strings (e.g.myTag) or key-value pairs separated by a colon (e.g. Stage:DEV). To include a literal colon in a tag, escape it with a backslash (e.g. key\\\\:value). |\n|variables*required|Array<TemplateVariable>| |\n\n### ObjectiveTemplateList\n\n| Name | Type | Description |\n| --- | --- | --- |\n|items*required|Array<ObjectiveTemplate>| |\n|nextPageKey|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The cursor for the next page of results. Has the value of null on the last page.
Use it in the page-key query parameter to obtain subsequent pages of the result.
|\n|totalCount*required|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The total number of entries in the result. |\n\n### SliReference\n\n| Name | Type | Description |\n| --- | --- | --- |\n|templateId*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Theid of the objective template to use as the SLI definition. |\n|variables*required|Array<SliReferenceVariable>| |\n\n### SliReferenceVariable\n\n| Name | Type |\n| --- | --- |\n|name*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| \n|value*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|\n\n### Slo\n\nConfiguration for a service-level objective. Exactly one of `sliReference` or `customSli` must be provided. Providing both or neither results in a `400 Bad Request`.\n\n| Name | Type | Description |\n| --- | --- | --- |\n|criteria*required|Array<Criteria>| |\n|customSli|CustomSli| |\n|description|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |\n|externalId|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|An optional user-provided external identifier for the SLO. Must be unique across all SLOs. |\n|id*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |\n|name*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |\n|sliReference|SliReference| |\n|tags|Array<[string](https://developer.mozilla.org/en-US/docs/Glossary/String)>|A list of tags for this SLO. Tags can be plain strings (e.g. myTag) or key-value pairs separated by a colon (e.g. Stage:DEV). To include a literal colon in a tag, escape it with a backslash (e.g. key\\\\:value). |\n|version*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The version of the object for optimistic locking. You can use it to detect simultaneous modifications by different users.
It's generated upon retrieval (GET requests). If set on update (PUT request) or deletion, the update/deletion will be allowed only if there wasn't any change between the retrieval and the update.
|\n\n### SloConfig\n\nConfiguration for a service-level objective. Exactly one of `sliReference` or `customSli` must be provided. Providing both or neither results in a `400 Bad Request`.\n\n| Name | Type | Description |\n| --- | --- | --- |\n|criteria*required|Array<Criteria>| |\n|customSli|CustomSli| |\n|description|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |\n|externalId|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|An optional user-provided external identifier for the SLO. Must be unique across all SLOs. |\n|name*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |\n|sliReference|SliReference| |\n|tags|Array<[string](https://developer.mozilla.org/en-US/docs/Glossary/String)>|A list of tags for this SLO. Tags can be plain strings (e.g.myTag) or key-value pairs separated by a colon (e.g. Stage:DEV). To include a literal colon in a tag, escape it with a backslash (e.g. key\\\\:value). |\n\n### SloEvaluationBaseResponse\n\n| Name | Type |\n| --- | --- |\n|evaluationResults|Array<SloEvaluationResult>| \n|metadata*required|Metadata|\n\n### SloEvaluationCancelResponse\n\n| Name | Type |\n| --- | --- |\n|definition*required|Slo| \n|evaluationResults|Array<SloEvaluationResult>| \n|metadata*required|Metadata|\n\n### SloEvaluationRequest\n\n| Name | Type | Description |\n| --- | --- | --- |\n|customTimeframe|Timeframe| |\n|filterSegments|Array<FilterSegment>|Filter segments to apply during this evaluation. The effective filter for each segment is the intersection of the segment defined on the SLO and the segment provided here. If only one side defines a segment, that segment is used as-is. |\n|id*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |\n|requestTimeoutMilliseconds|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|How long to wait for the evaluation result before returning in milliseconds. If the evaluation finishes within this time, the result is returned directly (200). If not, a 202 is returned with an evaluationToken that can be used to poll for the result. default: 1000|\n\n### SloEvaluationResponse\n\n| Name | Type | Description |\n| --- | --- | --- |\n|definition*required|Slo| |\n|evaluationResults|Array<SloEvaluationResult>| |\n|evaluationToken|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Token to pass to evaluation:poll or evaluation:cancel to retrieve or discard the evaluation result. |\n|metadata*required|Metadata| |\n|ttlSeconds|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)| |\n\n### SloEvaluationResult\n\n| Name | Type | Description |\n| --- | --- | --- |\n|criteria*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |\n|errorBudget|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)| |\n|message|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |\n|status*required|\"SUCCESS\" | \"WARNING\" | \"FAILURE\" | \"ERROR\"|The status of an SLO evaluation. SUCCESS and WARNING indicate the SLO was evaluated successfully (target met or warning threshold breached respectively). FAILURE means the SLO target wasn't met. ERROR means the evaluation couldn't be completed due to a system or query error. |\n|value|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The evaluated SLO compliance as a percentage (0–100). |\n\n### SloObjectsList\n\n| Name | Type | Description |\n| --- | --- | --- |\n|nextPageKey|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The cursor for the next page of results. Has the value of null on the last page.
Use it in the page-key query parameter to obtain subsequent pages of the result.
|\n|slos*required|Array<Slo>| |\n|totalCount*required|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The total number of entries in the result. |\n\n### TemplateVariable\n\n| Name | Type | Description |\n| --- | --- | --- |\n|name*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |\n|scope*required|\"CUSTOM\" | \"SERVICE\" | \"SMARTSCAPE_SERVICE\" | \"HOST\" | \"SMARTSCAPE_HOST\" | \"APPLICATION\" | \"CLOUD_APPLICATION\" | \"KUBERNETES_CLUSTER\" | \"SMARTSCAPE_K8S_CLUSTER\" | \"CLOUD_APPLICATION_NAMESPACE\" | \"SMARTSCAPE_K8S_NAMESPACE\"|The scope of a template variable. UseSMARTSCAPE_\\* variants when referencing Smartscape objective templates. |\n\n### Timeframe\n\n| Name | Type | Description |\n| --- | --- | --- |\n|timeframeFrom*required|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The start of the timeframe. Supports relative time expressions (e.g. now-7d) and ISO 8601 timestamps. |\n|timeframeTo|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The end of the timeframe. Supports relative time expressions (e.g. now-7d) and ISO 8601 timestamps. Defaults to now if omitted. |\n\n## Enums\n\n\n### ~~EvaluationStatus~~\n\n> ⚠️ **Deprecated**\n> Use literal values.\n\n