---
title: "Magic values"
url: https://services.dev/docs/reference/magic-values
---
# Magic values

URL: https://services.dev/docs/reference/magic-values

> Every sandbox value, the branch it makes a job take, and the pages whose captured runs took it, so every person and outside branch runs without a person.

41 values. Set one in an order's `metadata.sandbox`, as a party's email or as a watch's url, and the job takes that branch. Time is the sandbox's other lever: a [test clock](https://services.dev/docs/reference/operations.md#test-clocks) moves every date a job waits on, and [`tick`](https://services.dev/docs/reference/cli.md#tick) moves dev's own, such as `npx services.dev tick 1y`.

```txt
magic values: metadata.sandbox.review = flag_once

→ POST /localization {"strings":"strings.json","listing":"listing.txt","to":"de","max_usd":49,"key":"flag-once","metadata":{"sandbox":{"review":"flag_once"}}}
← job_7Hq6 · delivered · strings.de.json · listing.de.txt · $49.00 charged
  record  terms · ai | strings · ai | listing · ai | qa · ai · adversarial · 3 lenses · flagged | strings · ai · redo | qa · ai · adversarial · 3 lenses · pass
  stage   qa
  steps   stp_1 terms committed · stp_2 strings committed · stp_3 listing committed · stp_4 qa committed
```

| At | Value | Branch | Shown on |
|---|---|---|---|
| `metadata.sandbox.review` | `pass` | Every simulated review round passes. The default. | legal: [Every branch](https://services.dev/docs/examples/legal/branches.md), lingua: [lingua](https://services.dev/docs/examples/lingua.md) |
| `metadata.sandbox.review` | `flag_once` | The first round flags the work back, so the flagged branch and the redo run; the next round passes. | [Harden it](https://services.dev/docs/grow/review.md), [All four, in one filing](https://services.dev/docs/grow/together.md), [The packet](https://services.dev/docs/people/pool/packet.md), [AI steps and briefs](https://services.dev/docs/service/ai.md), legal: [Every branch](https://services.dev/docs/examples/legal/branches.md), lingua: [lingua](https://services.dev/docs/examples/lingua.md) |
| `metadata.sandbox.propose` | `{ <field>: [first, then, …] }` | The simulated AI proposes these values for the field, attempt by attempt, so a guard refusal and the redo run. | [Propose, then the gate commits](https://services.dev/docs/service/gate.md), [Guards](https://services.dev/docs/service/guards.md), [The record](https://services.dev/docs/service/record.md), [Signals](https://services.dev/docs/service/signals.md), legal: [Demand letter](https://services.dev/docs/examples/legal/demand-letter.md) |
| `metadata.sandbox.ai` | `down` | The simulated model is unavailable: every AI step retries on its backoff while the deadline runs, so at risk, an escalation and late run. | [Deadlines](https://services.dev/docs/service/within.md#late), [Keeping time](https://services.dev/docs/service/time.md#the-tick) |
| a party input's email | `signs@example.test` | The party acts at once: signs, consents, answers every item, takes the first choice. | [The delivery portal](https://services.dev/docs/app/members.md), [Dates at risk](https://services.dev/docs/operate/dates.md), [The owner console](https://services.dev/docs/app/owner.md), [Subscriptions and allowances](https://services.dev/docs/money/subscriptions.md), legal: [Every branch](https://services.dev/docs/examples/legal/branches.md), tax: [Every branch](https://services.dev/docs/examples/tax/branches.md) |
| a party input's email | `declines@example.test` | The party declines, and the job ends at $0 with the reason declined, unless the step routes it. | [All four, in one filing](https://services.dev/docs/grow/together.md), [Buyer, client, party](https://services.dev/docs/people/parties.md), ['Asks: a ceremony without an account'](https://services.dev/docs/service/ask.md), [Grants and decisions](https://services.dev/docs/service/grants.md), legal: [Every branch](https://services.dev/docs/examples/legal/branches.md), tax: [Every branch](https://services.dev/docs/examples/tax/branches.md), sales: [Every branch](https://services.dev/docs/examples/sales/branches.md) |
| a party input's email | `silent@example.test` | The party never answers: by the clock the ask reminds, expires, opens once more, and the second expiry lapses the job. | [Dates at risk](https://services.dev/docs/operate/dates.md), ['Asks: a ceremony without an account'](https://services.dev/docs/service/ask.md), [Deadlines](https://services.dev/docs/service/within.md), legal: [Every branch](https://services.dev/docs/examples/legal/branches.md), tax: [Every branch](https://services.dev/docs/examples/tax/branches.md), sales: [Every branch](https://services.dev/docs/examples/sales/branches.md) |
| a party input's email | `ghost@example.test` | The party goes silent before any meeting is set, so a `silent` signal with `of` on that party fires while the job is still booking, and the party answers the nurturer. | sales: [Every branch](https://services.dev/docs/examples/sales/branches.md) |
| a party input's email | `replies@example.test` | The party replies to the job's third message, so a signal on replies, such as `warm`, is raised. | sales: [One deal, every side](https://services.dev/docs/examples/sales/walk.md), sales: [Every branch](https://services.dev/docs/examples/sales/branches.md) |
| a party input's email | `noshow@example.test` | The party never attends the first meeting booked with it, so a guard on the meeting refuses it, and attends the next one. | sales: [Every branch](https://services.dev/docs/examples/sales/branches.md) |
| a party input's email | `customer@example.test` | The party is already the seller's customer on its connected Stripe account, so an order answers account_is_customer and offers the expansion. | sales: [Every deal shape](https://services.dev/docs/examples/sales/shapes.md#an-expansion) |
| `metadata.sandbox.members` | `{ <step>: [proposal, …] }` | Each simulated member at that step proposes these, attempt by attempt, such as a close below the floor and then one above it, so a guard refusal and the commit run. `{ revived: false }` at nurture confirms a deal dead. | sales: [One deal, every side](https://services.dev/docs/examples/sales/walk.md), [The Deal Service](https://services.dev/docs/examples/sales/deal.md), sales: [Every branch](https://services.dev/docs/examples/sales/branches.md) |
| `metadata.sandbox.members` | `{ <step>: [] }` | No simulated member claims the step's Task, so its hold lapses and it reopens to the next tier's feed. | sales: [Every branch](https://services.dev/docs/examples/sales/branches.md) |
| `metadata.sandbox.members` | `{ <step>: [{ ask: { <policy>: <value> } }, …] }` | The simulated member asks the buyer to set that policy value for this job, and a sandbox buyer who acts at once sets it. | sales: [The Deal Service](https://services.dev/docs/examples/sales/deal.md#the-floor) |
| `metadata.sandbox.proof` | `paid` | The outcome's payment lands on its terms, such as net 30 from the close. The default. | sales: [One deal, every side](https://services.dev/docs/examples/sales/walk.md), [The money](https://services.dev/docs/examples/sales/money.md) |
| `metadata.sandbox.proof` | `refunded@<n>d` | The payment lands, then is refunded in full on day n of the window, so every share reverses. | sales: [The money](https://services.dev/docs/examples/sales/money.md#when-it-reverses), [Outcomes](https://services.dev/docs/money/outcomes.md) |
| `metadata.sandbox.proof` | `refunded:<amount>@<n>d` | The payment lands, then that amount is refunded on day n, so every share moves pro rata. | [Outcomes](https://services.dev/docs/money/outcomes.md), sales: [Every branch](https://services.dev/docs/examples/sales/branches.md) |
| `metadata.sandbox.proof` | `tail@<n>d` | The job is ended lost, then the same account pays n days later, inside the tail: won by the tail, charged once. | [Outcomes](https://services.dev/docs/money/outcomes.md), sales: [Every branch](https://services.dev/docs/examples/sales/branches.md) |
| `metadata.sandbox.proof` | `unpaid@<n>d` | The won job's payment never lands, so at n days the outcome lapses and nothing is charged. | sales: [Every branch](https://services.dev/docs/examples/sales/branches.md) |
| `metadata.sandbox.outside` | `ack` | The simulated outside system accepts every submission. The default. | legal: [Every branch](https://services.dev/docs/examples/legal/branches.md), lingua: [lingua](https://services.dev/docs/examples/lingua.md) |
| `metadata.sandbox.outside` | `reject_once` | It rejects the job's first submission with the code reject_once, so the repair the code names runs. | [File it somewhere](https://services.dev/docs/grow/submit.md), [All four, in one filing](https://services.dev/docs/grow/together.md), ['Asks: a ceremony without an account'](https://services.dev/docs/service/ask.md), [Sending to outside systems](https://services.dev/docs/service/submit.md), legal: [Every branch](https://services.dev/docs/examples/legal/branches.md), lingua: [lingua](https://services.dev/docs/examples/lingua.md) |
| `metadata.sandbox.outside` | `never` | It never answers, so the wait passes on the clock and the fallback runs. | [All four, in one filing](https://services.dev/docs/grow/together.md), [Propose, then the gate commits](https://services.dev/docs/service/gate.md), [Sending to outside systems](https://services.dev/docs/service/submit.md), lingua: [lingua](https://services.dev/docs/examples/lingua.md), tax: [Every branch](https://services.dev/docs/examples/tax/branches.md) |
| `metadata.sandbox.outside` | `alerts` | It accepts every submission with an alert, so an accepted-with-alerts receipt releases the charge. | [All four, in one filing](https://services.dev/docs/grow/together.md), legal: [Every branch](https://services.dev/docs/examples/legal/branches.md), lingua: [lingua](https://services.dev/docs/examples/lingua.md) |
| `metadata.sandbox.outside` | `{ reject: [<code>, …] }` | It rejects the job's first submission with these codes, so the repair a Service routes them to runs; every later one is accepted. | [File it somewhere](https://services.dev/docs/grow/submit.md), [All four, in one filing](https://services.dev/docs/grow/together.md), [deliver](https://services.dev/docs/service/deliver.md), [How a job runs](https://services.dev/docs/start/how-it-runs.md), legal: [Every branch](https://services.dev/docs/examples/legal/branches.md), lingua: [lingua](https://services.dev/docs/examples/lingua.md) |
| `metadata.sandbox.outside` | `{ reject: { '<step>.<element>': [<code>, …] } }` | Per element of a step's `each`: it rejects that element's first submission with these codes, before your submit function or URL is reached; every other submission is answered as it would be. | [Subscriptions and allowances](https://services.dev/docs/money/subscriptions.md), [One submission per element](https://services.dev/docs/service/each.md), [One job per period](https://services.dev/docs/service/periods.md), [Subjects](https://services.dev/docs/service/subject.md), tax: [The owner console](https://services.dev/docs/examples/tax/console.md) |
| `metadata.sandbox.asks` | `{ <step>: <choice> }` | A sandbox party who acts at once takes this choice at that decide step, so each of the Service's choices can run. | [Buyer, client, party](https://services.dev/docs/people/parties.md), ['Asks: a ceremony without an account'](https://services.dev/docs/service/ask.md), [Grants and decisions](https://services.dev/docs/service/grants.md), legal: [Every branch](https://services.dev/docs/examples/legal/branches.md), tax: [Every branch](https://services.dev/docs/examples/tax/branches.md) |
| `metadata.sandbox.asks` | `{ <step>, or <step>.<item>: after <n>d, or waive }` | A sandbox party who acts at once acts on the step's first ask that many days after it opens, on the job's clock, instead; or on one item of its request list, answering every other item at once, and waive waives that item with a reason. A key such as organizer #2 names the step's second ask, such as the one a rejection reopens. | [Subscriptions and allowances](https://services.dev/docs/money/subscriptions.md), [Clocks](https://services.dev/docs/service/clocks.md), [One submission per element](https://services.dev/docs/service/each.md), [One job per period](https://services.dev/docs/service/periods.md), tax: [The owner console](https://services.dev/docs/examples/tax/console.md) |
| `metadata.sandbox.events` | `{ <event>: { at, data } }` | On a subscription: at that time on its clock the sandbox sends the event with that data, as the buyer's systems would through POST /events, so what it routes to mints with no one sending it. A list sends each. | [Subscriptions and allowances](https://services.dev/docs/money/subscriptions.md), [One submission per element](https://services.dev/docs/service/each.md), [One job per period](https://services.dev/docs/service/periods.md), [Subjects](https://services.dev/docs/service/subject.md), tax: [The owner console](https://services.dev/docs/examples/tax/console.md) |
| a watch's url | `https://fails-once.example.test/…` | The first delivery of each event answers 500 and the retry answers 200, so the backoff runs. | legal: [Every branch](https://services.dev/docs/examples/legal/branches.md), lingua: [lingua](https://services.dev/docs/examples/lingua.md) |
| a watch's url | `https://down.example.test/…` | Every delivery fails, retried on the backoff until it gives up; a replay sends them again. | legal: [Every branch](https://services.dev/docs/examples/legal/branches.md), lingua: [lingua](https://services.dev/docs/examples/lingua.md) |
| a watch's url | `https://<any other>.example.test/…` | Every delivery answers 200. | legal: [Every branch](https://services.dev/docs/examples/legal/branches.md), lingua: [lingua](https://services.dev/docs/examples/lingua.md) |
| a member id | `mbr_eligible` | A member who holds every credential the Pool names, everywhere, with coverage in force: eligible for every Task, and the last member a `cascade` offers one to. | [The delivery portal](https://services.dev/docs/app/members.md), [Dates at risk](https://services.dev/docs/operate/dates.md), [Your business](https://services.dev/docs/business.md), [All four, in one filing](https://services.dev/docs/grow/together.md), legal: [Every branch](https://services.dev/docs/examples/legal/branches.md), lingua: [lingua](https://services.dev/docs/examples/lingua.md), tax: [Amended return](https://services.dev/docs/examples/tax/amended-return.md) |
| a member id | `mbr_lapsed_credential` | A member whose credential has lapsed: ineligible, on the credential predicate. | [Coverage in force](https://services.dev/docs/people/pool/coverage.md), [Eligibility](https://services.dev/docs/people/pool/eligibility.md), [Clocks](https://services.dev/docs/service/clocks.md), legal: [Every branch](https://services.dev/docs/examples/legal/branches.md), tax: [Every branch](https://services.dev/docs/examples/tax/branches.md) |
| a member id | `mbr_lapsed_coverage` | A member whose coverage lapsed yesterday: ineligible, on the coverage predicate. | [Coverage in force](https://services.dev/docs/people/pool/coverage.md), [Eligibility](https://services.dev/docs/people/pool/eligibility.md), legal: [Every branch](https://services.dev/docs/examples/legal/branches.md) |
| a member id | `mbr_out_of_region` | A member admitted only in ZZ, a region no job names: ineligible on the region predicate wherever an act needs a region. | [Coverage in force](https://services.dev/docs/people/pool/coverage.md), [Eligibility](https://services.dev/docs/people/pool/eligibility.md), legal: [Every branch](https://services.dev/docs/examples/legal/branches.md) |
| `metadata.sandbox.talk` | `open` | The AI's answer in the job's thread falls in an open class, and goes out at once. The default. | [Talk](https://services.dev/docs/service/talk.md), legal: [Every branch](https://services.dev/docs/examples/legal/branches.md), lingua: [lingua](https://services.dev/docs/examples/lingua.md) |
| `metadata.sandbox.talk` | `advice` | It falls in the Service's first advice class: held, and posted as a Task to talk.adopt's role until a member adopts it. Under posture self it goes out facts only; with no advice row, at once. | [Talk](https://services.dev/docs/service/talk.md), legal: [Every branch](https://services.dev/docs/examples/legal/branches.md) |
| `metadata.sandbox.outcome` | `collects` | The verified outcome collects. | — |
| `metadata.sandbox.outcome` | `refunded` | The outcome is refunded inside its window. | — |
| `metadata.sandbox.brand` | `verified` | The brand's credentials are verified and fresh: the act runs as it would on a live key. | [Credentials the brand holds](https://services.dev/docs/people/brand-credentials.md), [Brand()](https://services.dev/docs/service/brand.md), [Propose, then the gate commits](https://services.dev/docs/service/gate.md), tax: [Every branch](https://services.dev/docs/examples/tax/branches.md) |
| `metadata.sandbox.brand` | `stale` | The brand's credentials are stale, so an order whose act needs one answers brand_unverified and charges nothing. | [Credentials the brand holds](https://services.dev/docs/people/brand-credentials.md), [Brand()](https://services.dev/docs/service/brand.md), [Propose, then the gate commits](https://services.dev/docs/service/gate.md), tax: [Every branch](https://services.dev/docs/examples/tax/branches.md) |

---

- Up: [Your first paid job](https://services.dev/docs.md)
- Previous: [The services.dev CLI](https://services.dev/docs/reference/cli.md)
- Next: [Task verbs](https://services.dev/docs/reference/task-verbs.md)
