Beeminder

Beeminder integration (Productivity, Finance). Imported from open-connector.

API key8 toolshttps://www.beeminder.com/api/v1

GET

beeminder_get_user

Get Beeminder user information, including goals and optional diff-based goal details.

/users/{username}.json

5 parameters

Param	Type	Required	Description
username	string	required	The Beeminder username, or me for the authenticated user.
associations	boolean	optional	Whether to include full goal and datapoint objects instead of only goal slugs.
diff_since	integer	optional	A Unix timestamp in seconds.
skinny	boolean	optional	Whether to return slimmer goal attributes and only each goal's latest datapoint…
datapoints_count	integer	optional	Number of the most recently added datapoints to include for each goal.

GET

beeminder_list_goals

List active Beeminder goals for a user.

/users/{username}/goals.json

1 parameter

Param	Type	Required	Description
username	string	required	The Beeminder username, or me for the authenticated user.

GET

beeminder_list_archived_goals

List archived Beeminder goals for a user.

/users/{username}/goals/archived.json

1 parameter

Param	Type	Required	Description
username	string	required	The Beeminder username, or me for the authenticated user.

GET

beeminder_get_goal

Read one Beeminder goal, optionally including its datapoints.

/users/{username}/goals/{goal_slug}.json

3 parameters

Param	Type	Required	Description
username	string	required	The Beeminder username, or me for the authenticated user.
goal_slug	string	required	The Beeminder goal slug.
datapoints	boolean	optional	Whether Beeminder should include datapoints in the goal response.

GET

beeminder_list_datapoints

List datapoints for one Beeminder goal with optional count or page parameters.

/users/{username}/goals/{goal_slug}/datapoints.json

5 parameters

Param	Type	Required	Description
username	string	required	The Beeminder username, or me for the authenticated user.
goal_slug	string	required	The Beeminder goal slug.
count	integer	optional	Maximum number of datapoints to return. Ignored when page is set.
page	integer	optional	Page number for paginated datapoint results.
per	integer	optional	Number of datapoints per page when page is set.

POST

beeminder_create_datapoint

Create one datapoint on a Beeminder goal.

/users/{username}/goals/{goal_slug}/datapoints.json

7 parameters

Param	Type	Required	Description
username	string	required	The Beeminder username, or me for the authenticated user.
goal_slug	string	required	The Beeminder goal slug.
value	number	required	The datapoint value.
timestamp	integer	optional	A Unix timestamp in seconds.
daystamp	string	optional	The datapoint daystamp in YYYYMMDD format.
comment	string	optional	The datapoint comment.
requestid	string	optional	A caller-supplied idempotency key scoped to the goal. Reusing it avoids duplica…

PUT

beeminder_update_datapoint

Update one Beeminder datapoint by ID.

/users/{username}/goals/{goal_slug}/datapoints/{datapoint_id}.json

7 parameters

Param	Type	Required	Description
username	string	required	The Beeminder username, or me for the authenticated user.
goal_slug	string	required	The Beeminder goal slug.
datapoint_id	string	required	The Beeminder datapoint ID.
value	number	optional	The updated datapoint value.
timestamp	integer	optional	A Unix timestamp in seconds.
daystamp	string	optional	The updated datapoint daystamp in YYYYMMDD format.
comment	string	optional	The datapoint comment.

DELETE

beeminder_delete_datapoint

Delete one Beeminder datapoint by ID.

/users/{username}/goals/{goal_slug}/datapoints/{datapoint_id}.json

3 parameters

Param	Type	Required	Description
username	string	required	The Beeminder username, or me for the authenticated user.
goal_slug	string	required	The Beeminder goal slug.
datapoint_id	string	required	The Beeminder datapoint ID.