---
canonical_url: "https://docs.composio.dev/toolkits/dynatrace"
markdown_url: "https://docs.composio.dev/toolkits/dynatrace.md"
product: "platform"
version: null
last_updated: null
---

# Dynatrace

Dynatrace provides observability, analytics, automation, settings, documents, and telemetry APIs for monitored environments.

- **Category:** analytics
- **Auth:** OAUTH2
- **Composio-managed OAuth available?** No
- **Tools:** 170
- **Triggers:** 0
- **Slug:** `DYNATRACE`
- **Version:** 00000000_00

## Tools

### Acquire Lock

**Slug:** `DYNATRACE_ACQUIRE_LOCK`

Acquire 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated or user-given document ID. |
| `body` | object | Yes | Document version and optional duration for the lock. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add Direct Share Recipients

**Slug:** `DYNATRACE_ADD_DIRECT_SHARE_RECIPIENTS`

Add users or groups to an accessible Dynatrace direct share.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated ID of the direct share. |
| `body` | object | Yes | Recipients payload from the official Dynatrace SDK. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `send_notification` | boolean | No | Whether Dynatrace should notify added recipients. The provider defaults to true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add Settings Object Accessor Permissions

**Slug:** `DYNATRACE_ADD_SETTINGS_OBJECT_ACCESSOR_PERMISSIONS`

Grant read or write permissions on a settings object to one accessor.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Accessor and permissions defined by the Dynatrace Settings API. |
| `object_id` | string | Yes | ID of the settings object on which to grant permissions. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Autocomplete Grail Query

**Slug:** `DYNATRACE_AUTOCOMPLETE_GRAIL_QUERY`

Return 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Grail autocomplete request parameters. |
| `dt_client_context` | string | No | Optional non-sensitive client context used by Dynatrace to monitor query execution. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Delete Document

**Slug:** `DYNATRACE_BULK_DELETE_DOCUMENT`

Move up to 100 documents to trash in one request and return the outcome for each document. Trashed documents are inaccessible until restored.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Bulk document deletion request defined by the Dynatrace Document API. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cancel Execution

**Slug:** `DYNATRACE_CANCEL_EXECUTION`

Request cancellation of an active workflow execution. Acceptance does not wait for the execution to reach CANCELLED.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the active execution to cancel. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cancel Grail Query

**Slug:** `DYNATRACE_CANCEL_GRAIL_QUERY`

Cancel 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `enrich` | string | No | Additional metadata enrichment to request, such as metric-metadata. |
| `request_token` | string | Yes | 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. |
| `dt_client_context` | string | No | Optional non-sensitive client context used to monitor query execution. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cancel Task Execution

**Slug:** `DYNATRACE_CANCEL_TASK_EXECUTION`

Request cancellation of an active task execution. Acceptance does not wait for the task or workflow to reach a terminal state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Task name to cancel. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `execution_id` | string | Yes | Parent execution UUID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Claim Environment Share

**Slug:** `DYNATRACE_CLAIM_ENVIRONMENT_SHARE`

Claim another user's environment share and gain its granted access to the shared document. This access cannot be relinquished by the claimer.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Environment-share ID to claim. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Close Problem

**Slug:** `DYNATRACE_CLOSE_PROBLEM`

Close 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Comment to persist as part of the irreversible problem closure. |
| `problem_id` | string | Yes | ID of the open problem to close irreversibly. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Business Calendar

**Slug:** `DYNATRACE_CREATE_BUSINESS_CALENDAR`

Create a Dynatrace Automation business calendar.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Business calendar to create. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Direct Share

**Slug:** `DYNATRACE_CREATE_DIRECT_SHARE`

Create a read or read-write direct share for a Dynatrace document.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Direct-share definition from the official Dynatrace SDK. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `send_notification` | boolean | No | Whether Dynatrace should notify recipients. The provider defaults to true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Document

**Slug:** `DYNATRACE_CREATE_DOCUMENT`

Create a Dynatrace document from metadata and up to 50 MB of binary content.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Metadata and binary content for the new document. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Environment Share

**Slug:** `DYNATRACE_CREATE_ENVIRONMENT_SHARE`

Create an environment-wide share link for a document owned by or reshareable by the connected user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Document and access level for the new environment share. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Problem Comment

**Slug:** `DYNATRACE_CREATE_PROBLEM_COMMENT`

Add a new visible comment to an existing Dynatrace problem. The operation mutates the problem's comment history.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | The visible comment content that Dynatrace will add to the problem. |
| `problem_id` | string | Yes | ID of the existing problem that will receive the new comment. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Scheduling Rule

**Slug:** `DYNATRACE_CREATE_SCHEDULING_RULE`

Create a Dynatrace scheduling rule from the official SDK rule contract.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Exact Dynatrace SDK rule creation body. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Workflow

**Slug:** `DYNATRACE_CREATE_WORKFLOW`

Create a Dynatrace workflow from its task and trigger definition.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Complete workflow definition. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Business Calendar

**Slug:** `DYNATRACE_DELETE_BUSINESS_CALENDAR`

Delete a Dynatrace Automation business calendar.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID identifying the business calendar. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Direct Share

**Slug:** `DYNATRACE_DELETE_DIRECT_SHARE`

Delete a direct share without deleting its Dynatrace document.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated ID of the direct share. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Document

**Slug:** `DYNATRACE_DELETE_DOCUMENT`

Move a document to the trash. The caller must own the document and provide its current optimistic-locking version.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated or user-given document ID. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `optimistic_locking_version` | string | Yes | Current document version required for optimistic locking. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Environment Share

**Slug:** `DYNATRACE_DELETE_ENVIRONMENT_SHARE`

Delete an environment share and revoke the document access granted through that share from all claimers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Environment-share ID to delete. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Metric

**Slug:** `DYNATRACE_DELETE_METRIC`

Irreversibly 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `metric_id` | string | Yes | Exact key of the Metrics v2-ingested metric to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Metrics

**Slug:** `DYNATRACE_DELETE_METRICS`

Irreversibly 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Problem Comment

**Slug:** `DYNATRACE_DELETE_PROBLEM_COMMENT`

Permanently delete one identified comment from an identified Dynatrace problem. This action cannot restore the deleted comment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `comment_id` | string | Yes | ID of the comment to permanently delete from the specified problem. |
| `problem_id` | string | Yes | ID of the problem containing the comment to permanently delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Scheduling Rule

**Slug:** `DYNATRACE_DELETE_SCHEDULING_RULE`

Permanently delete one scheduling rule by UUID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | A UUID string identifying this rule. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Settings Object

**Slug:** `DYNATRACE_DELETE_SETTINGS_OBJECT`

Delete a Dynatrace settings object using optimistic locking.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `object_id` | string | Yes | ID of the settings object to delete. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `optimistic_locking_version` | string | Yes | Current object version required for optimistic locking. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Settings Object Accessor Permissions

**Slug:** `DYNATRACE_DELETE_SETTINGS_OBJECT_ACCESSOR_PERMISSIONS`

Remove every permission a user, group, or all-users accessor has on a settings object.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `object_id` | string | Yes | ID of the settings object whose accessor permissions to remove. |
| `accessor_id` | string | No | User or group UUID. Required for user and group; omit for all_users. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `accessor_type` | string ("user" | "group" | "all_users") | Yes | Type of accessor: user, group, or all_users. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Snapshot

**Slug:** `DYNATRACE_DELETE_SNAPSHOT`

Irrevocably 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated or user-given document ID. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `snapshot_version` | integer | Yes | System-generated snapshot version to irrevocably delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Trashed Document

**Slug:** `DYNATRACE_DELETE_TRASHED_DOCUMENT`

Irreversibly destroy a trashed Dynatrace document owned by the connected user. This operation cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated or user-given ID of the trashed document to destroy. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Trashed Workflow

**Slug:** `DYNATRACE_DELETE_TRASHED_WORKFLOW`

Permanently delete a workflow that is already in trash.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the trashed workflow to permanently delete. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Webhook Handler

**Slug:** `DYNATRACE_DELETE_WEBHOOK_HANDLER`

Delete a webhook handler using an installed Dynatrace app as its context.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | string | Yes | Installed Dynatrace app ID used as the required application context. |
| `connection_id` | string | Yes | ID of the connection this webhook handler belongs to. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download Document Content

**Slug:** `DYNATRACE_DOWNLOAD_DOCUMENT_CONTENT`

Download the binary content of the latest document version or a specific snapshot, preserving the provider's filename and MIME type.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated or user-given document ID. |
| `filename` | string | No | Optional trimmed download filename and extension returned in Content-Disposition. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `snapshot_version` | integer | No | Snapshot version to download instead of the latest document content. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Duplicate Business Calendar

**Slug:** `DYNATRACE_DUPLICATE_BUSINESS_CALENDAR`

Create a copy of a Dynatrace Automation business calendar.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID identifying the business calendar to duplicate. |
| `body` | object | Yes | Options for the duplicated business calendar. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Duplicate Scheduling Rule

**Slug:** `DYNATRACE_DUPLICATE_SCHEDULING_RULE`

Duplicate a Dynatrace scheduling rule, optionally assigning a new title.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the scheduling rule to duplicate. |
| `body` | object | Yes | Options for the duplicated scheduling rule. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Duplicate Workflow

**Slug:** `DYNATRACE_DUPLICATE_WORKFLOW`

Create a new workflow by copying an existing Dynatrace workflow.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the workflow to duplicate. |
| `body` | object | Yes | Options for the new workflow copy. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Execute Grail Query

**Slug:** `DYNATRACE_EXECUTE_GRAIL_QUERY`

Start an asynchronous Grail DQL query and return either its result or a request token for polling. 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Exact request body defined by the official Dynatrace Grail SDK schema. |
| `enrich` | string | No | Additional metadata enrichment to request, such as metric-metadata. |
| `dt_client_context` | string | No | Optional non-sensitive client context used to monitor query execution. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Export Workflow

**Slug:** `DYNATRACE_EXPORT_WORKFLOW`

Export a workflow as the provider's JSON WorkflowExport definition.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the workflow to export. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Export Workflow History Record as JSON

**Slug:** `DYNATRACE_EXPORT_WORKFLOW_HISTORY_RECORD`

Export 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the workflow whose history to export. |
| `version` | string | Yes | Workflow history version to export. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Export Workflow Template

**Slug:** `DYNATRACE_EXPORT_WORKFLOW_TEMPLATE`

Export the current workflow, or a historical version when version is supplied, as the provider's reusable YAML template envelope.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the workflow to export as a template. |
| `version` | string | No | Workflow history version to export. Omit to export the workflow's current version. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Schema Default Value

**Slug:** `DYNATRACE_GENERATE_SCHEMA_DEFAULT_VALUE`

Generate the default settings value for a Dynatrace schema and optional scope.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `scope` | string | No | Scope used to generate the default value. |
| `schema_id` | string | Yes | ID of the settings schema. |
| `schema_version` | string | No | Schema version; the latest version is used when omitted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Action Execution

**Slug:** `DYNATRACE_GET_ACTION_EXECUTION`

Return one Dynatrace Automation action execution.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID identifying the action execution. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Action Execution Log

**Slug:** `DYNATRACE_GET_ACTION_EXECUTION_LOG`

Return the plain-text log for a Dynatrace Automation action execution.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID identifying the action execution. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Action Sample Result

**Slug:** `DYNATRACE_GET_ACTION_SAMPLE_RESULT`

Return the sample result for a Dynatrace Automation action. This provider endpoint is deprecated; Dynatrace does not name a replacement.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `action_identifier` | string | Yes | Dynatrace action identifier whose sample result to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Business Calendar

**Slug:** `DYNATRACE_GET_BUSINESS_CALENDAR`

Return one Dynatrace Automation business calendar.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID identifying the business calendar. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Business Calendar History Record

**Slug:** `DYNATRACE_GET_BUSINESS_CALENDAR_HISTORY_RECORD`

Return one historical version of a Dynatrace Automation business calendar.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID identifying the business calendar. |
| `version` | string | Yes | Business calendar history version. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Direct Share

**Slug:** `DYNATRACE_GET_DIRECT_SHARE`

Return an accessible Dynatrace direct share by its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated ID of the direct share. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Document

**Slug:** `DYNATRACE_GET_DOCUMENT`

Retrieve a document's metadata and binary content, optionally from a snapshot.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated or user-given document ID. |
| `filename` | string | No | Optional filename and extension returned for the downloaded content. |
| `add_fields` | string | No | Comma-separated optional metadata fields to include. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `snapshot_version` | integer | No | Snapshot version to retrieve instead of the current document. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Document Metadata

**Slug:** `DYNATRACE_GET_DOCUMENT_METADATA`

Return metadata for the latest version or a specific snapshot of a document.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated or user-given document ID. |
| `add_fields` | string | No | Comma-separated additional fields: userContext.lastAccessedTime, userContext.isFavorite, or modificationInfo.lastModifyingAppId. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `snapshot_version` | integer | No | Snapshot version whose metadata should be returned instead of the latest version. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Entity

**Slug:** `DYNATRACE_GET_ENTITY`

Return one monitored entity by its Dynatrace entity identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | string | No | End of the requested timeframe as a timestamp or relative expression. |
| `from_` | string | No | Start of the requested timeframe as a timestamp or relative expression. |
| `fields` | string | No | Comma-separated additional entity properties to include. |
| `entity_id` | string | Yes | Dynatrace entity identifier, including its type prefix. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Entity Type

**Slug:** `DYNATRACE_GET_ENTITY_TYPE`

Return the schema and relationship metadata for one Dynatrace entity type.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string | Yes | Entity type identifier, for example HOST. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Environment Share

**Slug:** `DYNATRACE_GET_ENVIRONMENT_SHARE`

Retrieve an accessible Dynatrace environment share by its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Environment-share ID to retrieve. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Event

**Slug:** `DYNATRACE_GET_EVENT`

Return one Dynatrace event by its event ID; the connected environment must expose the Events v2 REST endpoint.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_id` | string | Yes | ID of the Dynatrace event to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Event Property

**Slug:** `DYNATRACE_GET_EVENT_PROPERTY`

Return details of one event property supported by the Dynatrace environment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `property_key` | string | Yes | Event property key to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Event Type

**Slug:** `DYNATRACE_GET_EVENT_TYPE`

Return details of one event type supported by the Dynatrace environment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_type` | string | Yes | Event type identifier to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Execution

**Slug:** `DYNATRACE_GET_EXECUTION`

Return a workflow execution and its current asynchronous state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Execution UUID. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Execution Log

**Slug:** `DYNATRACE_GET_EXECUTION_LOG`

Return the plain-text log for one workflow execution.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | A UUID string identifying this execution. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Holiday Calendar

**Slug:** `DYNATRACE_GET_HOLIDAY_CALENDAR`

Return a country's holidays, optionally bounded by an inclusive date range.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | string | No | Optional last date of the holiday range in YYYY-MM-DD format. |
| `key` | string | Yes | The country name. |
| `from_` | string | No | Optional first date of the holiday range in YYYY-MM-DD format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Metric Descriptor

**Slug:** `DYNATRACE_GET_METRIC_DESCRIPTOR`

Return the descriptor of one metric by its metric key.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `metric_id` | string | Yes | Metric key, optionally followed by colon-separated metric selector transformations. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Problem

**Slug:** `DYNATRACE_GET_PROBLEM`

Return details of one Dynatrace problem by its problem ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fields` | string | No | Comma-separated additional properties: evidenceDetails, impactAnalysis, recentComments. |
| `problem_id` | string | Yes | ID of the Dynatrace problem to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Problem Comment

**Slug:** `DYNATRACE_GET_PROBLEM_COMMENT`

Return one identified comment from a Dynatrace problem.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `comment_id` | string | Yes | ID of the comment to retrieve. |
| `problem_id` | string | Yes | ID of the problem containing the comment. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Scheduling Rule

**Slug:** `DYNATRACE_GET_SCHEDULING_RULE`

Return one scheduling rule by UUID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | A UUID string identifying this rule. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Scheduling Rule History Record

**Slug:** `DYNATRACE_GET_SCHEDULING_RULE_HISTORY_RECORD`

Return one historical version of a Dynatrace scheduling rule.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the scheduling rule. |
| `version` | string | Yes | Historical rule version to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Schema Definition

**Slug:** `DYNATRACE_GET_SCHEMA_DEFINITION`

Retrieve the complete definition of a Dynatrace settings schema.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `schema_id` | string | Yes | ID of the settings schema. |
| `schema_version` | string | No | Schema version to retrieve; omit it to retrieve the latest version. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Settings

**Slug:** `DYNATRACE_GET_SETTINGS`

Return Dynatrace Automation system settings and execution limits. This provider endpoint is deprecated; Dynatrace does not name a replacement.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Settings Object

**Slug:** `DYNATRACE_GET_SETTINGS_OBJECT`

Return a Dynatrace settings object by ID; secret properties remain irreversibly masked outside trusted app functions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `object_id` | string | Yes | ID of the settings object. |
| `add_fields` | string | No | Comma-separated additional top-level fields to include. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Settings Object Accessor Permissions

**Slug:** `DYNATRACE_GET_SETTINGS_OBJECT_ACCESSOR_PERMISSIONS`

Return a user, group, or all-users accessor's permissions on one Dynatrace settings object.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `object_id` | string | Yes | ID of the settings object whose accessor permissions to return. |
| `accessor_id` | string | No | User or group UUID. Required for user and group; omit for all_users. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `accessor_type` | string ("user" | "group" | "all_users") | Yes | Type of accessor: user, group, or all_users. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Settings Object Permissions

**Slug:** `DYNATRACE_GET_SETTINGS_OBJECT_PERMISSIONS`

Return every accessor and permission configured on a settings object.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `object_id` | string | Yes | ID of the settings object whose permissions to return. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Snapshot Metadata

**Slug:** `DYNATRACE_GET_SNAPSHOT_METADATA`

Return 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated or user-given document ID. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `snapshot_version` | integer | Yes | System-generated snapshot version. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Task Execution

**Slug:** `DYNATRACE_GET_TASK_EXECUTION`

Return one task execution, including its asynchronous state and result.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Task name. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `execution_id` | string | Yes | Parent execution UUID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Task Execution Input

**Slug:** `DYNATRACE_GET_TASK_EXECUTION_INPUT`

Return the merged JSON inputs from all action executions belonging to a task execution.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Task name. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `execution_id` | string | Yes | Parent execution UUID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Task Execution Log

**Slug:** `DYNATRACE_GET_TASK_EXECUTION_LOG`

Return the raw standard-output log for a task execution; the log can be large.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Task name. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `execution_id` | string | Yes | Parent execution UUID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Task Execution Result

**Slug:** `DYNATRACE_GET_TASK_EXECUTION_RESULT`

Return the merged JSON results from all action executions belonging to a task execution.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Task name. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `execution_id` | string | Yes | Parent execution UUID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Transitions

**Slug:** `DYNATRACE_GET_TRANSITIONS`

Return workflow task transitions keyed by transition name for an execution.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `execution_id` | string | Yes | Workflow execution UUID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Permissions

**Slug:** `DYNATRACE_GET_USER_PERMISSIONS`

Return the connected user's effective Dynatrace Automation permissions. This provider endpoint is deprecated; Dynatrace does not name a replacement.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Settings

**Slug:** `DYNATRACE_GET_USER_SETTINGS`

Return Dynatrace Automation settings for the connected user. This provider endpoint is deprecated; Dynatrace does not name a replacement.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Version

**Slug:** `DYNATRACE_GET_VERSION`

Diagnostic endpoint that returns the Dynatrace Automation service version; it does not inspect or change user resources.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Webhook Handler

**Slug:** `DYNATRACE_GET_WEBHOOK_HANDLER`

Return one webhook handler for an installed Dynatrace app context.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | string | Yes | ID of an installed Dynatrace app, sent as the required DT-APP-CONTEXT header. |
| `connection_id` | string | Yes | Connection ID whose webhook handler to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Workflow

**Slug:** `DYNATRACE_GET_WORKFLOW`

Return a workflow by UUID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the workflow to return. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Inspect Workflow History Record

**Slug:** `DYNATRACE_GET_WORKFLOW_HISTORY_RECORD`

Retrieve 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the workflow whose history to inspect. |
| `version` | string | Yes | Workflow history version to return. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Workflow Task

**Slug:** `DYNATRACE_GET_WORKFLOW_TASK`

Return one task definition from a Dynatrace workflow.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Task name or ID within the workflow. |
| `workflow_id` | string | Yes | UUID of the workflow containing the task. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Ingest Event

**Slug:** `DYNATRACE_INGEST_EVENT`

Ingest one event into the connected Dynatrace environment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Event type, title, timing, target, and optional properties. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Ingest Metric Data Points

**Slug:** `DYNATRACE_INGEST_METRIC_DATA_POINTS`

Ingest 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `metric_lines` | string | Yes | Dynatrace metric line-protocol records separated by newlines; sent as raw text/plain bytes. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Inspect Lock

**Slug:** `DYNATRACE_INSPECT_LOCK`

Inspect a document lock, including its owner and document version.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated or user-given document ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Inspect Trashed Document

**Slug:** `DYNATRACE_INSPECT_TRASHED_DOCUMENT`

Return metadata and deletion audit information for a trashed Dynatrace document owned by the connected user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated or user-given ID of the trashed document to inspect. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List All Event Logs

**Slug:** `DYNATRACE_LIST_ALL_EVENT_LOGS`

Return all structured event log entries for a workflow execution.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Execution UUID. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Automation Service Users

**Slug:** `DYNATRACE_LIST_AUTOMATION_SERVICE_USERS`

Return service users available as Dynatrace workflow actors. This provider endpoint is deprecated; Dynatrace does not name a replacement.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Business Calendar History Records

**Slug:** `DYNATRACE_LIST_BUSINESS_CALENDAR_HISTORY_RECORDS`

Return the change history for a Dynatrace Automation business calendar.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID identifying the business calendar. |
| `all` | boolean | No | Whether to include the latest historical record; defaults to false. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Business Calendars

**Slug:** `DYNATRACE_LIST_BUSINESS_CALENDARS`

Return one page of Dynatrace Automation business calendars.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of results to return per page. |
| `offset` | string | No | Initial result index, or next_cursor returned by the preceding page. |
| `search` | string | No | Term used to search business calendars. |
| `ordering` | string | No | Field used to order results. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Direct Share Recipients

**Slug:** `DYNATRACE_LIST_DIRECT_SHARE_RECIPIENTS`

Return one page of users and groups assigned to a direct share.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated ID of the direct share. |
| `page` | integer | No | One-based page number to retrieve directly. |
| `page_key` | string | No | Continuation key returned as next_cursor by the preceding page. |
| `page_size` | integer | No | Maximum number of recipients to return; Dynatrace defaults to 20. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Direct Shares

**Slug:** `DYNATRACE_LIST_DIRECT_SHARES`

Return one page of direct shares accessible to the connected user.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Documents

**Slug:** `DYNATRACE_LIST_DOCUMENTS`

Return one page of documents accessible to the connected user.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Effective Settings Values

**Slug:** `DYNATRACE_LIST_EFFECTIVE_SETTINGS_VALUES`

Return one page of effective values, including schema defaults.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Entities

**Slug:** `DYNATRACE_LIST_ENTITIES`

Return one page of monitored entities matching an entity selector.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Entity Types

**Slug:** `DYNATRACE_LIST_ENTITY_TYPES`

Return one page of entity types from the connected Dynatrace environment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Maximum entity types to return on the first page. |
| `next_page_key` | string | No | Cursor returned as next_cursor by the preceding page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Environment Share Claimers

**Slug:** `DYNATRACE_LIST_ENVIRONMENT_SHARE_CLAIMERS`

Return one page of users who claimed an accessible environment share.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Environment-share ID whose claimers to list. |
| `page` | integer | No | One-based page number to retrieve directly. |
| `page_key` | string | No | 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. |
| `page_size` | integer | No | Maximum number of claimers to return. Dynatrace defaults to 20. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Environment Shares

**Slug:** `DYNATRACE_LIST_ENVIRONMENT_SHARES`

Return one page of environment shares accessible to the connected user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | One-based page number to retrieve directly. |
| `filter` | string | No | Filter environment shares by documentId using the Dynatrace Platform filter syntax and equality operator. |
| `page_key` | string | No | 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. |
| `page_size` | integer | No | Maximum number of environment shares to return. Dynatrace defaults to 20. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Event Properties

**Slug:** `DYNATRACE_LIST_EVENT_PROPERTIES`

Return one page of event properties supported by the Dynatrace environment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Maximum event properties to return on the first page. |
| `next_page_key` | string | No | Cursor returned as next_cursor by the preceding page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Events

**Slug:** `DYNATRACE_LIST_EVENTS`

Return one page of events; the connected environment must expose the Environment API v2 endpoint.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | string | No | End of the first-page timeframe as a timestamp or relative expression. |
| `from_` | string | No | Start of the first-page timeframe as a timestamp or relative expression. |
| `page_size` | integer | No | Maximum events to return on the first page. |
| `next_page_key` | string | No | Cursor returned as next_cursor by the preceding page. |
| `event_selector` | string | No | Event selector used to filter the first page. |
| `entity_selector` | string | No | Entity selector used to filter the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Event Types

**Slug:** `DYNATRACE_LIST_EVENT_TYPES`

Return one page of event types supported by the Dynatrace environment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Maximum event types to return on the first page. |
| `next_page_key` | string | No | Cursor returned as next_cursor by the preceding page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Execution Actions

**Slug:** `DYNATRACE_LIST_EXECUTION_ACTIONS`

Return action identifiers assigned to tasks in a workflow execution.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Execution UUID. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Executions

**Slug:** `DYNATRACE_LIST_EXECUTIONS`

Return one filtered page of workflow executions and the offset for the next page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user` | array | No | Users to match. |
| `limit` | integer | No | Maximum results to return. |
| `state` | array | No | Execution states to match. |
| `offset` | integer | No | Zero-based result offset. |
| `search` | string | No | Search term. |
| `trigger` | string | No | Trigger ID to match. |
| `ordering` | string | No | Field used to order results. |
| `schedule` | array | No | Schedule IDs to match. |
| `workflow` | array | No | Workflow IDs to match. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `trigger_type` | string | No | Trigger type to match. |
| `started_at_gte` | string | No | Inclusive lower bound for the start timestamp. |
| `started_at_lte` | string | No | Inclusive upper bound for the start timestamp. |
| `parent_workflow` | string | No | Parent workflow ID to match. |
| `parent_execution` | string | No | Parent execution ID to match. |
| `subworkflow_of_task` | string | No | Parent execution and task pair to match. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Holiday Calendar Countries

**Slug:** `DYNATRACE_LIST_HOLIDAY_CALENDAR_COUNTRIES`

Return countries that can be used to retrieve a holiday calendar.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Labels

**Slug:** `DYNATRACE_LIST_LABELS`

Return one alphabetically sorted page of labels accessible to the connected user, optionally filtered by substring and document type.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Metric Descriptors

**Slug:** `DYNATRACE_LIST_METRIC_DESCRIPTORS`

Return one page of metric descriptors; the connected environment must expose the Environment API v2 endpoint.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Problem Comments

**Slug:** `DYNATRACE_LIST_PROBLEM_COMMENTS`

Return one page of comments attached to a Dynatrace problem.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Maximum comments to return on the first page; Dynatrace defaults to 10. |
| `problem_id` | string | Yes | ID of the problem whose comments to list. |
| `next_page_key` | string | No | Cursor returned as next_cursor by the preceding page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Problems

**Slug:** `DYNATRACE_LIST_PROBLEMS`

Return one filtered page of Dynatrace problems and a continuation cursor.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | string | No | End of the first-page timeframe as an absolute timestamp or relative expression. |
| `sort` | string | No | Comma-separated sort fields with optional + or - order prefixes. |
| `from_` | string | No | Start of the first-page timeframe as an absolute timestamp or relative expression. |
| `fields` | string | No | Comma-separated optional problem properties to include on this page. |
| `page_size` | integer | No | Maximum problems to return on the first page. |
| `next_page_key` | string | No | Cursor returned as next_cursor by the preceding page. |
| `entity_selector` | string | No | Dynatrace entity selector for the first page. |
| `problem_selector` | string | No | Dynatrace problem selector for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Schedule Timezones

**Slug:** `DYNATRACE_LIST_SCHEDULE_TIMEZONES`

Return timezone names accepted by Dynatrace schedules.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Scheduling Rule History Records

**Slug:** `DYNATRACE_LIST_SCHEDULING_RULE_HISTORY_RECORDS`

Return the version history records for a Dynatrace scheduling rule.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the scheduling rule. |
| `all` | boolean | No | Include the latest historical record. Dynatrace defaults to false. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Scheduling Rules

**Slug:** `DYNATRACE_LIST_SCHEDULING_RULES`

Return one page of scheduling rules matching optional search and ordering criteria.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Results per page. |
| `offset` | integer | No | Initial result index. |
| `search` | string | No | Rule search term. |
| `ordering` | string | No | Field used to order results. |
| `next_cursor` | string | No | Cursor returned by the preceding page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Schema Definitions

**Slug:** `DYNATRACE_LIST_SCHEMA_DEFINITIONS`

List all settings schemas available to the connected Dynatrace user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `add_fields` | string | No | Comma-separated additional top-level fields: schemaId, displayName, latestSchemaVersion, maturity, multiObject, ordered, ownerBasedAccessControl, or schemaVersions. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Settings History

**Slug:** `DYNATRACE_LIST_SETTINGS_HISTORY`

Return one page of revision history for Dynatrace settings objects.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Settings Objects

**Slug:** `DYNATRACE_LIST_SETTINGS_OBJECTS`

Return one page of persisted settings objects for one schema and scope.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Snapshots

**Slug:** `DYNATRACE_LIST_SNAPSHOTS`

Return 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Task Executions

**Slug:** `DYNATRACE_LIST_TASK_EXECUTIONS`

Return the task executions keyed by task name for a workflow execution.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `execution_id` | string | Yes | Parent execution UUID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Trashed Documents

**Slug:** `DYNATRACE_LIST_TRASHED_DOCUMENTS`

Return 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Trashed Workflows

**Slug:** `DYNATRACE_LIST_TRASHED_WORKFLOWS`

Return one page of workflows that have been moved to trash.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Webhook Handlers

**Slug:** `DYNATRACE_LIST_WEBHOOK_HANDLERS`

Return webhook handlers for an installed Dynatrace app context.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | string | Yes | ID of an installed Dynatrace app, sent as the required DT-APP-CONTEXT header. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Workflow Actions

**Slug:** `DYNATRACE_LIST_WORKFLOW_ACTIONS`

Return action identifiers assigned to tasks in a workflow.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the workflow whose assigned actions to return. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Workflow History Records

**Slug:** `DYNATRACE_LIST_WORKFLOW_HISTORY_RECORDS`

Return the version history records for a Dynatrace workflow.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the workflow whose history to return. |
| `all` | boolean | No | Whether to include the latest historical record; Dynatrace defaults to false. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Workflows

**Slug:** `DYNATRACE_LIST_WORKFLOWS`

Return one page of workflows matching optional filters.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Workflow Tasks

**Slug:** `DYNATRACE_LIST_WORKFLOW_TASKS`

Return the workflow's task map keyed by task name, preserving each task definition.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the workflow whose tasks to return. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Parse Grail Query

**Slug:** `DYNATRACE_PARSE_GRAIL_QUERY`

Parse 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | The Grail query and optional parsing settings. |
| `dt_client_context` | string | No | Optional non-sensitive client context used by Dynatrace to monitor query processing. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Patch Business Calendar

**Slug:** `DYNATRACE_PATCH_BUSINESS_CALENDAR`

Modify selected fields on a Dynatrace Automation business calendar.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID identifying the business calendar. |
| `body` | object | Yes | Business calendar fields to modify. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Patch Scheduling Rule

**Slug:** `DYNATRACE_PATCH_SCHEDULING_RULE`

Partially update one scheduling rule.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | A UUID string identifying this rule. |
| `body` | object | Yes | Exact Dynatrace SDK partial rule update body. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Patch Workflow

**Slug:** `DYNATRACE_PATCH_WORKFLOW`

Patch selected fields on an existing Dynatrace workflow.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the workflow to patch. |
| `body` | object | Yes | Workflow fields to patch. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Pause Execution

**Slug:** `DYNATRACE_PAUSE_EXECUTION`

Pause an active workflow execution.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | A UUID string identifying this execution. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Permanently Delete Workflow

**Slug:** `DYNATRACE_PERMANENTLY_DELETE_WORKFLOW`

Permanently delete an active workflow without moving it to trash.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the workflow to permanently delete. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Poll Grail Query

**Slug:** `DYNATRACE_POLL_GRAIL_QUERY`

Return 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `enrich` | string | No | Additional metadata to include in the result, such as metric-metadata. |
| `request_token` | string | Yes | 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. |
| `dt_client_context` | string | No | Optional non-sensitive client context used to monitor query execution. |
| `request_timeout_milliseconds` | integer | No | Maximum time in milliseconds to delay the response while waiting for a preview or final result. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Filter

**Slug:** `DYNATRACE_PREVIEW_FILTER`

Preview the DQL filter generated from a Dynatrace event trigger configuration. This provider endpoint is deprecated; Dynatrace does not name a replacement.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Exact Dynatrace filter-preview request body. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Schedule

**Slug:** `DYNATRACE_PREVIEW_SCHEDULE`

Validate a schedule and return its next execution timestamps.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Exact Dynatrace SDK schedule preview request body. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Scheduling Rule

**Slug:** `DYNATRACE_PREVIEW_SCHEDULING_RULE`

Validate a scheduling rule and return its upcoming execution times. This provider endpoint is deprecated; Dynatrace does not name a replacement.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | string | Yes | Scheduling rule preview definition. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Metric Data Points

**Slug:** `DYNATRACE_QUERY_METRIC_DATA_POINTS`

Return metric data points; the connected environment must expose the Environment API v2 endpoint.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | string | No | End of the timeframe as a timestamp or relative expression. |
| `from_` | string | No | Start of the timeframe as a timestamp or relative expression. |
| `resolution` | string | No | Data resolution, such as Inf, 1m, 1h, or auto. |
| `mz_selector` | string | No | Management zone selector used to limit the query. |
| `entity_selector` | string | No | Entity selector used to limit the query. |
| `metric_selector` | string | Yes | Metric selector to query. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Release Lock

**Slug:** `DYNATRACE_RELEASE_LOCK`

Release the current user's lock on a document.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated or user-given document ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove Direct Share Recipients

**Slug:** `DYNATRACE_REMOVE_DIRECT_SHARE_RECIPIENTS`

Remove users or groups from an accessible Dynatrace direct share.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated ID of the direct share. |
| `body` | object | Yes | Recipient-removal payload from the official Dynatrace SDK. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Reorder Settings Objects

**Slug:** `DYNATRACE_REORDER_SETTINGS_OBJECTS`

Reorder objects in an ordered multi-object Dynatrace settings schema.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Exact Dynatrace settings object reorder payload. |
| `optimistic_locking_version` | string | Yes | Current objects-list version required for optimistic locking. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Reset Workflow Throttles

**Slug:** `DYNATRACE_RESET_WORKFLOW_THROTTLES`

Clear the current throttle state for a Dynatrace workflow.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the workflow whose throttles to reset. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Resolve Effective Permissions

**Slug:** `DYNATRACE_RESOLVE_EFFECTIVE_PERMISSIONS`

Resolve the connected user's effective settings permissions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Permission resolution request from the official Dynatrace SDK. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Restore Business Calendar History Record

**Slug:** `DYNATRACE_RESTORE_BUSINESS_CALENDAR_HISTORY_RECORD`

Restore a historical version of a Dynatrace Automation business calendar.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID identifying the business calendar. |
| `version` | string | Yes | Business calendar history version to restore. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Restore Scheduling Rule History Record

**Slug:** `DYNATRACE_RESTORE_SCHEDULING_RULE_HISTORY_RECORD`

Restore a Dynatrace scheduling rule to a historical version.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the scheduling rule. |
| `version` | string | Yes | Historical rule version to restore. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Restore Snapshot

**Slug:** `DYNATRACE_RESTORE_SNAPSHOT`

Reset 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated or user-given document ID. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `snapshot_version` | integer | Yes | System-generated snapshot version to restore. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Restore Trashed Document

**Slug:** `DYNATRACE_RESTORE_TRASHED_DOCUMENT`

Restore a Dynatrace document owned by the connected user from trash. Users who had access before deletion regain access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated or user-given ID of the trashed document to restore. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Restore Trashed Workflow

**Slug:** `DYNATRACE_RESTORE_TRASHED_WORKFLOW`

Restore 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the trashed workflow to restore. |
| `body` | object | Yes | Restore options. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Restore Workflow History Record

**Slug:** `DYNATRACE_RESTORE_WORKFLOW_HISTORY_RECORD`

Restore a workflow to a selected historical version and deploy that restored version.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the workflow to restore. |
| `version` | string | Yes | Historical workflow version to restore. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Resume Execution

**Slug:** `DYNATRACE_RESUME_EXECUTION`

Resume a paused workflow execution.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | A UUID string identifying this execution. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Run Workflow

**Slug:** `DYNATRACE_RUN_WORKFLOW`

Create an execution for a Dynatrace workflow, with optional idempotency qualifier and monitoring.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the workflow to run. |
| `body` | object | Yes | Workflow execution inputs and metadata. |
| `monitor` | boolean | No | Whether SIMPLE workflow execution data remains available for monitoring until completion. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Document Favorite

**Slug:** `DYNATRACE_SET_DOCUMENT_FAVORITE`

Set 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated or user-given ID of the document to update. |
| `favorite` | boolean | Yes | Set to true to favorite the document or false to remove it from favorites. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Document Visibility

**Slug:** `DYNATRACE_SET_DOCUMENT_VISIBILITY`

Set 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated or user-given ID of the document to update. |
| `visibility` | string ("public" | "private") | Yes | Set the document to public or private visibility. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Summarize Settings Value

**Slug:** `DYNATRACE_SUMMARIZE_SETTINGS_VALUE`

Generate display and search summaries for a Dynatrace multi-object settings value.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Settings value and optional schema version to summarize. |
| `schema_id` | string | Yes | ID of the multi-object settings schema. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Transfer Document Owner

**Slug:** `DYNATRACE_TRANSFER_DOCUMENT_OWNER`

Transfer 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated or user-given document ID. |
| `body` | object | Yes | Ownership transfer request defined by the Dynatrace Document API. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `send_notification` | boolean | No | Whether to notify the new owner when the document type is supported by an installed app. Dynatrace defaults to true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Transfer Settings Object Ownership

**Slug:** `DYNATRACE_TRANSFER_SETTINGS_OBJECT_OWNERSHIP`

Transfer a Dynatrace settings object to a user, group, or all users. Only the owner or a main administrator can transfer ownership.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Ownership transfer payload defined by the Dynatrace Settings API. |
| `object_id` | string | Yes | ID of the settings object whose ownership to transfer. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Trash Workflow

**Slug:** `DYNATRACE_TRASH_WORKFLOW`

Move a workflow to trash so it can be restored later.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the workflow to move to trash. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Authorizations

**Slug:** `DYNATRACE_UPDATE_AUTHORIZATIONS`

Refresh Dynatrace Automation authorization assignments. This provider endpoint is deprecated; Dynatrace does not name a replacement.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Business Calendar

**Slug:** `DYNATRACE_UPDATE_BUSINESS_CALENDAR`

Replace fields on a Dynatrace Automation business calendar.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID identifying the business calendar. |
| `body` | object | Yes | Replacement business calendar fields. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Document

**Slug:** `DYNATRACE_UPDATE_DOCUMENT`

Update document metadata and/or binary content using optimistic locking, optionally creating a snapshot before the change.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated or user-given document ID. |
| `body` | object | Yes | Metadata and optional binary content to update. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `create_snapshot` | boolean | No | Whether to create a snapshot before applying the update. |
| `optimistic_locking_version` | string | Yes | Current document version required for optimistic locking. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Document Content

**Slug:** `DYNATRACE_UPDATE_DOCUMENT_CONTENT`

Completely replace a document's binary content using optimistic locking.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated or user-given document ID. |
| `body` | object | Yes | Binary document content replacement. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `optimistic_locking_version` | string | Yes | Current document version required for optimistic locking. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Document Metadata

**Slug:** `DYNATRACE_UPDATE_DOCUMENT_METADATA`

Call 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | System-generated or user-given document ID. |
| `body` | object | Yes | Metadata fields to update; provide at least one field. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `optimistic_locking_version` | string | Yes | Current document version required for optimistic locking. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Problem Comment

**Slug:** `DYNATRACE_UPDATE_PROBLEM_COMMENT`

Replace the content of one identified comment on an identified Dynatrace problem. This mutates the existing comment rather than adding a new one.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Replacement comment text and optional context to persist. |
| `comment_id` | string | Yes | ID of the existing comment whose content will be replaced. |
| `problem_id` | string | Yes | ID of the problem containing the comment to change. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Scheduling Rule

**Slug:** `DYNATRACE_UPDATE_SCHEDULING_RULE`

Replace the mutable fields of one scheduling rule.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | A UUID string identifying this rule. |
| `body` | object | Yes | Exact Dynatrace SDK rule update body. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Settings Object

**Slug:** `DYNATRACE_UPDATE_SETTINGS_OBJECT`

Update an existing Dynatrace settings object using optimistic locking.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Exact Dynatrace settings object update payload. |
| `object_id` | string | Yes | ID of the settings object to update. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `optimistic_locking_version` | string | Yes | Current object version required for optimistic locking. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Settings Object Accessor Permissions

**Slug:** `DYNATRACE_UPDATE_SETTINGS_OBJECT_ACCESSOR_PERMISSIONS`

Replace a user, group, or all-users accessor's permissions on a Dynatrace settings object.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Workflow

**Slug:** `DYNATRACE_UPDATE_WORKFLOW`

Replace fields on an existing Dynatrace workflow.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the workflow to update. |
| `body` | object | Yes | Workflow fields to replace. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upsert Custom Device

**Slug:** `DYNATRACE_UPSERT_CUSTOM_DEVICE`

Create a custom device or update the device with the supplied customDeviceId.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Custom-device identity, display name, and optional properties. |
| `ui_based` | boolean | No | Treat the device as UI-created so it refreshes automatically and does not age out. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upsert Settings Object

**Slug:** `DYNATRACE_UPSERT_SETTINGS_OBJECT`

Create a settings object or update the object matching its external ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Exact Dynatrace settings object creation payload. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upsert Webhook Handler

**Slug:** `DYNATRACE_UPSERT_WEBHOOK_HANDLER`

Create or replace a webhook handler using an installed Dynatrace app as its context.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Webhook handler configuration. |
| `app_id` | string | Yes | Installed Dynatrace app ID used as the required application context. |
| `connection_id` | string | Yes | ID of the connection this webhook handler belongs to. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Validate Settings Container

**Slug:** `DYNATRACE_VALIDATE_SETTINGS_CONTAINER`

Validate a settings container with a Dynatrace schema custom validator.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Container value and optional location information to validate. |
| `scope` | string | No | Scope in which to validate the container. |
| `schema_id` | string | Yes | ID of the settings schema. |
| `validator_id` | string | Yes | Identifier of the schema's custom container validator. |
| `schema_version` | string | No | Schema version used for validation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Validate Settings Object Delete

**Slug:** `DYNATRACE_VALIDATE_SETTINGS_OBJECT_DELETE`

Validate deleting a settings object without applying the deletion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `object_id` | string | Yes | ID of the settings object whose deletion to validate. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `optimistic_locking_version` | string | Yes | Current object version required for optimistic locking. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Validate Settings Object Update

**Slug:** `DYNATRACE_VALIDATE_SETTINGS_OBJECT_UPDATE`

Validate a settings object update without applying it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Exact settings object update payload to validate. |
| `object_id` | string | Yes | ID of the settings object whose update to validate. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |
| `optimistic_locking_version` | string | Yes | Current object version required for optimistic locking. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Validate Settings Object Upsert

**Slug:** `DYNATRACE_VALIDATE_SETTINGS_OBJECT_UPSERT`

Validate creating or updating a settings object without applying it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Exact settings object upsert payload to validate. |
| `admin_access` | boolean | No | Use elevated administrator access; requires the corresponding admin OAuth permission when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Validate Settings Property

**Slug:** `DYNATRACE_VALIDATE_SETTINGS_PROPERTY`

Validate one typed property value with a Dynatrace schema custom validator.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Property path and one typed value to validate. |
| `scope` | string | No | Scope in which to validate the property. |
| `schema_id` | string | Yes | ID of the settings schema. |
| `validator_id` | string | Yes | Identifier of the schema's custom property validator. |
| `schema_version` | string | No | Schema version used for validation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Verify Grail Query

**Slug:** `DYNATRACE_VERIFY_GRAIL_QUERY`

Validate 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | DQL query and verification options defined by the Dynatrace Grail API. |
| `dt_client_context` | string | No | Optional non-sensitive client context used to monitor query processing. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |