v1
Materials
Materials

Get Required Actions

Return all three required-action queues for the shop:

  • needs_approval: items with qs_state='approval'
  • missing_receipt: items with qs_state='purch' AND reimburse=true AND receipt_uploaded=false/null
  • reimbursements: items with reimburse=true AND (returned=false/null)
  • missing_receipt_expenses: project expenses with no receipt file attached

Shop is server-injected. Global across every project/quote in the shop (this was already true before 2026-07-21 — no project_id param ever existed here — this reposition just makes the frontend match: one page instead of nested per-project, with a Project column since results were always mixed together). Gated to pm_review (manager-only, 2026-07-21) — sign-off/receipt/reimbursement queues are a PM/admin decision, not general materials-read access. Legacy listless items (list_id IS NULL) are now included too — every query below used to filter strictly on list_id and silently excluded them.

Session-shop scoped for everyone, platform admins included: this renders inside shop-scoped chrome with no shop column, so a foreign row is indistinguishable from a local one — and the row actions (approve, upload receipt, mark reimbursed) are financial sign-offs. An admin who wants another shop's queue switches shops.

get/api/v1/materials/required-actions

Request

  • Base URL: https://api.jeevyfabrication.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.jeevyfabrication.com/api/v1/materials/required-actions
  • Auth: none declared

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 1 revision of this API.