{"openapi":"3.1.0","info":{"title":"notjunk agent tools","version":"2026-11-19","summary":"notjunk puts an agent on a spare laptop. It works through your task list day and night, and reaches you with an app on your phone","description":"notjunk puts an agent on a spare laptop. It works through your task list day and night, and reaches you with an app on your phone\n\nThe owner approves payment on Stripe's own page. An agent must not collect, store, or send a card number. start_checkout returns a link for the owner to open.\n\nTrial: 7 days free. The first charge is refunded in full if the owner asks within 14 days. Later monthly charges are refunded for billing mistakes or outages caused by notjunk. The policy is at https://app.notjunk.si/legal#refund. Ask at https://app.notjunk.si/support.\n\nAbout 2011 and newer, 64-bit Intel or AMD, about 4 GB of memory, with SSE4.2. Only classes marked works or works-with-stick are claimed. The stick path erases the disk. Gap, blocked, needs-setting, and out are not a works claim. This is not every computer from the last 15 years.\n\ncpu-x64-2011 (works): Needs SSE4.2 and about 4 GB of memory. A CPU without SSE4.2 is refused. This baseline is claimed. It is not every computer from the last 15 years.\nboot-uefi64 (works): A 64-bit UEFI boot is a known path.\nboot-bios (works): A legacy BIOS PC can run the Windows or Linux command, or start the stick from its boot menu.\ndisk-16g (gap): A 16 GB disk is in scope and not done. Do not say that disk size works.\nboot-ia32 (blocked): 32-bit UEFI, including some older Intel Macs and Bay Trail tablets, is not available.\nwifi-intel (works): The common Intel Wi-Fi path is claimed.\nwifi-realtek (gap): Often needs extra firmware. The guided path is not closed, so this is not claimed as works.\nwifi-broadcom (needs-setting): Needs a guided step. Do not claim a Broadcom BCM43602 connects on its own.\ngpu-intel (works): Claimed. A black screen has a safe-graphics note in the install help.\ngpu-amd (needs-setting): Needs a guided graphics setting. Not a plain boot claim.\ngpu-nvidia (needs-setting): Needs a guided graphics setting. A proprietary NVIDIA driver is not part of this claim.\nmac-pre-t2 (works): Only a 64-bit UEFI Intel Mac in those years is claimed. A 32-bit UEFI Mac is blocked.\nmac-t2 (needs-setting): Needs guided help before it starts from external media. Not a one-click setup.\nmac-apple-silicon (out): Not yet. Outside the 2011 Intel and AMD goal.\nwin-x64 (works-with-stick): The USB stick erases that computer's disk. Copy off anything to keep before it starts.\nlinux-x64 (works): A command on a computer that is already running Linux. It replaces everything on that disk.\nchromebook (out): Not yet, including Intel and AMD Chromebooks.\narm-windows (out): Not in scope. A Surface Pro X is one example.\nemmc-baytrail (blocked): Not available. An SD card is never the install disk.\nwifi-emmc-combo (gap): Not claimed. It waits on the tablet class, which is blocked.\n\nNo MCP server is published. Use the OpenAPI tools. A later change has to add the MCP server and a live device status read.\n\nHuman guide: https://notjunk.si/agents. Product facts: https://notjunk.si/product.json."},"servers":[{"url":"https://notjunk.si"}],"tags":[{"name":"compatibility","description":"Matrix status for one computer. works and works-with-stick are the only claimed paths."},{"name":"purchase","description":"Owner-approved Stripe Checkout. Card numbers are refused."},{"name":"setup","description":"Setup and USB installer steps."},{"name":"device","description":"Pairing steps, and device status which is not implemented on this site yet."}],"paths":{"/api/v1/compatibility":{"post":{"operationId":"check_compatibility","tags":["compatibility"],"summary":"Check one computer against the coverage matrix","description":"Returns works, works-with-stick, needs-setting, gap, blocked, out, or unknown. Only works and works-with-stick are claimed. works-with-stick erases the disk. A gap, blocked, or out result is not a works claim. needs-setting is a guided step, not one-click.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatRequest"}}}},"responses":{"200":{"description":"A verdict plus the matrix.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatAnswer"}}}},"400":{"description":"The body was not a JSON object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/checkout":{"post":{"operationId":"start_checkout","tags":["purchase"],"summary":"Start Stripe Checkout for the owner to approve","description":"Returns a Stripe Checkout URL the owner must open. Do not send a card number, expiry, or CVC. If Stripe is unreachable, the response tells the owner to open the setup page instead. The owner still pays on Stripe's page.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutRequest"}}}},"responses":{"200":{"description":"A Checkout URL for the owner.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutOk"}}}},"400":{"description":"Missing plan, or a card number was sent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many checkout starts from this network.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stripe did not open. The owner can use the setup page.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutUnavailable"}}}}}}},"/api/v1/setup":{"get":{"operationId":"get_setup_steps","tags":["setup"],"summary":"Setup steps after the owner has a plan","description":"The owner picks $19 a month or $190 a year and opens Stripe Checkout. The first 7 days are free. The owner pays on Stripe's page. Do not ask for a card number. After Checkout, a Windows or Linux computer on 64-bit Intel or AMD (UEFI or legacy BIOS) gets one command, and it replaces everything on that computer. A 64-bit UEFI Intel Mac from about 2011 to 2017 can use the stick. A T2 Mac needs a guided setting and is not one-click. The computer shows two words. On the owner's phone, open Enter code at notjunk.si/enter and type those words. They are not sent to this API. Copy off anything to keep before installing. A 16 GB disk and Realtek Wi-Fi are gaps. 32-bit UEFI is blocked. Apple silicon, ARM Windows, and Chromebooks are not yet.","responses":{"200":{"description":"Ordered setup steps.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetupSteps"}}}}}}},"/api/v1/usb":{"post":{"operationId":"create_usb_installer_instructions","tags":["setup"],"summary":"USB installer steps for a spare computer","description":"Steps for writing the public image and starting a spare computer from it. The stick erases that computer's disk. A 16 GB disk and Realtek Wi-Fi are gaps. 32-bit UEFI is blocked. Apple silicon, ARM Windows, and Chromebooks are not yet. Pass a query to run the same check as check_compatibility.","requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsbRequest"}}}},"responses":{"200":{"description":"Installer steps, plus a compatibility verdict when a computer was described.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsbInstructions"}}}}}}},"/api/v1/pair":{"post":{"operationId":"pair_device","tags":["device"],"summary":"How the owner pairs a phone with the computer","description":"Returns the steps. This operation does not accept the two words. The owner types them on their own phone.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Pairing steps for the owner.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PairSteps"}}}},"400":{"description":"The body included the two words or another secret. Do not send those here.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/devices/{id}":{"get":{"operationId":"device_status","tags":["device"],"summary":"Whether a paired computer is online","description":"Not implemented on this site. Always 501. The phone app shows online or offline after pairing. A later API change has to add a real status read. This operation does not take payment.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,64}$"}}],"responses":{"501":{"description":"Status is not available from this site.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","required":["ok","code"],"properties":{"ok":{"type":"boolean","const":false},"code":{"type":"string"},"message":{"type":"string"},"approval":{"type":"string","enum":["owner"]},"url":{"type":"string"}}},"CompatRequest":{"type":"object","properties":{"query":{"type":"string","description":"Make, model and year, such as Dell Latitude E7450 2015."},"make":{"type":"string"},"model":{"type":"string"},"year":{"type":"integer"},"arch":{"type":"string","description":"x64, amd64, ia32, or arm64."},"uefi":{"type":"string","description":"64 or 32."},"secureBoot":{"type":"string","description":"on, off, or unknown."}}},"CompatAnswer":{"type":"object","required":["ok","verdict","promise","everyComputer","reason","matrix"],"properties":{"ok":{"type":"boolean","const":true},"verdict":{"type":"string","enum":["works","works-with-stick","needs-setting","gap","blocked","out","unknown"]},"promise":{"type":"boolean","const":false},"everyComputer":{"type":"boolean","const":false},"reason":{"type":"string"},"year":{"type":["integer","null"]},"matrix":{"type":"object"}}},"CheckoutRequest":{"type":"object","required":["plan"],"properties":{"plan":{"type":"string","enum":["month","year"]}},"additionalProperties":false},"CheckoutOk":{"type":"object","required":["ok","approval","url","plan"],"properties":{"ok":{"type":"boolean","const":true},"approval":{"type":"string","const":"owner"},"plan":{"type":"string","enum":["month","year"]},"url":{"type":"string","description":"https://checkout.stripe.com/… for the owner to open."},"trialDays":{"type":"integer"},"message":{"type":"string"}}},"CheckoutUnavailable":{"type":"object","required":["ok","code","approval","url"],"properties":{"ok":{"type":"boolean","const":false},"code":{"type":"string","const":"checkout_unavailable"},"approval":{"type":"string","const":"owner"},"url":{"type":"string","description":"The setup page, where the owner can start Checkout."},"message":{"type":"string"}}},"SetupSteps":{"type":"object","required":["ok","steps"],"properties":{"ok":{"type":"boolean"},"steps":{"type":"array","items":{"type":"string"}},"setupUrl":{"type":"string"},"compatibility":{"type":"string"}}},"UsbRequest":{"type":"object","properties":{"os":{"type":"string","enum":["mac","linux","windows"]},"query":{"type":"string"}}},"UsbInstructions":{"type":"object","required":["ok","steps","erasesDisk"],"properties":{"ok":{"type":"boolean"},"erasesDisk":{"type":"boolean","const":true},"steps":{"type":"array","items":{"type":"string"}},"installUrl":{"type":"string"},"image":{"type":"object"},"compatibility":{"type":"object","description":"Present when the body described a computer."}}},"PairSteps":{"type":"object","required":["ok","status","steps","enterUrl"],"properties":{"ok":{"type":"boolean"},"status":{"type":"string","const":"owner_action"},"steps":{"type":"array","items":{"type":"string"}},"enterUrl":{"type":"string"}}}}}}