Skip to main content
Version: 2.2.0

IPF OS Onboarding, Meals, and Tickets API

Contract source of truth for:

  • Google-first staff authentication
  • local fallback admin authentication
  • user provisioning and lifecycle management
  • department directory and membership reads
  • meals library, weekly menus, and meal selections
  • baseline ticket workflow

Reserved future ticketing route groups:

  • /department-backlog/* remains a Tickets Service capability, not a Departments capability
  • /escalations/* remains a Tickets Service capability for ticketing-owned resources
  • departments and department memberships remain owned by the User capability

List endpoints use the canonical pagination contract: currentPage and pageSize query parameters (with optional sortBy/sortOrder) and a PaginatedResponse envelope returning data plus pagination (total, currentPage, pageSize, totalPages). Do not use page, limit, itemsPerPage, or totalItems.

Authentication​

Send the access token from POST /auth/admin/login or POST /auth/google/complete as Authorization: Bearer <token>.

Security Scheme Type:

http

HTTP Authorization Scheme:

bearer

Bearer format:

JWT