Get the caller's profile
Returns the signed-in caller's own Falconry Scale profile: name, bio, display preferences, and subscription tier. Call this first to learn who the caller is before any raptor-scoped call.
bearerAuthAuthorizationBearer <token>A Clerk user API key or OAuth access token carrying the falconry:read and/or falconry:write scope.
Get the caller's profile
application/json- response
id*stringOpaque Convex document id.
length <= 64email*stringfirstName*string|nulllastName*string|nullfullName*string|nullbio*string|nulllocation*string|nullavatarUrl*string|nullpreferredUnits*|'metric' or 'imperial', for display only. Weights from this API are always grams.
weightPrecision*|Decimal places the user prefers weights displayed with.
distanceTemperatureUnit*string|nulldateFormat*string|nullsubscriptionTier*string"free""pro""team"onboardingCompleted*booleanfalconrySince*|A 4-digit year, e.g. 2019.
preferredLanguage*string|nulluserExperienceLevel*string|nullyearsExperience*number|nullcurl -X GET 'https://app.falconryscale.com/api/v1/profile'{
"id": "string",
"email": "string",
"firstName": "string",
"lastName": "string",
"fullName": "string",
"bio": "string",
"location": "string",
"avatarUrl": "string",
"preferredUnits": "string",
"weightPrecision": 0,
"distanceTemperatureUnit": "string",
"dateFormat": "string",
"subscriptionTier": "free",
"onboardingCompleted": true,
"falconrySince": 0,
"preferredLanguage": "string",
"userExperienceLevel": "string",
"yearsExperience": 0
}API reference
Every operation the public REST API (`/api/v1`) exposes, generated from the OpenAPI document.
Update the caller's profile
Edits the caller's own profile: name, bio, location, display preferences (units, precision, date format, language) and falconry experience. Only the fields you send change; null clears an optional field. Email, plan and photos can't be changed here.