DevelopersAPI reference
Edit a custom food item
Edits one of the caller's own custom food items (built-in items can't be edited: 404). Only the fields you send change; null clears an optional field.
PATCH
bearerAuthheader
AuthorizationBearer <token>A Clerk user API key or OAuth access token carrying the falconry:read and/or falconry:write scope.
foodItemId*stringA food item's id, from list_food_items.
Length
length <= 64application/json- body
name?stringMatch
^[\p{L}\p{M}\p{N} '_-]+$Length
2 <= length <= 50description?|nullfoodType?|nulldefaultWeightGrams?|nullEdit a custom food item
application/json- response
id*stringOpaque Convex document id.
Length
length <= 64name*stringDisplay name, e.g. "Quail".
description*string|nullfoodType*|'whole' (a whole animal) or 'portion' (a cut or part).
defaultWeightGrams*number|nullisCustom*booleanTrue for an item the caller created (editable); false for a built-in item.
isFavorite*booleanusageCount*numberlastUsedAt*string|nullcurl -X PATCH 'https://app.falconryscale.com/api/v1/food-items/string' \
-H 'Content-Type: application/json' \
-d '{}'Example Response
{
"id": "string",
"name": "string",
"description": "string",
"foodType": "whole",
"defaultWeightGrams": 0,
"isCustom": true,
"isFavorite": true,
"usageCount": 0,
"lastUsedAt": "string"
}