Log a weigh-in
Records a new weigh-in for a raptor, in grams. This is how an AI assistant logs a scale reading on the caller's behalf.
bearerAuthAuthorizationBearer <token>A Clerk user API key or OAuth access token carrying the falconry:read and/or falconry:write scope.
raptorId*stringOpaque Convex document id.
length <= 64application/json- body
weightGrams*number0 < valuemeasuredAt?stringISO 8601 datetime. Defaults to now.
length <= 40stomachState?stringDefaults to 'empty'.
"empty""fed"preyTypeId?stringOnly meaningful when stomachState is 'fed'.
length <= 64preyAmountGrams?number0 < valuenotes?stringlength <= 2000Log 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 POST 'https://app.falconryscale.com/api/v1/raptors/string/weights' \
-H 'Content-Type: application/json' \
-d '{
"weightGrams": 1
}'{
"id": "string",
"weightGrams": 0,
"measuredAt": "string",
"stomachState": "empty",
"avgGph": 0,
"notes": "string",
"preyTypeId": "string",
"raptorId": "string",
"preyAmountGrams": 0,
"loggedByName": "string"
}Get a raptor’s weigh-in history
Returns one raptor's logged weigh-ins, newest first, in grams. Use `since` to bound a date range and `limit` to cap the count (default and max 500). A free-tier account's history beyond 30 days reads as empty (the app's own retention rule), not an error.
Get the latest weigh-in per raptor
Returns each raptor's two most recent weigh-ins plus its target/ready weight, for a fast morning-checklist read ("who still needs weighing today, who's out of range"). Pass `raptorIds` to scope to a subset, or omit it to check the whole roster.