Portal
SandboxAPI v1Not signed inExternal user: —

Scopes & permissions

End users grant fine-grained scopes over their FoodAPI partition.

Common scopes

  • foodapi:recipes:read / foodapi:recipes:write
  • foodapi:nutrition:read
  • foodapi:pantry:read / foodapi:pantry:write
  • foodapi:mealplans:read / foodapi:mealplans:write
  • foodapi:shopping:read / foodapi:shopping:write
  • foodapi:menus:read (write, ground, visualize, enhance, publish, and delete scopes exist for later phases)

Failures agents should handle

  • Missing scope — authorization error; tool may be hidden and denied on call
  • Ambiguous food — domain codes such as NORMALIZATION_AMBIGUOUS
  • Quota — 402 QUOTA_EXCEEDED (shared with REST)
  • Rate limit — 429 with backoff

Related

Authentication · Errors