# Geckoboard

> Connect Geckoboard to automate dashboard datasets.

App · 5 actions. Web page: https://docs.lodol.com/docs/integrations/geckoboard

## Actions

### Append records

Adds up to 500 records to a dataset, updating any that match its unique fields, and can drop the oldest records by a date field.

**Inputs**

- Dataset id (`dataset_id`, text, required): Dataset id for this request.
- Data (`data`, list, required): Data for this request.
- Delete by (`delete_by`, text): Delete by for this request.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Check account

Checks that the API key works by making a simple authenticated request to your Geckoboard account.

**Inputs**: None.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Delete dataset

Deletes a dataset by its ID, along with all its records.

**Inputs**

- Dataset id (`dataset_id`, text, required): Dataset id for this request.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": null,
  "has_more": false,
  "next_cursor": null
}
```

### Find or create dataset

Finds a dataset by its ID, or creates it with the field types you give and optional unique fields. Returns the dataset's fields.

**Inputs**

- Dataset id (`dataset_id`, text, required): Dataset id for this request.
- Fields (`fields`, object, required): Fields for this request.
- Unique by (`unique_by`, list): Unique by for this request.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Replace records

Replaces all the records in a dataset with up to 500 new ones.

**Inputs**

- Dataset id (`dataset_id`, text, required): Dataset id for this request.
- Data (`data`, list, required): Data for this request.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```
