# Better Stack

> Monitor website uptime, manage heartbeats and monitor groups, read status pages, and create, acknowledge and resolve incidents in Better Stack.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/better-stack

## Actions

### Acknowledge incident

Acknowledge incident.

**Inputs**

- Incident id (`incident_id`, text, required): Select the resource or use an ID returned by an earlier step.
- Acknowledged by (`acknowledged_by`, text): The acknowledged by.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "attributes": {
        "name": "QA",
        "paused": true
      },
      "id": "1",
      "type": "monitor"
    }
  }
}
```

### Create heartbeat

Create heartbeat.

**Inputs**

- Name (`name`, text, required): The name.
- Period (`period`, number, required): Expected interval between heartbeat pings, in seconds. From 30 to 31535999.
- Grace (`grace`, number, required): Allowed delay after a missed heartbeat, in seconds. From 0 to 31535999.
- Paused (`paused`, true/false): The paused.
- Email (`email`, true/false): The email.
- Sms (`sms`, true/false): The sms.
- Call (`call`, true/false): The call.
- Push (`push`, true/false): The push.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "attributes": {
        "name": "QA",
        "paused": true
      },
      "id": "1",
      "type": "monitor"
    }
  }
}
```

### Create incident

Create incident.

**Inputs**

- Requester email (`requester_email`, text, required): The requester email.
- Summary (`summary`, text, required): The summary.
- Description (`description`, text): The description.
- Email (`email`, true/false): The email.
- Sms (`sms`, true/false): The sms.
- Call (`call`, true/false): The call.
- Push (`push`, true/false): The push.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "attributes": {
        "name": "QA",
        "paused": true
      },
      "id": "1",
      "type": "monitor"
    }
  }
}
```

### Create monitor

Create monitor.

**Inputs**

- Url (`url`, text, required): The HTTPS website URL to monitor.
- Pronounceable name (`pronounceable_name`, text): A short, readable monitor name.
- Monitor type (`monitor_type`, text): The monitor type. One of: `status`, `keyword`, `keyword_absence` (Keyword absence), `expected_status_code` (Expected status code).
- Required keyword (`required_keyword`, text): Required for keyword and keyword absence monitors.
- Expected status codes (`expected_status_codes`, list): Required for expected status code monitors.
- Check frequency (`check_frequency`, number): The check frequency. One of: `30`, `45`, `60`, `120`, `180`, `300`, `600`, `900`, `1800`.
- Paused (`paused`, true/false): The paused.
- Email (`email`, true/false): The email.
- Sms (`sms`, true/false): The sms.
- Call (`call`, true/false): The call.
- Push (`push`, true/false): The push.
- Monitor group (`monitor_group_id`, text): The monitor group id.
- Regions (`regions`, list): The regions. One or more of: `us`, `eu`, `as`, `au`.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "attributes": {
        "name": "QA",
        "paused": true
      },
      "id": "1",
      "type": "monitor"
    }
  }
}
```

### Create monitor group

Create monitor group.

**Inputs**

- Name (`name`, text, required): The name.
- Sort index (`sort_index`, number): The sort index.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "attributes": {
        "name": "QA",
        "paused": true
      },
      "id": "1",
      "type": "monitor"
    }
  }
}
```

### Delete heartbeat

Delete heartbeat.

**Inputs**

- Heartbeat (`heartbeat_id`, text, required): Select the resource or use an ID returned by an earlier step.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {}
}
```

### Delete monitor

Delete monitor.

**Inputs**

- Monitor (`monitor_id`, text, required): Select the resource or use an ID returned by an earlier step.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {}
}
```

### Delete monitor group

Delete monitor group.

**Inputs**

- Monitor group (`monitor_group_id`, text, required): Select the resource or use an ID returned by an earlier step.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {}
}
```

### Get heartbeat

Get heartbeat.

**Inputs**

- Heartbeat (`heartbeat_id`, text, required): Select the resource or use an ID returned by an earlier step.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "attributes": {
        "name": "QA",
        "paused": true
      },
      "id": "1",
      "type": "monitor"
    }
  }
}
```

### Get incident

Get incident.

**Inputs**

- Incident id (`incident_id`, text, required): Select the resource or use an ID returned by an earlier step.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "attributes": {
        "name": "QA",
        "paused": true
      },
      "id": "1",
      "type": "monitor"
    }
  }
}
```

### Get monitor

Get monitor.

**Inputs**

- Monitor (`monitor_id`, text, required): Select the resource or use an ID returned by an earlier step.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "attributes": {
        "name": "QA",
        "paused": true
      },
      "id": "1",
      "type": "monitor"
    }
  }
}
```

### Get monitor availability

Get monitor availability.

**Inputs**

- Monitor (`monitor_id`, text, required): Select the resource or use an ID returned by an earlier step.
- From date (`from_date`, date): The from date.
- To date (`to_date`, date): The to date.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "attributes": {
        "name": "QA",
        "paused": true
      },
      "id": "1",
      "type": "monitor"
    }
  }
}
```

### Get monitor group

Get monitor group.

**Inputs**

- Monitor group (`monitor_group_id`, text, required): Select the resource or use an ID returned by an earlier step.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "attributes": {
        "name": "QA",
        "paused": true
      },
      "id": "1",
      "type": "monitor"
    }
  }
}
```

### Get monitor response times

Get monitor response times.

**Inputs**

- Monitor (`monitor_id`, text, required): Select the resource or use an ID returned by an earlier step.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "attributes": {
        "name": "QA",
        "paused": true
      },
      "id": "1",
      "type": "monitor"
    }
  }
}
```

### Get status page

Get status page.

**Inputs**

- Status page (`status_page_id`, text, required): Select the resource or use an ID returned by an earlier step.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "attributes": {
        "name": "QA",
        "paused": true
      },
      "id": "1",
      "type": "monitor"
    }
  }
}
```

### List heartbeats

List heartbeats.

**Inputs**

- Page (`page`, number): The page. At least 1.
- Per page (`per_page`, number): The per page. From 1 to 50.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": [],
    "pagination": {
      "next": null
    }
  }
}
```

### List incidents

List incidents.

**Inputs**

- Page (`page`, number): The page. At least 1.
- Per page (`per_page`, number): The per page. From 1 to 50.
- From date (`from_date`, date): The from date.
- To date (`to_date`, date): The to date.
- Resolved (`resolved`, true/false): The resolved.
- Acknowledged (`acknowledged`, true/false): The acknowledged.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": [],
    "pagination": {
      "next": null
    }
  }
}
```

### List monitor groups

List monitor groups.

**Inputs**

- Page (`page`, number): The page. At least 1.
- Per page (`per_page`, number): The per page. From 1 to 50.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": [],
    "pagination": {
      "next": null
    }
  }
}
```

### List monitors

List monitors.

**Inputs**

- Page (`page`, number): The page. At least 1.
- Per page (`per_page`, number): The per page. From 1 to 50.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": [],
    "pagination": {
      "next": null
    }
  }
}
```

### List status page resources

List status page resources.

**Inputs**

- Status page (`status_page_id`, text, required): Select the resource or use an ID returned by an earlier step.
- Page (`page`, number): The page. At least 1.
- Per page (`per_page`, number): The per page. From 1 to 50.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": [],
    "pagination": {
      "next": null
    }
  }
}
```

### List status pages

List status pages.

**Inputs**

- Page (`page`, number): The page. At least 1.
- Per page (`per_page`, number): The per page. From 1 to 50.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": [],
    "pagination": {
      "next": null
    }
  }
}
```

### Resolve incident

Resolve incident.

**Inputs**

- Incident id (`incident_id`, text, required): Select the resource or use an ID returned by an earlier step.
- Resolved by (`resolved_by`, text): The resolved by.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "attributes": {
        "name": "QA",
        "paused": true
      },
      "id": "1",
      "type": "monitor"
    }
  }
}
```

### Update heartbeat

Update heartbeat.

**Inputs**

- Heartbeat (`heartbeat_id`, text, required): Select the resource or use an ID returned by an earlier step.
- Name (`name`, text): The name.
- Period (`period`, number): Expected interval between heartbeat pings, in seconds. From 30 to 31535999.
- Grace (`grace`, number): Allowed delay after a missed heartbeat, in seconds. From 0 to 31535999.
- Paused (`paused`, true/false): The paused.
- Email (`email`, true/false): The email.
- Sms (`sms`, true/false): The sms.
- Call (`call`, true/false): The call.
- Push (`push`, true/false): The push.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "attributes": {
        "name": "QA",
        "paused": true
      },
      "id": "1",
      "type": "monitor"
    }
  }
}
```

### Update monitor

Update monitor.

**Inputs**

- Monitor (`monitor_id`, text, required): Select the resource or use an ID returned by an earlier step.
- Url (`url`, text): The HTTPS website URL to monitor.
- Pronounceable name (`pronounceable_name`, text): A short, readable monitor name.
- Monitor type (`monitor_type`, text): The monitor type. One of: `status`, `keyword`, `keyword_absence` (Keyword absence), `expected_status_code` (Expected status code).
- Required keyword (`required_keyword`, text): Required for keyword and keyword absence monitors.
- Expected status codes (`expected_status_codes`, list): Required for expected status code monitors.
- Check frequency (`check_frequency`, number): The check frequency. One of: `30`, `45`, `60`, `120`, `180`, `300`, `600`, `900`, `1800`.
- Paused (`paused`, true/false): The paused.
- Email (`email`, true/false): The email.
- Sms (`sms`, true/false): The sms.
- Call (`call`, true/false): The call.
- Push (`push`, true/false): The push.
- Monitor group (`monitor_group_id`, text): The monitor group id.
- Regions (`regions`, list): The regions. One or more of: `us`, `eu`, `as`, `au`.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "attributes": {
        "name": "QA",
        "paused": true
      },
      "id": "1",
      "type": "monitor"
    }
  }
}
```

### Update monitor group

Update monitor group.

**Inputs**

- Monitor group (`monitor_group_id`, text, required): Select the resource or use an ID returned by an earlier step.
- Name (`name`, text): The name.
- Sort index (`sort_index`, number): The sort index.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": {
      "attributes": {
        "name": "QA",
        "paused": true
      },
      "id": "1",
      "type": "monitor"
    }
  }
}
```
