Geckoboard
App · 5 actions
Connect Geckoboard to automate dashboard datasets.
Actions
| Action | What it does |
|---|---|
| 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. |
| Check account | Checks that the API key works by making a simple authenticated request to your Geckoboard account. |
| Delete dataset | Deletes a dataset by its ID, along with all its records. |
| Find or create dataset | Finds a dataset by its ID, or creates it with the field types you give and optional unique fields. |
| Replace records | Replaces all the records in a dataset with up to 500 new ones. |
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_idtextRequired - Dataset id for this request.
- Data
datalistRequired - Data for this request.
- Delete by
delete_bytext - Delete by for this request.
Outputs
dataobject- The service response, including all records and metadata.
has_moretrue/false- Whether another page is available.
next_cursortext- Continuation value for the next page.
Example output
{
"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
dataobject- The service response, including all records and metadata.
has_moretrue/false- Whether another page is available.
next_cursortext- Continuation value for the next page.
Example output
{
"data": {},
"has_more": false,
"next_cursor": null
}Delete dataset
Deletes a dataset by its ID, along with all its records.
Inputs
- Dataset id
dataset_idtextRequired - Dataset id for this request.
Outputs
dataobject- The service response, including all records and metadata.
has_moretrue/false- Whether another page is available.
next_cursortext- Continuation value for the next page.
Example output
{
"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_idtextRequired - Dataset id for this request.
- Fields
fieldsobjectRequired - Fields for this request.
- Unique by
unique_bylist - Unique by for this request.
Outputs
dataobject- The service response, including all records and metadata.
has_moretrue/false- Whether another page is available.
next_cursortext- Continuation value for the next page.
Example output
{
"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_idtextRequired - Dataset id for this request.
- Data
datalistRequired - Data for this request.
Outputs
dataobject- The service response, including all records and metadata.
has_moretrue/false- Whether another page is available.
next_cursortext- Continuation value for the next page.
Example output
{
"data": {},
"has_more": false,
"next_cursor": null
}