Skip to main content
Dynatrace logo
  • Category: analytics
  • Auth: OAUTH2
  • Composio-managed OAuth available? No
  • Tools: 170
  • Triggers: 0
  • Slug: DYNATRACE
  • Version: 20261101_00

Tools

Slug: DYNATRACE_ACQUIRE_LOCKAcquire or extend the current user’s lock on a document. A user can lock at most five documents, and a lock can last at most 15 minutes.

Input Parameters

string
required
System-generated or user-given document ID.
object
required
Document version and optional duration for the lock.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_ADD_DIRECT_SHARE_RECIPIENTSAdd users or groups to an accessible Dynatrace direct share.

Input Parameters

string
required
System-generated ID of the direct share.
object
required
Recipients payload from the official Dynatrace SDK.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
boolean
Whether Dynatrace should notify added recipients. The provider defaults to true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_ADD_SETTINGS_OBJECT_ACCESSOR_PERMISSIONSGrant read or write permissions on a settings object to one accessor.

Input Parameters

object
required
Accessor and permissions defined by the Dynatrace Settings API.
string
required
ID of the settings object on which to grant permissions.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_AUTOCOMPLETE_GRAIL_QUERYReturn structured Dynatrace Grail DQL completion suggestions at an optional cursor position. The connected OAuth client and user need at least one supported storage read permission, plus storage:<table>:read for every dataset referenced by the DQL query.

Input Parameters

object
required
Grail autocomplete request parameters.
string
Optional non-sensitive client context used by Dynatrace to monitor query execution.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_BULK_DELETE_DOCUMENTMove up to 100 documents to trash in one request. Per-document outcomes may be returned; trashed documents are inaccessible until restored.

Input Parameters

object
required
Bulk document deletion request defined by the Dynatrace Document API.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_CANCEL_EXECUTIONRequest cancellation of an active workflow execution. Acceptance does not wait for the execution to reach CANCELLED.

Input Parameters

string
required
UUID of the active execution to cancel.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_CANCEL_GRAIL_QUERYCancel a Grail query identified by its request token. The connected OAuth client and user need at least one supported storage read permission, plus storage:<table>:read for every dataset referenced by the original query.

Input Parameters

string
Additional metadata enrichment to request, such as metric-metadata.
string
required
The request token of the Grail query to cancel. The connected OAuth client and user must retain storage:<table>:read for every dataset referenced by that query.
string
Optional non-sensitive client context used to monitor query execution.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_CANCEL_TASK_EXECUTIONRequest cancellation of an active task execution. Acceptance does not wait for the task or workflow to reach a terminal state.

Input Parameters

string
required
Task name to cancel.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string
required
Parent execution UUID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_CLAIM_ENVIRONMENT_SHAREClaim another user’s environment share and gain its granted access to the shared document. This access cannot be relinquished by the claimer.

Input Parameters

string
required
Environment-share ID to claim.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_CLOSE_PROBLEMClose an open Dynatrace problem and add the supplied closing comment. Closure is an irreversible state change; an already closed problem is left unchanged.

Input Parameters

object
required
Comment to persist as part of the irreversible problem closure.
string
required
ID of the open problem to close irreversibly.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_CREATE_BUSINESS_CALENDARCreate a Dynatrace Automation business calendar.

Input Parameters

object
required
Business calendar to create.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_CREATE_DIRECT_SHARECreate a read or read-write direct share for a Dynatrace document.

Input Parameters

object
required
Direct-share definition from the official Dynatrace SDK.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
boolean
Whether Dynatrace should notify recipients. The provider defaults to true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_CREATE_DOCUMENTCreate a Dynatrace document from metadata and up to 50 MB of binary content.

Input Parameters

object
required
Metadata and binary content for the new document.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_CREATE_ENVIRONMENT_SHARECreate an environment-wide share link for a document owned by or reshareable by the connected user.

Input Parameters

object
required
Document and access level for the new environment share.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_CREATE_PROBLEM_COMMENTAdd a new visible comment to an existing Dynatrace problem. The operation mutates the problem’s comment history.

Input Parameters

object
required
The visible comment content that Dynatrace will add to the problem.
string
required
ID of the existing problem that will receive the new comment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_CREATE_SCHEDULING_RULECreate a Dynatrace scheduling rule from the official SDK rule contract.

Input Parameters

object
required
Exact Dynatrace SDK rule creation body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_CREATE_WORKFLOWCreate a Dynatrace workflow from its task and trigger definition.

Input Parameters

object
required
Complete workflow definition.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_DELETE_BUSINESS_CALENDARDelete a Dynatrace Automation business calendar.

Input Parameters

string
required
UUID identifying the business calendar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_DELETE_DIRECT_SHAREDelete a direct share without deleting its Dynatrace document.

Input Parameters

string
required
System-generated ID of the direct share.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_DELETE_DOCUMENTMove a document to the trash. The caller must own the document and provide its current optimistic-locking version.

Input Parameters

string
required
System-generated or user-given document ID.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string
required
Current document version required for optimistic locking.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_DELETE_ENVIRONMENT_SHAREDelete an environment share and revoke the document access granted through that share from all claimers.

Input Parameters

string
required
Environment-share ID to delete.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_DELETE_METRICIrreversibly trigger deletion of one metric ingested through Metrics v2. Dynatrace rejects metrics written within the last two hours and does not delete the metric’s data from Grail storage.

Input Parameters

string
required
Exact key of the Metrics v2-ingested metric to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_DELETE_METRICSIrreversibly trigger bulk deletion of Metrics v2-ingested metrics selected by metric_selector and age. Wildcards can select many or all custom metrics. This does not delete metric data from Grail storage.

Input Parameters

string
required
Selector for Metrics v2-ingested metrics to delete. A trailing * selects related metrics, and * selects all custom metrics; review wildcard selectors carefully.
integer
required
Delete only metrics not written for at least this many days (30 through 1825).
boolean
Set true only when metric_selector is exactly * to confirm deletion of all eligible custom metrics. Narrower wildcard selectors do not require it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_DELETE_PROBLEM_COMMENTPermanently delete one identified comment from an identified Dynatrace problem. This action cannot restore the deleted comment.

Input Parameters

string
required
ID of the comment to permanently delete from the specified problem.
string
required
ID of the problem containing the comment to permanently delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_DELETE_SCHEDULING_RULEPermanently delete one scheduling rule by UUID.

Input Parameters

string
required
A UUID string identifying this rule.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_DELETE_SETTINGS_OBJECTDelete a Dynatrace settings object using optimistic locking.

Input Parameters

string
required
ID of the settings object to delete.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string
required
Current object version required for optimistic locking.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_DELETE_SETTINGS_OBJECT_ACCESSOR_PERMISSIONSRemove every permission a user, group, or all-users accessor has on a settings object.

Input Parameters

string
required
ID of the settings object whose accessor permissions to remove.
string
User or group UUID. Required for user and group; omit for all_users.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string ("user" | "group" | "all_users")
required
Type of accessor: user, group, or all_users.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_DELETE_SNAPSHOTIrrevocably delete a snapshot without changing the document’s current state. Only the document owner can delete it. Deletion does not consume Dynatrace’s snapshot creation quota of 5 snapshots per document within 60 seconds.

Input Parameters

string
required
System-generated or user-given document ID.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
integer
required
System-generated snapshot version to irrevocably delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_DELETE_TRASHED_DOCUMENTIrreversibly destroy a trashed Dynatrace document owned by the connected user. This operation cannot be undone.

Input Parameters

string
required
System-generated or user-given ID of the trashed document to destroy.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_DELETE_TRASHED_WORKFLOWPermanently delete a workflow that is already in trash.

Input Parameters

string
required
UUID of the trashed workflow to permanently delete.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_DELETE_WEBHOOK_HANDLERDelete a webhook handler using an installed Dynatrace app as its context.

Input Parameters

string
required
Installed Dynatrace app ID used as the required application context.
string
required
ID of the connection this webhook handler belongs to.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_DOWNLOAD_DOCUMENT_CONTENTDownload the binary content of the latest document version or a specific snapshot, preserving the provider’s filename and MIME type.

Input Parameters

string
required
System-generated or user-given document ID.
string
Optional trimmed download filename and extension returned in Content-Disposition.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
integer
Snapshot version to download instead of the latest document content.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_DUPLICATE_BUSINESS_CALENDARCreate a copy of a Dynatrace Automation business calendar.

Input Parameters

string
required
UUID identifying the business calendar to duplicate.
object
required
Options for the duplicated business calendar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_DUPLICATE_SCHEDULING_RULEDuplicate a Dynatrace scheduling rule, optionally assigning a new title.

Input Parameters

string
required
UUID of the scheduling rule to duplicate.
object
required
Options for the duplicated scheduling rule.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_DUPLICATE_WORKFLOWCreate a new workflow by copying an existing Dynatrace workflow.

Input Parameters

string
required
UUID of the workflow to duplicate.
object
required
Options for the new workflow copy.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_EXECUTE_GRAIL_QUERYStart a Grail DQL query and return its state, with a result or polling token when available. The connected OAuth client and user need at least one supported storage read permission, plus storage:<table>:read for every dataset referenced by the query.

Input Parameters

object
required
Exact request body defined by the official Dynatrace Grail SDK schema.
string
Additional metadata enrichment to request, such as metric-metadata.
string
Optional non-sensitive client context used to monitor query execution.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_EXPORT_WORKFLOWExport a workflow as the provider’s JSON WorkflowExport definition.

Input Parameters

string
required
UUID of the workflow to export.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_EXPORT_WORKFLOW_HISTORY_RECORDExport one historical workflow version as a transferable JSON workflow definition, including its tasks and configuration. Use Inspect Workflow History Record instead for read-only inspection of saved runtime metadata.

Input Parameters

string
required
UUID of the workflow whose history to export.
string
required
Workflow history version to export.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_EXPORT_WORKFLOW_TEMPLATEExport the current workflow or a specified historical version as a reusable template. Returns a structured template containing the workflow definition and template metadata. Administrator access requires the corresponding OAuth permission.

Input Parameters

string
required
UUID of the workflow to export as a template.
string
Workflow history version to export. Omit to export the workflow’s current version.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GENERATE_SCHEMA_DEFAULT_VALUEGenerate the default settings value for a Dynatrace schema and optional scope.

Input Parameters

string
Scope used to generate the default value.
string
required
ID of the settings schema.
string
Schema version; the latest version is used when omitted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_ACTION_EXECUTIONReturn one Dynatrace Automation action execution.

Input Parameters

string
required
UUID identifying the action execution.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_ACTION_EXECUTION_LOGReturn the plain-text log for a Dynatrace Automation action execution.

Input Parameters

string
required
UUID identifying the action execution.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_ACTION_SAMPLE_RESULTReturn the sample result for a Dynatrace Automation action. This provider endpoint is deprecated; Dynatrace does not name a replacement.

Input Parameters

string
required
Dynatrace action identifier whose sample result to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_BUSINESS_CALENDARReturn one Dynatrace Automation business calendar.

Input Parameters

string
required
UUID identifying the business calendar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_BUSINESS_CALENDAR_HISTORY_RECORDReturn one historical version of a Dynatrace Automation business calendar.

Input Parameters

string
required
UUID identifying the business calendar.
string
required
Business calendar history version.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_DIRECT_SHAREReturn an accessible Dynatrace direct share by its ID.

Input Parameters

string
required
System-generated ID of the direct share.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_DOCUMENTRetrieve a document’s metadata or binary content, optionally from a snapshot. The response may contain either or both.

Input Parameters

string
required
System-generated or user-given document ID.
string
Optional filename and extension returned for the downloaded content.
string
Comma-separated optional metadata fields to include.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
integer
Snapshot version to retrieve instead of the current document.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_DOCUMENT_METADATAReturn metadata for the latest version or a specific snapshot of a document.

Input Parameters

string
required
System-generated or user-given document ID.
string
Comma-separated additional fields: userContext.lastAccessedTime, userContext.isFavorite, or modificationInfo.lastModifyingAppId.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
integer
Snapshot version whose metadata should be returned instead of the latest version.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_ENTITYReturn one monitored entity by its Dynatrace entity identifier.

Input Parameters

string
End of the requested timeframe as a timestamp or relative expression.
string
Start of the requested timeframe as a timestamp or relative expression.
string
Comma-separated additional entity properties to include.
string
required
Dynatrace entity identifier, including its type prefix.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_ENTITY_TYPEReturn the schema and relationship metadata for one Dynatrace entity type.

Input Parameters

string
required
Entity type identifier, for example HOST.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_ENVIRONMENT_SHARERetrieve an accessible Dynatrace environment share by its ID.

Input Parameters

string
required
Environment-share ID to retrieve.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_EVENTReturn one Dynatrace event by its event ID; the connected environment must expose the Events v2 REST endpoint.

Input Parameters

string
required
ID of the Dynatrace event to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_EVENT_PROPERTYReturn details of one event property supported by the Dynatrace environment.

Input Parameters

string
required
Event property key to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_EVENT_TYPEReturn details of one event type supported by the Dynatrace environment.

Input Parameters

string
required
Event type identifier to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_EXECUTIONReturn a workflow execution and its current asynchronous state.

Input Parameters

string
required
Execution UUID.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_EXECUTION_LOGReturn the plain-text log for one workflow execution.

Input Parameters

string
required
A UUID string identifying this execution.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_HOLIDAY_CALENDARReturn a country’s holidays, optionally bounded by an inclusive date range.

Input Parameters

string
Optional last date of the holiday range in YYYY-MM-DD format.
string
required
The country name.
string
Optional first date of the holiday range in YYYY-MM-DD format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_METRIC_DESCRIPTORReturn the descriptor of one metric by its metric key.

Input Parameters

string
required
Metric key, optionally followed by colon-separated metric selector transformations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_PROBLEMReturn details of one Dynatrace problem by its problem ID.

Input Parameters

string
Comma-separated additional properties: evidenceDetails, impactAnalysis, recentComments.
string
required
ID of the Dynatrace problem to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_PROBLEM_COMMENTReturn one identified comment from a Dynatrace problem.

Input Parameters

string
required
ID of the comment to retrieve.
string
required
ID of the problem containing the comment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_SCHEDULING_RULEReturn one scheduling rule by UUID.

Input Parameters

string
required
A UUID string identifying this rule.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_SCHEDULING_RULE_HISTORY_RECORDReturn one historical version of a Dynatrace scheduling rule.

Input Parameters

string
required
UUID of the scheduling rule.
string
required
Historical rule version to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_SCHEMA_DEFINITIONRetrieve the complete definition of a Dynatrace settings schema.

Input Parameters

string
required
ID of the settings schema.
string
Schema version to retrieve; omit it to retrieve the latest version.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_SETTINGSReturn Dynatrace Automation system settings and execution limits. This provider endpoint is deprecated; Dynatrace does not name a replacement.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_SETTINGS_OBJECTReturn a Dynatrace settings object by ID; secret properties remain irreversibly masked outside trusted app functions.

Input Parameters

string
required
ID of the settings object.
string
Comma-separated additional top-level fields to include.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_SETTINGS_OBJECT_ACCESSOR_PERMISSIONSReturn a user, group, or all-users accessor’s permissions on one Dynatrace settings object.

Input Parameters

string
required
ID of the settings object whose accessor permissions to return.
string
User or group UUID. Required for user and group; omit for all_users.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string ("user" | "group" | "all_users")
required
Type of accessor: user, group, or all_users.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_SETTINGS_OBJECT_PERMISSIONSReturn every accessor and permission configured on a settings object.

Input Parameters

string
required
ID of the settings object whose permissions to return.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_SNAPSHOT_METADATAReturn metadata about a specific snapshot, not the snapshotted document content. This read does not create snapshots; Dynatrace limits snapshot creation by other operations to 5 snapshots per document within 60 seconds. Requires write access to the document.

Input Parameters

string
required
System-generated or user-given document ID.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
integer
required
System-generated snapshot version.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_TASK_EXECUTIONReturn one task execution, including its asynchronous state and result.

Input Parameters

string
required
Task name.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string
required
Parent execution UUID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_TASK_EXECUTION_INPUTReturn the merged JSON inputs from all action executions belonging to a task execution.

Input Parameters

string
required
Task name.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string
required
Parent execution UUID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_TASK_EXECUTION_LOGReturn the raw standard-output log for a task execution; the log can be large.

Input Parameters

string
required
Task name.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string
required
Parent execution UUID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_TASK_EXECUTION_RESULTReturn the merged JSON results from all action executions belonging to a task execution.

Input Parameters

string
required
Task name.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string
required
Parent execution UUID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_TRANSITIONSReturn workflow task transitions keyed by transition name for an execution.

Input Parameters

boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string
required
Workflow execution UUID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_USER_PERMISSIONSReturn the connected user’s effective Dynatrace Automation permissions. This provider endpoint is deprecated; Dynatrace does not name a replacement.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_USER_SETTINGSReturn Dynatrace Automation settings for the connected user. This provider endpoint is deprecated; Dynatrace does not name a replacement.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_VERSIONDiagnostic endpoint that returns the Dynatrace Automation service version; it does not inspect or change user resources.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_WEBHOOK_HANDLERReturn one webhook handler for an installed Dynatrace app context.

Input Parameters

string
required
ID of an installed Dynatrace app, sent as the required DT-APP-CONTEXT header.
string
required
Connection ID whose webhook handler to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_WORKFLOWReturn a workflow by UUID.

Input Parameters

string
required
UUID of the workflow to return.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_WORKFLOW_HISTORY_RECORDRetrieve one saved workflow history version for inspection, including its runtime and modification metadata. Use Export Workflow History Record instead when the JSON definition will be transferred or reused.

Input Parameters

string
required
UUID of the workflow whose history to inspect.
string
required
Workflow history version to return.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_GET_WORKFLOW_TASKReturn one task definition from a Dynatrace workflow.

Input Parameters

string
required
Task name or ID within the workflow.
string
required
UUID of the workflow containing the task.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_INGEST_EVENTIngest one event into the connected Dynatrace environment. The operation can fail on rejected ingestion results even if some event reports were created.

Input Parameters

object
required
Event type, title, timing, target, and optional properties.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_INGEST_METRIC_DATA_POINTSIngest newline-separated Dynatrace metric line protocol as raw text. Return the documented accepted/invalid line report even when line validation produces HTTP 400; rejected lines are not ingested, so always inspect linesInvalid and error.

Input Parameters

string
required
Dynatrace metric line-protocol records separated by newlines; sent as raw text/plain bytes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_INSPECT_LOCKInspect a document lock, including its owner and document version.

Input Parameters

string
required
System-generated or user-given document ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_INSPECT_TRASHED_DOCUMENTReturn metadata and deletion audit information for a trashed Dynatrace document. Elevated administrator access is available with the corresponding permission.

Input Parameters

string
required
System-generated or user-given ID of the trashed document to inspect.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_ALL_EVENT_LOGSReturn all structured event log entries for a workflow execution.

Input Parameters

string
required
Execution UUID.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_AUTOMATION_SERVICE_USERSReturn service users available as Dynatrace workflow actors. This provider endpoint is deprecated; Dynatrace does not name a replacement.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_BUSINESS_CALENDAR_HISTORY_RECORDSReturn the change history for a Dynatrace Automation business calendar.

Input Parameters

string
required
UUID identifying the business calendar.
boolean
Whether to include the latest historical record; defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_BUSINESS_CALENDARSReturn one page of Dynatrace Automation business calendars.

Input Parameters

integer
Number of results to return per page.
string
Initial result index, or next_cursor returned by the preceding page.
Term used to search business calendars.
string
Field used to order results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_DIRECT_SHARE_RECIPIENTSReturn one page of users and groups assigned to a direct share.

Input Parameters

string
required
System-generated ID of the direct share.
integer
One-based page number to retrieve directly.
string
Continuation key returned as next_cursor by the preceding page.
integer
Maximum number of recipients to return; Dynatrace defaults to 20.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_DIRECT_SHARESReturn one page of direct shares accessible to the connected user.

Input Parameters

integer
One-based page number to retrieve directly.
string
Filter direct shares by documentId using the Dynatrace Platform filter syntax and equality operator.
string
Continuation key returned as next_cursor by the preceding page.
integer
Maximum number of direct shares to return; Dynatrace defaults to 20.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_DOCUMENTSReturn one page of documents accessible to the connected user.

Input Parameters

integer
One-based page number to access directly.
string
Comma-separated sort fields; prefix descending fields with a minus sign.
string
Dynatrace document filter expression; field names are case-sensitive.
string
Cursor returned as next_cursor by the preceding page.
integer
Maximum documents to return on this page (1-1000; default 20).
string
Comma-separated optional metadata fields to include in each document.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_EFFECTIVE_SETTINGS_VALUESReturn one page of effective settings values, including schema defaults. A page may be incomplete and include error details.

Input Parameters

string
Optional settings scope filter considered only on the first page.
string
Continuation key returned as next_cursor by the preceding page.
integer
Maximum values on this page (1-500).
string
Optional schema ID filter considered only on the first page.
string
Comma-separated additional top-level response fields.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string
Values-list version used for a consistent read.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_ENTITIESReturn one page of monitored entities matching an entity selector.

Input Parameters

string
End of the query timeframe as an absolute timestamp or relative expression.
string
Display-name ordering for the first page, such as name, +name, or -name.
string
Start of the query timeframe as an absolute timestamp or relative expression.
string
Comma-separated additional entity fields to include.
integer
Maximum entities to return on the first page.
string
Cursor returned as next_cursor by the preceding page.
string
Entity selector for the first page, for example type(HOST).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_ENTITY_TYPESReturn one page of entity types from the connected Dynatrace environment.

Input Parameters

integer
Maximum entity types to return on the first page.
string
Cursor returned as next_cursor by the preceding page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_ENVIRONMENT_SHARE_CLAIMERSReturn one page of users who claimed an accessible environment share.

Input Parameters

string
required
Environment-share ID whose claimers to list.
integer
One-based page number to retrieve directly.
string
Continuation cursor from a previous response’s next_cursor. Omit for the first page; pass the returned value back verbatim to fetch the next page.
integer
Maximum number of claimers to return. Dynatrace defaults to 20.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_ENVIRONMENT_SHARESReturn one page of environment shares accessible to the connected user.

Input Parameters

integer
One-based page number to retrieve directly.
string
Filter environment shares by documentId using the Dynatrace Platform filter syntax and equality operator.
string
Continuation cursor from a previous response’s next_cursor. Omit for the first page; pass the returned value back verbatim to fetch the next page.
integer
Maximum number of environment shares to return. Dynatrace defaults to 20.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_EVENT_PROPERTIESReturn one page of event properties supported by the Dynatrace environment.

Input Parameters

integer
Maximum event properties to return on the first page.
string
Cursor returned as next_cursor by the preceding page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_EVENTSReturn one page of events; the connected environment must expose the Environment API v2 endpoint.

Input Parameters

string
End of the first-page timeframe as a timestamp or relative expression.
string
Start of the first-page timeframe as a timestamp or relative expression.
integer
Maximum events to return on the first page.
string
Cursor returned as next_cursor by the preceding page.
string
Event selector used to filter the first page.
string
Entity selector used to filter the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_EVENT_TYPESReturn one page of event types supported by the Dynatrace environment.

Input Parameters

integer
Maximum event types to return on the first page.
string
Cursor returned as next_cursor by the preceding page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_EXECUTION_ACTIONSReturn action identifiers assigned to tasks in a workflow execution.

Input Parameters

string
required
Execution UUID.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_EXECUTIONSReturn one filtered page of workflow executions and the offset for the next page.

Input Parameters

array
Users to match.
integer
Maximum results to return.
array
Execution states to match.
integer
Zero-based result offset.
string
Search term.
string
Trigger ID to match.
string
Field used to order results.
array
Schedule IDs to match.
array
Workflow IDs to match.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string
Trigger type to match.
string
Inclusive lower bound for the start timestamp.
string
Inclusive upper bound for the start timestamp.
string
Parent workflow ID to match.
string
Parent execution ID to match.
string
Parent execution and task pair to match.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_HOLIDAY_CALENDAR_COUNTRIESReturn countries that can be used to retrieve a holiday calendar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_LABELSReturn one alphabetically sorted page of labels accessible to the connected user, optionally filtered by substring and document type.

Input Parameters

integer
Specific page number to return. Pages start at 1.
string
Label substring to match. Prefix matches are returned before other substring matches.
string
Continuation token returned as next_cursor by a previous call.
integer
Maximum labels to return. Dynatrace defaults to 20 and allows up to 1000.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
array
Case-sensitive document types whose labels should be returned.
boolean
Whether to intersect document_types with types supported by installed apps. Dynatrace defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_METRIC_DESCRIPTORSReturn one page of metric descriptors; the connected environment must expose the Environment API v2 endpoint.

Input Parameters

string
Registry search term used to filter the first page.
string
Comma-separated additional descriptor fields to include on the first page.
integer
Maximum metric descriptors to return on the first page.
string
Cursor returned as next_cursor by the preceding page.
string
Timeframe in which matching metrics must have data points.
string
Metric selector used to filter the first page.
string
Metadata selector used to filter the first page.
string ("INCLUDE" | "EXCLUDE")
Whether to include or exclude metrics written in written_since.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_PROBLEM_COMMENTSReturn one page of comments attached to a Dynatrace problem.

Input Parameters

integer
Maximum comments to return on the first page; Dynatrace defaults to 10.
string
required
ID of the problem whose comments to list.
string
Cursor returned as next_cursor by the preceding page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_PROBLEMSReturn one filtered page of Dynatrace problems and a continuation cursor.

Input Parameters

string
End of the first-page timeframe as an absolute timestamp or relative expression.
string
Comma-separated sort fields with optional + or - order prefixes.
string
Start of the first-page timeframe as an absolute timestamp or relative expression.
string
Comma-separated optional problem properties to include on this page.
integer
Maximum problems to return on the first page.
string
Cursor returned as next_cursor by the preceding page.
string
Dynatrace entity selector for the first page.
string
Dynatrace problem selector for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_SCHEDULE_TIMEZONESReturn timezone names accepted by Dynatrace schedules.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_SCHEDULING_RULE_HISTORY_RECORDSReturn the version history records for a Dynatrace scheduling rule.

Input Parameters

string
required
UUID of the scheduling rule.
boolean
Include the latest historical record. Dynatrace defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_SCHEDULING_RULESReturn one page of scheduling rules matching optional search and ordering criteria.

Input Parameters

integer
Results per page.
integer
Initial result index.
string
Rule search term.
string
Field used to order results.
string
Cursor returned by the preceding page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_SCHEMA_DEFINITIONSList all settings schemas available to the connected Dynatrace user.

Input Parameters

string
Comma-separated additional top-level fields: schemaId, displayName, latestSchemaVersion, maturity, multiObject, ordered, ownerBasedAccessControl, or schemaVersions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_SETTINGS_HISTORYReturn one page of revision history for Dynatrace settings objects.

Input Parameters

string
Sort expression; defaults to descending modification time.
string
Settings scope. Required with schema_ids on the first page.
string
Settings history filter expression; without one, only the last two weeks are returned.
string
Cursor returned as next_cursor. Omit every other query parameter when using it.
integer
Maximum revisions on this page (1-5000; default 100).
string
Comma-separated additional top-level revision fields to return.
string
Comma-separated schema IDs. Required with scope on the first page.
boolean
Use elevated administrator access; requires settings:objects:admin when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_SETTINGS_OBJECTSReturn one page of persisted settings objects for one schema and scope. A page may be incomplete, with error details in the response.

Input Parameters

string
Dynatrace settings sort expression.
string
Object scope. Required with schema_id on the first page.
string
Dynatrace settings filter expression.
string
Continuation key returned as next_cursor by the preceding page.
integer
Maximum objects on this page (1-500).
string
Single schema ID. Required with scope on the first page.
string
Comma-separated additional top-level response fields.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string
Objects-list version used for a consistent read.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_SNAPSHOTSReturn one page of a document’s snapshots in descending version order. This read does not create snapshots; Dynatrace limits snapshot creation by other operations to 5 snapshots per document within 60 seconds. Requires write access to the document.

Input Parameters

string
required
System-generated or user-given document ID.
integer
Specific page number to return. Pages start at 1.
string
Continuation token returned as next_cursor by a previous call.
integer
Maximum snapshots to return. Dynatrace defaults to 20 and allows up to 1000.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_TASK_EXECUTIONSReturn the task executions keyed by task name for a workflow execution.

Input Parameters

boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string
required
Parent execution UUID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_TRASHED_DOCUMENTSReturn one page of documents owned by the connected user that currently reside in Dynatrace trash. Trashed documents are permanently deleted after 30 days.

Input Parameters

integer
One-based page number to access directly.
string
Optional Dynatrace filter over id, name, type, deletionInfo.deletedTime, or deletionInfo.deletedBy. Field names and equality comparisons are case-sensitive.
string
Continuation cursor returned as next_cursor by a previous call.
integer
Maximum number of trashed documents to return (1-1000; default 20).
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_TRASHED_WORKFLOWSReturn one page of workflows that have been moved to trash.

Input Parameters

integer
Number of workflows to return on this page.
string
Continuation cursor returned by a previous call; omit for the first page.
integer
Zero-based index of the first result.
string
Field used to order the results.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_WEBHOOK_HANDLERSReturn webhook handlers for an installed Dynatrace app context.

Input Parameters

string
required
ID of an installed Dynatrace app, sent as the required DT-APP-CONTEXT header.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_WORKFLOW_ACTIONSReturn action identifiers assigned to tasks in a workflow.

Input Parameters

string
required
UUID of the workflow whose assigned actions to return.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_WORKFLOW_HISTORY_RECORDSReturn the version history records for a Dynatrace workflow.

Input Parameters

string
required
UUID of the workflow whose history to return.
boolean
Whether to include the latest historical record; Dynatrace defaults to false.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_WORKFLOWSReturn one page of workflows matching optional filters.

Input Parameters

string
Filter by workflow ID.
string
Filter by workflow type.
integer
Number of workflows to return on this page.
string
Filter by owner identifier.
string
Continuation cursor returned by a previous call; omit for the first page.
integer
Zero-based index of the first result.
string
Search term for workflows.
string
Field used to order results.
string ("GROUP" | "USER")
Filter by owner type.
boolean
Filter by deployment state.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string
Filter by trigger type.
boolean
Filter by whether the throttle limit is hit.
array
Filter by one or more last-execution states.
boolean
Filter by faulty schedule state.
array
Filter by one or more last-modifying users.
string
Inclusive lower time bound for unacknowledged skipped schedules.
string
Inclusive upper time bound for unacknowledged skipped schedules.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_LIST_WORKFLOW_TASKSReturn the workflow’s task map keyed by task name, preserving each task definition.

Input Parameters

string
required
UUID of the workflow whose tasks to return.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_PARSE_GRAIL_QUERYParse a Dynatrace Grail DQL query into its recursive syntax tree without executing it. The connected OAuth client and user need at least one supported storage read permission, plus storage:<table>:read for every dataset referenced by the DQL query.

Input Parameters

object
required
The Grail query and optional parsing settings.
string
Optional non-sensitive client context used by Dynatrace to monitor query processing.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_PATCH_BUSINESS_CALENDARModify selected fields on a Dynatrace Automation business calendar.

Input Parameters

string
required
UUID identifying the business calendar.
object
required
Business calendar fields to modify.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_PATCH_SCHEDULING_RULEPartially update one scheduling rule.

Input Parameters

string
required
A UUID string identifying this rule.
object
required
Exact Dynatrace SDK partial rule update body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_PATCH_WORKFLOWPatch selected fields on an existing Dynatrace workflow.

Input Parameters

string
required
UUID of the workflow to patch.
object
required
Workflow fields to patch.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_PAUSE_EXECUTIONPause an active workflow execution.

Input Parameters

string
required
A UUID string identifying this execution.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_PERMANENTLY_DELETE_WORKFLOWPermanently delete an active workflow without moving it to trash.

Input Parameters

string
required
UUID of the workflow to permanently delete.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_POLL_GRAIL_QUERYReturn the current state and available result for an asynchronous Grail DQL request token. The connected OAuth client and user need at least one supported storage read permission, plus storage:<table>:read for every dataset referenced by the original query.

Input Parameters

string
Additional metadata to include in the result, such as metric-metadata.
string
required
Request token returned by an asynchronous Grail query. The connected OAuth client and user must retain storage:<table>:read for every dataset referenced by that query.
string
Optional non-sensitive client context used to monitor query execution.
integer
Maximum time in milliseconds to delay the response while waiting for a preview or final result.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_PREVIEW_FILTERPreview the DQL filter generated from a Dynatrace event trigger configuration. This provider endpoint is deprecated; Dynatrace does not name a replacement.

Input Parameters

object
required
Exact Dynatrace filter-preview request body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_PREVIEW_SCHEDULEValidate a schedule and return its next execution timestamps.

Input Parameters

object
required
Exact Dynatrace SDK schedule preview request body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_PREVIEW_SCHEDULING_RULEValidate a scheduling rule and return its upcoming execution times. This provider endpoint is deprecated; Dynatrace does not name a replacement.

Input Parameters

string
required
Scheduling rule preview definition.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_QUERY_METRIC_DATA_POINTSReturn metric data points; the connected environment must expose the Environment API v2 endpoint.

Input Parameters

string
End of the timeframe as a timestamp or relative expression.
string
Start of the timeframe as a timestamp or relative expression.
string
Data resolution, such as Inf, 1m, 1h, or auto.
string
Management zone selector used to limit the query.
string
Entity selector used to limit the query.
string
required
Metric selector to query.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_RELEASE_LOCKRelease the current user’s lock on a document.

Input Parameters

string
required
System-generated or user-given document ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_REMOVE_DIRECT_SHARE_RECIPIENTSRemove users or groups from an accessible Dynatrace direct share.

Input Parameters

string
required
System-generated ID of the direct share.
object
required
Recipient-removal payload from the official Dynatrace SDK.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_REORDER_SETTINGS_OBJECTSReorder objects in an ordered multi-object Dynatrace settings schema.

Input Parameters

object
required
Exact Dynatrace settings object reorder payload.
string
required
Current objects-list version required for optimistic locking.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_RESET_WORKFLOW_THROTTLESClear the current throttle state for a Dynatrace workflow.

Input Parameters

string
required
UUID of the workflow whose throttles to reset.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_RESOLVE_EFFECTIVE_PERMISSIONSResolve the connected user’s effective settings permissions.

Input Parameters

object
required
Permission resolution request from the official Dynatrace SDK.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_RESTORE_BUSINESS_CALENDAR_HISTORY_RECORDRestore a historical version of a Dynatrace Automation business calendar.

Input Parameters

string
required
UUID identifying the business calendar.
string
required
Business calendar history version to restore.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_RESTORE_SCHEDULING_RULE_HISTORY_RECORDRestore a Dynatrace scheduling rule to a historical version.

Input Parameters

string
required
UUID of the scheduling rule.
string
required
Historical rule version to restore.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_RESTORE_SNAPSHOTReset a document to a selected snapshot without changing ownership or sharing. Dynatrace first creates a safety snapshot when the current state has no snapshot; snapshot creation is limited to 5 per document within 60 seconds. If more than 50 snapshots exist, Dynatrace automatically deletes the oldest.

Input Parameters

string
required
System-generated or user-given document ID.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
integer
required
System-generated snapshot version to restore.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_RESTORE_TRASHED_DOCUMENTRestore a Dynatrace document owned by the connected user from trash. Users who had access before deletion regain access.

Input Parameters

string
required
System-generated or user-given ID of the trashed document to restore.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_RESTORE_TRASHED_WORKFLOWRestore a trashed workflow to the active workflow list. By default, the workflow is deployed and its triggers are reactivated; set isDeployed=false to restore it as draft-only.

Input Parameters

string
required
UUID of the trashed workflow to restore.
object
required
Restore options.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_RESTORE_WORKFLOW_HISTORY_RECORDRestore a workflow to a selected historical version and deploy that restored version.

Input Parameters

string
required
UUID of the workflow to restore.
string
required
Historical workflow version to restore.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_RESUME_EXECUTIONResume a paused workflow execution.

Input Parameters

string
required
A UUID string identifying this execution.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_RUN_WORKFLOWCreate an execution for a Dynatrace workflow, with optional idempotency qualifier and monitoring.

Input Parameters

string
required
UUID of the workflow to run.
object
required
Workflow execution inputs and metadata.
boolean
Whether SIMPLE workflow execution data remains available for monitoring until completion.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_SET_DOCUMENT_FAVORITESet whether an accessible Dynatrace document is a personal favorite for the connected user. Setting the document to its current state is a no-op.

Input Parameters

string
required
System-generated or user-given ID of the document to update.
boolean
required
Set to true to favorite the document or false to remove it from favorites.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_SET_DOCUMENT_VISIBILITYSet a Dynatrace document’s environment-wide visibility to public or private. The document owner or certain administrators can perform this operation; setting the document to its current visibility is a no-op.

Input Parameters

string
required
System-generated or user-given ID of the document to update.
string ("public" | "private")
required
Set the document to public or private visibility.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_SUMMARIZE_SETTINGS_VALUEGenerate display and search summaries for a Dynatrace multi-object settings value.

Input Parameters

object
required
Settings value and optional schema version to summarize.
string
required
ID of the multi-object settings schema.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_TRANSFER_DOCUMENT_OWNERTransfer a document to a new owner. Only the current owner can perform this operation, and the previous owner loses access after the transfer.

Input Parameters

string
required
System-generated or user-given document ID.
object
required
Ownership transfer request defined by the Dynatrace Document API.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
boolean
Whether to notify the new owner when the document type is supported by an installed app. Dynatrace defaults to true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_TRANSFER_SETTINGS_OBJECT_OWNERSHIPTransfer a Dynatrace settings object to a user, group, or all users. Only the owner or a main administrator can transfer ownership.

Input Parameters

object
required
Ownership transfer payload defined by the Dynatrace Settings API.
string
required
ID of the settings object whose ownership to transfer.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_TRASH_WORKFLOWMove a workflow to trash so it can be restored later.

Input Parameters

string
required
UUID of the workflow to move to trash.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_UPDATE_AUTHORIZATIONSRefresh Dynatrace Automation authorization assignments. This provider endpoint is deprecated; Dynatrace does not name a replacement.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_UPDATE_BUSINESS_CALENDARReplace fields on a Dynatrace Automation business calendar.

Input Parameters

string
required
UUID identifying the business calendar.
object
required
Replacement business calendar fields.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_UPDATE_DOCUMENTUpdate document metadata and/or binary content using optimistic locking, optionally creating a snapshot before the change.

Input Parameters

string
required
System-generated or user-given document ID.
object
required
Metadata and optional binary content to update.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
boolean
Whether to create a snapshot before applying the update.
string
required
Current document version required for optimistic locking.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_UPDATE_DOCUMENT_CONTENTCompletely replace a document’s binary content using optimistic locking.

Input Parameters

string
required
System-generated or user-given document ID.
object
required
Binary document content replacement.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string
required
Current document version required for optimistic locking.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_UPDATE_DOCUMENT_METADATACall Dynatrace’s deprecated, provider-specific metadata endpoint to update only a document’s name or type using optimistic locking. Prefer Update Document for ordinary document updates; this action is retained for full endpoint coverage.

Input Parameters

string
required
System-generated or user-given document ID.
object
required
Metadata fields to update; provide at least one field.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string
required
Current document version required for optimistic locking.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_UPDATE_PROBLEM_COMMENTReplace the content of one identified comment on an identified Dynatrace problem. This mutates the existing comment rather than adding a new one.

Input Parameters

object
required
Replacement comment text and optional context to persist.
string
required
ID of the existing comment whose content will be replaced.
string
required
ID of the problem containing the comment to change.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_UPDATE_SCHEDULING_RULEReplace the mutable fields of one scheduling rule.

Input Parameters

string
required
A UUID string identifying this rule.
object
required
Exact Dynatrace SDK rule update body.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_UPDATE_SETTINGS_OBJECTUpdate an existing Dynatrace settings object using optimistic locking.

Input Parameters

object
required
Exact Dynatrace settings object update payload.
string
required
ID of the settings object to update.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string
required
Current object version required for optimistic locking.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_UPDATE_SETTINGS_OBJECT_ACCESSOR_PERMISSIONSReplace a user, group, or all-users accessor’s permissions on a Dynatrace settings object.

Input Parameters

object
required
Replacement permissions defined by the Dynatrace Settings API.
string
required
ID of the settings object whose accessor permissions to update.
string
User or group UUID. Required for user and group; omit for all_users.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string ("user" | "group" | "all_users")
required
Type of accessor: user, group, or all_users.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_UPDATE_WORKFLOWReplace fields on an existing Dynatrace workflow.

Input Parameters

string
required
UUID of the workflow to update.
object
required
Workflow fields to replace.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_UPSERT_CUSTOM_DEVICECreate a custom device or update the device with the supplied customDeviceId.

Input Parameters

object
required
Custom-device identity, display name, and optional properties.
boolean
Treat the device as UI-created so it refreshes automatically and does not age out.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_UPSERT_SETTINGS_OBJECTCreate a settings object or update the object matching its external ID.

Input Parameters

object
required
Exact Dynatrace settings object creation payload.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_UPSERT_WEBHOOK_HANDLERCreate or replace a webhook handler using an installed Dynatrace app as its context.

Input Parameters

object
required
Webhook handler configuration.
string
required
Installed Dynatrace app ID used as the required application context.
string
required
ID of the connection this webhook handler belongs to.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_VALIDATE_SETTINGS_CONTAINERValidate a settings container with a Dynatrace schema custom validator.

Input Parameters

object
required
Container value and optional location information to validate.
string
Scope in which to validate the container.
string
required
ID of the settings schema.
string
required
Identifier of the schema’s custom container validator.
string
Schema version used for validation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_VALIDATE_SETTINGS_OBJECT_DELETEValidate deleting a settings object without applying the deletion.

Input Parameters

string
required
ID of the settings object whose deletion to validate.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string
required
Current object version required for optimistic locking.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_VALIDATE_SETTINGS_OBJECT_UPDATEValidate a settings object update without applying it.

Input Parameters

object
required
Exact settings object update payload to validate.
string
required
ID of the settings object whose update to validate.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.
string
required
Current object version required for optimistic locking.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_VALIDATE_SETTINGS_OBJECT_UPSERTValidate creating or updating a settings object without applying it.

Input Parameters

object
required
Exact settings object upsert payload to validate.
boolean
Use elevated administrator access; requires the corresponding admin OAuth permission when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_VALIDATE_SETTINGS_PROPERTYValidate one typed property value with a Dynatrace schema custom validator.

Input Parameters

object
required
Property path and one typed value to validate.
string
Scope in which to validate the property.
string
required
ID of the settings schema.
string
required
Identifier of the schema’s custom property validator.
string
Schema version used for validation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DYNATRACE_VERIFY_GRAIL_QUERYValidate a DQL query without executing it and return semantic notifications. Invalid DQL can be a successful HTTP response with valid set to false. This endpoint requires at least one supported storage read permission; the connected OAuth client and user also need storage:<table>:read for every dataset referenced by the DQL query.

Input Parameters

object
required
DQL query and verification options defined by the Dynatrace Grail API.
string
Optional non-sensitive client context used to monitor query processing.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not