create_datapoint
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_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.
Track and manage commitment-based goals with financial accountability. Create, update, and archive goals of various types (Do More, Do Less, Weight Loss, Odometer, etc.). Add, update, and delete datapoints on goals with idempotent upsert support. Manage the Bright Red Line commitment trajectory, adjust pledge levels, ratchet safety buffers, and trigger instant derails. Retrieve user profile information and poll for goal updates efficiently. Create monetary charges against users. Refresh autodata from connected third-party sources. Receive webhook notifications when goals are about to derail or when Beeminder needs fresh data from an integration.
Common questions about connecting Beeminder to AI agents with Metorial.