v0.2.0

Reconcile SDK with the deployed Saturday API — real routes (/mcp, /v1/products/*, /v1/oauth/token, activity /calculate), correct field names (year_of_birth, subscription_id, type, is_race_event), cursor pagination; dropped phantom compare(). Breaking vs 0.1.x.

v0.1.1

Fixes

• Auth header: Changed from X-API-Key to Authorization: Bearer to match the gateway API contract
• Key prefix: Updated examples from sat_live_/sat_test_ to sk_live_/sk_test_

These are breaking changes from v0.1.0. If you installed 0.1.0, upgrade immediately.

pip install --upgrade saturday

v0.1.0 — Initial Release

Official Python SDK for the Saturday Nutrition Intelligence API.

Install

pip install saturday

Features

• Typed client for all 88 API endpoints
• Retry logic with exponential backoff
• Safety types (SafetyMetadata, not_instructions)
• Stripe-style error handling
• OAuth2 + API key authentication

Documentation →