Objects

16 objects. Every id a brand hands out starts with its object's prefix. Every object carries the same envelope, and a yes marks each envelope field it carries.

Each object: its fields, then the object as a brand serves it. A field marked ? can be left out.

The envelope#

What these fields mean, on every object that carries them:

job#

The canonical job, mid-flight and as a buyer reads it: waiting, on signature, its payment held. Each of its 4 steps is a step object.

The status narrows the rest: waiting adds on and waiting, delivered and accepted add output and final_at, canceled adds reason, and ended adds end and output. A buyer never reads record: their surfaces strip it, and expand[]=timeline adds timeline.

$ curl http://localhost:8787/jobs/job_7Hq3   # input, price and next left out; a buyer never reads the record
{
  "id": "job_7Hq3",

step#

A step run on a job.

task#

A Task: a role step a Pool fills, at a fee fixed at post, open, held, claimed and done.

A member reads a Task as its teaser until it is theirs: fields holds only what the Pool’s sees.teaser names, never a party. The sheet, the packet and the owner’s read are the same Task with more: The packet below, and GET /owner/tasks/:id.

→ GET /reviews/tsk_7Hq2   # as mbr_eligible: the teaser
{
  "id": "tsk_7Hq2",

ask#

An ask: a party acts through its hosted, single-use link.

$ curl http://localhost:8787/asks/ask_7Hq2
{
  "id": "ask_7Hq2",

subject#

A subject: what outlives the job, keyed by an input or a receipt, with its jobs, its history, its kept facts, its periods and who is of record.

→ GET /subjects/sbj_7Hq2
{
  "id": "sbj_7Hq2",

clock#

A clock: a date the world sets on a job or its subject, who answers for it, its rungs, what moves it and the owner's choice at the end. Its owner acknowledges it, satisfies it on evidence and chooses at its date.

$ npx services.dev clocks get clk_7Hq2 --json
{
  "id": "clk_7Hq2",

subscription#

A subscription: standing work charged once per cycle, its schedule and events minting jobs that share its subject and policy, and its allowances used and included, reset at renewal.

$ curl http://localhost:8787/subscriptions/sbn_7Hq2
{
  "id": "sbn_7Hq2",

event#

An event: one record fact in the brand's ordered feed, with its seq, as its audience sees it.

$ npx services.dev events list after=0 limit=2
{
  "type": "OK",

watch#

A watch: a webhook endpoint, with its whsec_ secret, its events and its deliveries.

$ npx services.dev watches create https://hooks.example.test/lingua events=job.delivered
{
  "id": "wh_1rKV5VS8V3",

member#

A member: a person in a Pool, their application, what the verifier wrote and their availability; never their ledger.

verified is the verifier’s latest write, read against the clock now: each write replaces the last, and fresh turns false past the Pool’s fresh. Verify a member walks it.

→ POST /attorneys/join {"email":"grace@hopper.example","answers":{"name":"Grace Hopper","credential":"patent agent","number":"71,234","regions":["US-CA"],"areas":["patents"],"hours":10,"turnaround":"24h","min_fee":120}}   # the applicant, in one call
{
  "id": "mbr_7Hq2",

receipt#

An outside receipt: a submission's status, codes, number and file.

$ curl -s http://localhost:8787/jobs/job_7Hq2 | jq '.receipts[0]'
{
  "id": "rcp_7Hq2",

test_clock#

A test clock: the time every job on it reads, frozen until advanced, only ever forward. Moving one backward answers 409 test_clock_backward, and deleting one voids every job on it.

Objects a call answers with that carry no id of their own: what a member reads and signs, what the gate freezes, what a buyer is offered, and where a refusal’s rule sits.

packet#

What a member reads once they claimed and cleared a Task, and what their attestation binds: the AI’s artifacts with their versions and what changed, the review reports, the client’s answers, the checklist, the record, the signals, the clock and the hash.

→ GET /reviews/tsk_7Hq2/packet   # as mbr_eligible: the packet
{
  "object": "packet",

Explained in The packet, What a person can do.

attestation#

What the gate freezes on the record when a person attests: who, the credential the verifier holds for them, the region, the hash of what they signed, the rules version the job pinned, and the checklist they affirmed.

Explained in What a person can do, Rules: how a Service meets licensing by design.

offer#

A buyer’s answer when the price is over their max or their key’s cap: the price, its sentence and terms, and the exact next call.

$ curl -X POST http://localhost:8787/jobs -H 'content-type: application/json' -d '{"service":"certified-translation","document":{"url":"https://example.com/lease.pdf","name":"lease.pdf"},"to":"fr","country":"FR","max_usd":189,"key":"lease-fr-3"}'
← 402 · {
  "type": "OFFER",

Explained in 'Answers: OK, EMPTY, OFFER, BLOCKED'.

rule_ref#

Where a refusal’s rule sits: the rules table’s version, the row, the position counsel gives for it, and what the row cites.

→ POST /matters {"service":"litigate","max_usd":500,"key":"sue-initech"}
{
  "type": "BLOCKED",

Explained in Rules: how a Service meets licensing by design, Refusals and cures.