Datto RMM

Interact with Datto RMM API to manage devices, sites, alerts, and monitoring

Actions59

Job → Get History

AI-generated

Overview

This node operation retrieves the history of a specified job from the Datto RMM platform. It is useful for monitoring and auditing job executions, allowing users to filter job history by date range and status, and to paginate results or retrieve all entries automatically. Practical examples include tracking job completion statuses over time, identifying failed jobs for troubleshooting, and reviewing job execution timelines.

Use Case Examples

  1. Retrieve the complete execution history of a specific job to analyze its performance and outcomes.
  2. Filter job history to show only failed jobs within a certain date range for troubleshooting purposes.
  3. Paginate through job history results to manage large datasets efficiently.

Properties

Name Meaning
Job Select the specific job to retrieve history for, from the list of available jobs.
Retrieve All Whether to retrieve all job history results automatically using pagination or to manually specify page and max results.
Page Page number to retrieve when not retrieving all results automatically (1-based).
Max Results Maximum number of job history results to return per page when not retrieving all automatically.
Start Date Start date for filtering job history entries (ISO 8601 format).
End Date End date for filtering job history entries (ISO 8601 format).
Status Filter Filter job history entries by execution status (e.g., completed, failed, running, queued).
Fields to Include Select which fields to include in the job history response, allowing customization of the returned data.

Output

JSON

  • jobHistory - Array of job history entries matching the specified filters and pagination settings.

Dependencies

  • Datto RMM API with appropriate API key credentials

Troubleshooting

  • Ensure the selected job UID is valid and accessible with the provided API credentials.
  • Verify that date filters (start and end dates) are in correct ISO 8601 format to avoid request errors.
  • If pagination is used, ensure page and max results values are within valid ranges to prevent empty or incomplete responses.
  • Check API rate limits and network connectivity if requests fail or time out.

Links

Discussion