Geckoboard

App · 5 actions

Connect Geckoboard to automate dashboard datasets.

Actions

ActionWhat it does
Append recordsAdds 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 accountChecks that the API key works by making a simple authenticated request to your Geckoboard account.
Delete datasetDeletes a dataset by its ID, along with all its records.
Find or create datasetFinds a dataset by its ID, or creates it with the field types you give and optional unique fields.
Replace recordsReplaces 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 iddataset_idtextRequired
Dataset id for this request.
DatadatalistRequired
Data for this request.
Delete bydelete_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 iddataset_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 iddataset_idtextRequired
Dataset id for this request.
FieldsfieldsobjectRequired
Fields for this request.
Unique byunique_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 iddataset_idtextRequired
Dataset id for this request.
DatadatalistRequired
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
}

On this page