DEVELOPERS
API & Docs
Endpoints
REST: https://ivy-backend.fly.dev/v1OpenAPI: https://ivy-backend.fly.dev/openapi.jsonInteractive docs: https://ivy-backend.fly.dev/docsMCP: https://ivy-backend.fly.dev/mcpHealth: https://ivy-backend.fly.dev/healthAuthenticate
Authorization: Bearer <token>Your sign-in session token, or an ivy_pat_… personal access token for agents and scripts — both resolve to the same canonical user. Mint PATs via POST /v1/me/tokens or python -m app.cli tokens create.
Try it
curl -H "Authorization: Bearer <token>" https://ivy-backend.fly.dev/v1/meCore V1 actions
POST https://ivy-backend.fly.dev/v1/uploads/presign — image upload URLPOST https://ivy-backend.fly.dev/v1/meals/analyze — queue photo analysis (1 credit)GET https://ivy-backend.fly.dev/v1/jobs/{id} — job status + resultGET https://ivy-backend.fly.dev/v1/jobs/{id}/events — progress streamGET https://ivy-backend.fly.dev/v1/days/{date} — day ledger + goalPATCH https://ivy-backend.fly.dev/v1/meals/{id} — correct a mealPUT https://ivy-backend.fly.dev/v1/goals/calories — daily targetGET https://ivy-backend.fly.dev/v1/me — identity + credit balancePOST/GET/DELETE https://ivy-backend.fly.dev/v1/me/tokens — PAT managementPOST https://ivy-backend.fly.dev/v1/ingest/apple-health — device metrics (Shortcuts / Health Auto Export)Analysis is asynchronous: 202 Accepted returns a job ID; poll the job or stream its events until it completes.
MCP (assistants)
URL: https://ivy-backend.fly.dev/mcpAuth: Bearer <token>Tools: log_meal, queue_meal_image, get_job, set_calorie_goal, get_day, get_progress.
Example assistant prompts
- “Log this meal.”
- “How many calories have I eaten today?”
- “How many calories do I have left?”
- “That portion was actually half as much.”
- “What did I eat yesterday?”