Tools

Create Datapoint

Add one or more datapoints to a Beeminder goal. This is the primary way to track progress. Supports single or batch creation, with optional idempotent upserts via requestId.

Create Charge

Create a monetary charge against a Beeminder user. Useful for custom penalties or application-specific fees. Supports a dry run mode for testing without actually charging.

Update Goal

Update an existing goal's settings. Allows modifying title, y-axis label, visibility, road (bright red line), tags, and webhook callback URL. Road changes are subject to the one-week akrasia horizon.

List Datapoints

Retrieve datapoints for a specific goal. Supports pagination and sorting. Returns the datapoint values, timestamps, comments, and metadata.

Update Datapoint

Update an existing datapoint's value, timestamp, daystamp, or comment. Requires both the goal slug and the datapoint ID.

Get Goal

Retrieve detailed information about a specific goal by its slug. Includes current value, pledge, safety buffer, road definition, and all goal configuration.

Delete Datapoint

Delete a specific datapoint from a goal. This permanently removes the datapoint and recalculates the goal graph.

Get User

Retrieve the authenticated user's profile information including timezone, account status, and urgency load.

List Goals

Retrieve all goals for the authenticated user. Can list active or archived goals. Returns goal details including current status, pledge, safety buffer, and deadline information.

Manage Goal

Perform management actions on a goal: refresh autodata, ratchet (reduce safety buffer), short-circuit (instantly derail and charge), step down pledge, cancel a scheduled step-down, or cry uncle (instant derail for beemergency goals). Each action has specific preconditions.

Create Goal

Create a new Beeminder goal. Requires a slug, title, goal type, and units. Exactly two of goaldate, goalval, and rate must be specified to define the bright red line trajectory.