uptime-robot-v3
    Preparing search index...

    Client for the Monitor Groups API.

    https://uptimerobot.com/api/v3 Official API Documentation

    1.0.0

    Index

    Monitor Groups

    Other

    Monitor Groups

    • Creates a new monitor group in your UptimeRobot account for organizing monitors into logical collections. Groups can be used for filtering, reporting, and managing monitors collectively.

      Parameters

      • payload: MonitorGroupPayload

        Monitor group configuration object (see MonitorGroupPayload interface for all options)

      Returns Promise<MonitorGroup>

      Promise that resolves to the created MonitorGroup object with assigned ID

      When required fields are missing or validation fails

      When API request fails or returns an error response

      // Create a new monitor group
      const group = await service.monitorGroups.create({
      name: 'Production APIs',
      description: 'Critical production API endpoints'
      });

      1.0.0

    • Removes a monitor group completely from your UptimeRobot account. This action cannot be undone. Monitors in the group will not be deleted, but will be removed from the group.

      Parameters

      • id: idField

        Monitor group ID (number or string)

      Returns Promise<boolean>

      Promise that resolves to true when deletion is successful

      When monitor group ID is not found

      When API request fails

      // Delete a monitor group
      const success = await service.monitorGroups.delete((12345);
      if (success) {
      console.log('Monitor group deleted successfully');
      }

      1.0.0

    • Fetches complete information about an individual monitor group by ID, including name, description, associated monitors, and group statistics.

      Parameters

      • id: idField

        Monitor group ID (number or string)

      Returns Promise<MonitorGroup>

      Promise that resolves to the MonitorGroup object

      When monitor group ID is not found

      When API request fails

      // Get monitor group details
      const group = await service.monitorGroups.get(12345);
      console.log(`Group "${group.name}" contains ${group.monitorCount} monitors`);

      1.0.0

    • Retrieves a list of monitor groups from your UptimeRobot account. Monitor groups help organize monitors into logical collections for easier management and reporting. Results are paginated using cursor-based pagination.

      Parameters

      • Optionalfilter: { cursor?: number }

        Query string parameters passed to the API

        • Optionalcursor?: number

          Pagination cursor for next page

      • OptionalreturnFullResponse: false

      Returns Promise<MonitorGroup[]>

      Returns MonitorGroup[] by default, or URFullResponse<MonitorGroup> if returnFullResponse is true.

      When cursor is negative

      // Get all monitor groups
      const groups = await service.monitorGroups.list();

      // Paginate through results
      const page1 = await service.monitorGroups.list();
      const page2 = await service.monitorGroups.list({ cursor: 123456789 });

      // Get full response for pagination
      const response = await service.monitorGroups.list({}, true);
      const nextUrl = new URL(response.nextLink);
      const nextCursorVal = nextUrl.searchParams.get('cursor');
      console.log(nextCursorVal);

      1.0.0

    • Retrieves a list of monitor groups from your UptimeRobot account. Monitor groups help organize monitors into logical collections for easier management and reporting. Results are paginated using cursor-based pagination.

      Parameters

      • filter: { cursor?: number }

        Query string parameters passed to the API

        • Optionalcursor?: number

          Pagination cursor for next page

      • returnFullResponse: true

      Returns Promise<URFullResponse<MonitorGroup>>

      Returns MonitorGroup[] by default, or URFullResponse<MonitorGroup> if returnFullResponse is true.

      When cursor is negative

      // Get all monitor groups
      const groups = await service.monitorGroups.list();

      // Paginate through results
      const page1 = await service.monitorGroups.list();
      const page2 = await service.monitorGroups.list({ cursor: 123456789 });

      // Get full response for pagination
      const response = await service.monitorGroups.list({}, true);
      const nextUrl = new URL(response.nextLink);
      const nextCursorVal = nextUrl.searchParams.get('cursor');
      console.log(nextCursorVal);

      1.0.0

    • Modifies the settings of an existing monitor group. Note: This endpoint only updates the name of the monitor group. Other properties cannot be changed after creation.

      Parameters

      • id: idField

        Monitor group ID (number or string)

      • payload: MonitorGroupPayload

        Monitor group configuration updates (partial MonitorGroupPayload object)

      Returns Promise<MonitorGroup>

      Promise that resolves to the updated MonitorGroup object

      When monitor group ID is not found

      When payload validation fails

      // Update monitor group name
      const updatedGroup = await service.monitorGroups.update((12345, {
      name: 'Updated Production APIs'
      });

      1.0.0

    Other