Task lifecycle (end-to-end)

This page is the canonical overview of how a task moves through Pairag after the May 2026 release. Use the sidebar for create / join / submit / accept guides; open Gold (fiat) transactions for USD escrow. Client labels may differ slightly, but all map to the same numeric status machine.

Happy path (typical)

  1. Draft — owner edits manifest, stages, Points bounties, and optional gold (USD) list amounts in the app (manual form or AI-assisted V18 JSON).
  2. Submit for platform review — task becomes *pending review*; content safety and structure checks run. Owners may be charged a submit fee in Points when configured.
  3. Recruiting — task is public; candidates apply per stage. Owner admits assignees and runs the alignment meeting (scope, IO, constraints).
  4. Readiness gates — when every stage has an assignee and alignment is *ready*, the product freezes delivery deposits (Points) and, for gold stages, Stripe pre-authorization plus Connect onboarding for assignees.
  5. Pending deposit (if needed) — task waits here until all required deposits / pre-auths succeed; owners can retry from the app.
  6. In progress — assignees deliver per stage (upload bundles, chat, optional artifact scan jobs). Owners may be notified on pre-auth state changes in chat.
  7. Accepting — when every non-cancelled stage has requested review, the task enters the acceptance pool. Owners (or review stages) approve or reject per stage.
  8. Review / wrap-up — after all stages reach a terminal outcome, the task enters a review window for continuation tasks, reputation settlement, and the optional G1 collaboration discussion period before completed or dissolved.

Task statuses (API values 1–10)

Numeric status values below. **Stage** statuses are separate (e.g. stage review overdue on a stage, not the same as task terminated).

  • 1 Draft — editable; not visible for recruiting.
  • 2 Pending review — submitted; awaiting platform approval.
  • 3 Recruiting — open applications; alignment sub-state tracks meeting progress.
  • 4 Pending deposit — alignment ready but deposits / gold pre-auth not complete.
  • 5 In progress — gates cleared; stages execute in parallel where allowed.
  • 6 Accepting — all required stages are in the review pool.
  • 7 Review — wrap-up window (continuation tasks, G1, reputation).
  • 8 Completed — legacy compatibility path; new flows prefer dissolve after review.
  • 9 Terminated — timeout or forced stop; gold pre-auths are voided per policy.
  • 10 Dissolved — normal closure after review window or owner dissolve when rules allow.

Alignment sub-state (orthogonal)

While recruiting, `alignment_status` tracks the meeting: 0 not started (e.g. missing assignee), 1 pending confirmations, 2 ready to start (Points: signatures done; gold: signatures + pre-auth + Connect), 3 failed (may require re-recruiting; existing gold pre-auth may be voided).

Stage-level flow (summary)

  • Assignee works → uploads deliverable bundle → may trigger artifact scan (async; failures surface on the bundle).
  • Assignee calls request review; owner confirms or rejects (gold capture only on owner confirm + funds password when required—no auto-capture on idle deadline for gold).
  • Points bounties release on approved stages; gold follows Stripe capture, platform fee, cooling, then Connect payout.

Gold (fiat) transactionsSee **Gold (fiat) transactions** for formulas, Stripe dashboards, and cooling period.

Related docs

Docs home·Home