Correct a weigh-in
Corrects a logged weigh-in (a mistyped weight, the wrong time, a missing note). Only the fields you send change; null clears an optional field. The grams-per-hour figures are recalculated. Weight alerts are not re-run.
bearerAuthAuthorizationBearer <token>A Clerk user API key or OAuth access token carrying the falconry:read and/or falconry:write scope.
weightId*stringA weigh-in's id, from get_weight_history or get_latest_weights.
length <= 64application/json- body
weightGrams?numberGrams.
0 < value <= 20000measuredAt?stringISO 8601 datetime, e.g. 2026-10-31T07:30:00Z.
length <= 40stomachState?stringChanging to 'empty' clears any prey details.
"empty""fed"preyTypeId?|nullpreyAmountGrams?|nullnotes?|nullCorrect a weigh-in
application/json- response
id*stringOpaque Convex document id.
length <= 64weightGrams*numbermeasuredAt*stringISO 8601 datetime this weigh-in was measured at.
stomachState*string"empty""fed"avgGph*|Average grams-per-hour of weight change since the previous empty-stomach weigh-in, when computable.
notes*string|nullpreyTypeId*|nullraptorId*stringOpaque Convex document id.
length <= 64preyAmountGrams*number|nullloggedByName*string|nullcurl -X PATCH 'https://app.falconryscale.com/api/v1/weights/string' \
-H 'Content-Type: application/json' \
-d '{}'{
"id": "string",
"weightGrams": 0,
"measuredAt": "string",
"stomachState": "empty",
"avgGph": 0,
"notes": "string",
"preyTypeId": "string",
"raptorId": "string",
"preyAmountGrams": 0,
"loggedByName": "string"
}Get one weigh-in
Returns one weigh-in by id, including the name of the food item fed (fed weigh-ins only). 404s if it does not exist or is not visible to the caller.
Delete a weigh-in
Permanently deletes one weigh-in. This cannot be undone. Before calling, read the entry back to the user (weight, date and raptor) and get their explicit confirmation.