[{"data":1,"prerenderedAt":1617},["ShallowReactive",2],{"navigation":3,"page:\u002Fgetting-started":1019,"surround:\u002Fgetting-started":1613},[4,21,82,133,154,1010],[5,6,7,8],"Getting started","\u002Fgetting-started","i-lucide-rocket",[9,12,15,18],[10,6,11,11],"What Kaabist is",0,[13,14,11,11],"API keys and modes","keys-and-modes",[16,17,11,11],"Your first job","first-job",[19,20,11,11],"Understanding the envelope","envelope",[22,23,24,25],"Concepts","\u002Fconcepts","i-lucide-book-open",[26,28,31,34,37,40,43,46,49,52,55,58,61,64,67,70,73,76,79],[27,23,11,11],"Overview",[29,30,11,11],"Programs and versions","programs-and-versions",[32,33,11,11],"Tiers and escalation","tiers-and-escalation",[35,36,11,11],"The http tier","http-tier",[38,39,11,11],"The browser tier","browser-tier",[41,42,11,11],"Sessions","sessions",[44,45,11,11],"Human in the loop","human-in-the-loop",[47,48,11,11],"How healing works","self-healing",[50,51,11,11],"Obstacles and captchas","obstacles",[53,54,11,11],"Validation and warnings","validation-and-warnings",[56,57,11,11],"Credits and billing","credits-and-billing",[59,60,11,11],"Limits","limits",[62,63,11,11],"Locators","locators",[65,66,11,11],"Snapshots","snapshots",[68,69,11,11],"Egress and proxies","egress-and-proxies",[71,72,11,11],"Queueing and fairness","queueing",[74,75,11,11],"Accounts, organisations and roles","accounts-and-roles",[77,78,11,11],"Data retention","data-retention",[80,81,11,11],"Documents and PDFs","documents-and-pdfs",[83,84,85,86],"Guides","\u002Fguides","i-lucide-map",[87,88,91,94,97,100,103,106,109,112,115,118,121,124,127,130],[27,84,11,11],[89,90,11,11],"Authenticated flows","authenticated-flows",[92,93,11,11],"Hosted resolve pages","hosted-resolve",[95,96,11,11],"Lists and pagination","lists-and-pagination",[98,99,11,11],"JSON and network locators","json-and-network-locators",[101,102,11,11],"Schedules and change detection","schedules-and-change-detection",[104,105,11,11],"Webhooks","webhooks",[107,108,11,11],"Bring your own providers","byo-providers",[110,111,11,11],"Testing: replay, dry-run and test mode","testing",[113,114,11,11],"Side-effect safety","side-effect-safety",[116,117,11,11],"Security & data handling","security-and-data",[119,120,11,11],"Migrating from other tools","migrating",[122,123,11,11],"Drift detection and canaries","drift-and-canaries",[125,126,11,11],"SDKs","sdks",[128,129,11,11],"The kaab CLI","cli",[131,132,11,11],"Coding agents (MCP)","mcp",[134,135,136,137],"Panel","\u002Fpanel","i-lucide-layout-dashboard",[138,139,142,145,148,151],[27,135,11,11],[140,141,11,11],"The program builder","builder",[143,144,11,11],"Picking and recording","picking-and-recording",[146,147,11,11],"Taking over a job","takeover",[149,150,11,11],"Getting help","support",[152,153,11,11],"Referrals","referrals",[155,156,157,158],"Reference","\u002Freference","i-lucide-library",[159,160,520,834,837,840,1006,1007],[27,156,11,11],[161,162,11,163],"API","api",[164,166,169,212,222,274,297,316,347,376,389,396,403,410,426,447,454],[27,165,11,11],"\u002Freference\u002Fapi",[167,168,11,11],"Interactive reference","explorer",[170,171,11,172],"Jobs","jobs",[173,176,179,182,185,188,191,194,197,200,203,206,209],[174,175,11,11],"Create job","create-job",[177,178,11,11],"List jobs","list-jobs",[180,181,11,11],"Create job batch","create-job-batch",[183,184,11,11],"Estimate job","estimate-job",[186,187,11,11],"Get job","get-job",[189,190,11,11],"List job steps","list-job-steps",[192,193,11,11],"Get job snapshot","get-job-snapshot",[195,196,11,11],"Get job screenshot","get-job-screenshot",[198,199,11,11],"Get job artifact","get-job-artifact",[201,202,11,11],"Submit job input","submit-job-input",[204,205,11,11],"Resume job","resume-job",[207,208,11,11],"Takeover job","takeover-job",[210,211,11,11],"Cancel job","cancel-job",[213,214,11,215],"Batches","batches",[216,219],[217,218,11,11],"Get batch","get-batch",[220,221,11,11],"List batch jobs","list-batch-jobs",[223,224,11,225],"Programs","programs",[226,229,232,235,238,241,244,247,250,253,256,259,262,265,268,271],[227,228,11,11],"Create program","create-program",[230,231,11,11],"List programs","list-programs",[233,234,11,11],"Lint program","lint-program",[236,237,11,11],"Get program","get-program",[239,240,11,11],"Update program","update-program",[242,243,11,11],"Delete program","delete-program",[245,246,11,11],"List program versions","list-program-versions",[248,249,11,11],"Create program version","create-program-version",[251,252,11,11],"Update program version","update-program-version",[254,255,11,11],"Delete program version","delete-program-version",[257,258,11,11],"Get program version","get-program-version",[260,261,11,11],"Publish program version","publish-program-version",[263,264,11,11],"Diff program version","diff-program-version",[266,267,11,11],"Replay program version","replay-program-version",[269,270,11,11],"Set program alias","set-program-alias",[272,273,11,11],"Delete program alias","delete-program-alias",[41,42,11,275],[276,279,282,285,288,291,294],[277,278,11,11],"Create session","create-session",[280,281,11,11],"List sessions","list-sessions",[283,284,11,11],"Get session","get-session",[286,287,11,11],"Update session","update-session",[289,290,11,11],"Delete session","delete-session",[292,293,11,11],"Verify session","verify-session",[295,296,11,11],"Refresh session","refresh-session",[298,299,11,300],"Proposals","proposals",[301,304,307,310,313],[302,303,11,11],"List proposals","list-proposals",[305,306,11,11],"Get proposal","get-proposal",[308,309,11,11],"Approve proposal","approve-proposal",[311,312,11,11],"Reject proposal","reject-proposal",[314,315,11,11],"Edit proposal","edit-proposal",[317,318,11,319],"Schedules","schedules",[320,323,326,329,332,335,338,341,344],[321,322,11,11],"Create schedule","create-schedule",[324,325,11,11],"List schedules","list-schedules",[327,328,11,11],"Get schedule","get-schedule",[330,331,11,11],"Update schedule","update-schedule",[333,334,11,11],"Delete schedule","delete-schedule",[336,337,11,11],"Pause schedule","pause-schedule",[339,340,11,11],"Resume schedule","resume-schedule",[342,343,11,11],"List schedule runs","list-schedule-runs",[345,346,11,11],"Get schedule run diff","get-schedule-run-diff",[104,105,11,348],[349,352,355,358,361,364,367,370,373],[350,351,11,11],"Create webhook","create-webhook",[353,354,11,11],"List webhooks","list-webhooks",[356,357,11,11],"Get webhook","get-webhook",[359,360,11,11],"Update webhook","update-webhook",[362,363,11,11],"Delete webhook","delete-webhook",[365,366,11,11],"Rotate webhook secret","rotate-webhook-secret",[368,369,11,11],"List webhook deliveries","list-webhook-deliveries",[371,372,11,11],"Resend webhook delivery","resend-webhook-delivery",[374,375,11,11],"Test webhook","test-webhook",[377,378,11,379],"Organisation","org",[380,383,386],[381,382,11,11],"Rotate org webhook secret","rotate-org-webhook-secret",[384,385,11,11],"Get org","get-org",[387,388,11,11],"Request data deletion","request-data-deletion",[390,391,11,392],"Credits","credits",[393],[394,395,11,11],"Get credits","get-credits",[397,398,11,399],"Ledger","ledger",[400],[401,402,11,11],"List ledger entries","list-ledger-entries",[404,405,11,406],"Usage","usage",[407],[408,409,11,11],"Get usage","get-usage",[411,412,11,413],"API keys","api-keys",[414,417,420,423],[415,416,11,11],"List API keys","list-api-keys",[418,419,11,11],"Create API key","create-api-key",[421,422,11,11],"Rotate API key","rotate-api-key",[424,425,11,11],"Revoke API key","revoke-api-key",[427,108,11,428],"BYO providers",[429,432,435,438,441,444],[430,431,11,11],"List BYO providers","list-byo-providers",[433,434,11,11],"Create BYO provider","create-byo-provider",[436,437,11,11],"Get BYO provider","get-byo-provider",[439,440,11,11],"Update BYO provider","update-byo-provider",[442,443,11,11],"Delete BYO provider","delete-byo-provider",[445,446,11,11],"Test BYO provider","test-byo-provider",[448,449,11,450],"Sites","sites",[451],[452,453,11,11],"Get site profile","get-site-profile",[455,456,11,457],"Objects","schemas",[458,460,463,466,469,470,473,476,479,482,485,487,490,493,496,499,502,505,508,511,514,517],[27,459,11,11],"\u002Freference\u002Fapi\u002Fschemas",[461,462,11,11],"ApiKey","api-key",[464,465,11,11],"Batch","batch",[467,468,11,11],"ByoProvider","byo-provider",[390,391,11,11],[471,472,11,11],"ErrorResponse","error-response",[474,475,11,11],"ExtractSchema","extract-schema",[477,478,11,11],"Job","job",[480,481,11,11],"LedgerEntry","ledger-entry",[483,484,11,11],"LintResult","lint-result",[486,378,11,11],"Org",[488,489,11,11],"Program","program",[491,492,11,11],"ProgramDefinition","program-definition",[494,495,11,11],"ProgramVersion","program-version",[497,498,11,11],"Proposal","proposal",[500,501,11,11],"Schedule","schedule",[503,504,11,11],"Session","session",[506,507,11,11],"SiteProfile","site-profile",[509,510,11,11],"StepRecord","step-record",[512,513,11,11],"Webhook","webhook",[515,516,11,11],"WebhookDelivery","webhook-delivery",[518,519,11,11],"WebhookEvent","webhook-event",[521,522,11,523],"DSL","dsl",[524,526,529,532,535,538,603,637,640,751,754,756],[27,525,11,11],"\u002Freference\u002Fdsl",[527,528,11,11],"Inputs","inputs",[530,531,11,11],"Options","options",[533,534,11,11],"Policies","policies",[536,537,11,11],"Steps","steps",[539,540,11,541],"Actions","actions",[542,544,546,548,550,552,554,556,558,560,562,565,568,570,573,575,577,579,582,585,587,589,591,594,596,598,600],[27,543,11,11],"\u002Freference\u002Fdsl\u002Factions",[545,545,11,11],"fill",[547,547,11,11],"click",[549,549,11,11],"press",[551,551,11,11],"hover",[553,553,11,11],"select",[555,555,11,11],"check",[557,557,11,11],"uncheck",[559,559,11,11],"upload",[561,561,11,11],"scroll",[563,564,11,11],"wait_for","wait-for",[566,567,11,11],"set_session","set-session",[569,569,11,11],"extract",[571,572,11,11],"capture_response","capture-response",[574,574,11,11],"evaluate",[576,576,11,11],"paginate",[578,578,11,11],"download",[580,581,11,11],"read_pdf","read-pdf",[583,584,11,11],"set_vars","set-vars",[586,586,11,11],"sleep",[588,588,11,11],"reload",[590,590,11,11],"goto",[592,593,11,11],"await_input","await-input",[595,595,11,11],"checkpoint",[597,597,11,11],"screenshot",[599,599,11,11],"when",[601,602,11,11],"loop_until","loop-until",[604,605,11,606],"Conditions","conditions",[607,609,611,613,615,617,619,621,623,625,627,629,631,633,635],[27,608,11,11],"\u002Freference\u002Fdsl\u002Fconditions",[610,610,11,11],"url",[612,612,11,11],"title",[614,614,11,11],"visible",[616,616,11,11],"hidden",[618,618,11,11],"exists",[620,620,11,11],"absent",[622,622,11,11],"text",[624,624,11,11],"count",[626,626,11,11],"network",[628,628,11,11],"var",[630,630,11,11],"landmark",[632,632,11,11],"all",[634,634,11,11],"any",[636,636,11,11],"not",[638,639,11,11],"Targets","targets",[641,642,11,643],"Fields","fields",[644,646,649,651,654,656,659,661,663,666,668,671,672,674,677,679,681,683,685,687,690,693,695,698,701,703,704,707,709,712,714,716,718,720,722,724,726,728,731,733,734,736,738,740,743,745,747,749],[27,645,11,11],"\u002Freference\u002Fdsl\u002Ffields",[647,648,11,11],"allow_suffix","allow-suffix",[650,650,11,11],"attr",[652,653,11,11],"base_url","base-url",[655,655,11,11],"candidates",[657,658,11,11],"case_insensitive","case-insensitive",[660,660,11,11],"country",[662,662,11,11],"currency",[664,665,11,11],"date_format","date-format",[667,667,11,11],"decimal",[669,670,11,11],"false_values","false-values",[642,642,11,11],[673,673,11,11],"flags",[675,676,11,11],"follow_redirects","follow-redirects",[678,678,11,11],"frame",[680,680,11,11],"json",[682,682,11,11],"locale",[684,684,11,11],"many",[686,686,11,11],"max",[688,689,11,11],"max_items","max-items",[691,692,11,11],"max_length","max-length",[694,694,11,11],"min",[696,697,11,11],"min_items","min-items",[699,700,11,11],"min_length","min-length",[702,702,11,11],"name",[626,626,11,11],[705,706,11,11],"null_markers","null-markers",[708,708,11,11],"nullable",[710,711,11,11],"on_invalid","on-invalid",[713,713,11,11],"pattern",[715,715,11,11],"presence",[717,717,11,11],"regex",[719,719,11,11],"required",[721,721,11,11],"role",[723,723,11,11],"sample",[725,725,11,11],"selector",[727,727,11,11],"source",[729,730,11,11],"strip_fragment","strip-fragment",[732,732,11,11],"testid",[622,622,11,11],[735,735,11,11],"thousands",[737,737,11,11],"timezone",[739,739,11,11],"transforms",[741,742,11,11],"true_values","true-values",[744,744,11,11],"type",[746,746,11,11],"unique",[748,748,11,11],"values",[750,750,11,11],"xpath",[752,753,11,11],"Assertions","assertions",[755,739,11,11],"Transforms",[757,758,11,759],"Lint codes","lint",[760,762,765,768,771,774,777,780,783,786,789,792,795,798,801,804,807,810,813,816,819,822,825,828,831],[27,761,11,11],"\u002Freference\u002Fdsl\u002Flint",[763,764,11,11],"E001","e001",[766,767,11,11],"E002","e002",[769,770,11,11],"E003","e003",[772,773,11,11],"E004","e004",[775,776,11,11],"E005","e005",[778,779,11,11],"E006","e006",[781,782,11,11],"E007","e007",[784,785,11,11],"E008","e008",[787,788,11,11],"E009","e009",[790,791,11,11],"E010","e010",[793,794,11,11],"E011","e011",[796,797,11,11],"E012","e012",[799,800,11,11],"E013","e013",[802,803,11,11],"E014","e014",[805,806,11,11],"W001","w001",[808,809,11,11],"W002","w002",[811,812,11,11],"W003","w003",[814,815,11,11],"W004","w004",[817,818,11,11],"W005","w005",[820,821,11,11],"W006","w006",[823,824,11,11],"W007","w007",[826,827,11,11],"W008","w008",[829,830,11,11],"W009","w009",[832,833,11,11],"W010","w010",[835,836,11,11],"Codes","codes",[838,839,11,11],"Events","events",[841,129,11,842],"CLI",[843,845,847,850,853,856,859,862,865,868,871,874,877,880,883,886,889,892,895,898,901,904,907,910,913,916,919,922,925,928,931,934,937,940,943,946,949,952,955,958,961,964,967,970,973,976,979,982,985,988,991,994,997,1000,1003],[27,844,11,11],"\u002Freference\u002Fcli",[846,846,11,11],"kaab",[848,849,11,11],"kaab auth","kaab-auth",[851,852,11,11],"kaab auth login","kaab-auth-login",[854,855,11,11],"kaab auth logout","kaab-auth-logout",[857,858,11,11],"kaab auth status","kaab-auth-status",[860,861,11,11],"kaab completion","kaab-completion",[863,864,11,11],"kaab completion bash","kaab-completion-bash",[866,867,11,11],"kaab completion fish","kaab-completion-fish",[869,870,11,11],"kaab completion powershell","kaab-completion-powershell",[872,873,11,11],"kaab completion zsh","kaab-completion-zsh",[875,876,11,11],"kaab credits","kaab-credits",[878,879,11,11],"kaab jobs","kaab-jobs",[881,882,11,11],"kaab jobs cancel","kaab-jobs-cancel",[884,885,11,11],"kaab jobs get","kaab-jobs-get",[887,888,11,11],"kaab jobs input","kaab-jobs-input",[890,891,11,11],"kaab jobs list","kaab-jobs-list",[893,894,11,11],"kaab jobs resume","kaab-jobs-resume",[896,897,11,11],"kaab jobs run","kaab-jobs-run",[899,900,11,11],"kaab jobs snapshot","kaab-jobs-snapshot",[902,903,11,11],"kaab jobs steps","kaab-jobs-steps",[905,906,11,11],"kaab jobs takeover","kaab-jobs-takeover",[908,909,11,11],"kaab open","kaab-open",[911,912,11,11],"kaab open job","kaab-open-job",[914,915,11,11],"kaab programs","kaab-programs",[917,918,11,11],"kaab programs alias","kaab-programs-alias",[920,921,11,11],"kaab programs alias set","kaab-programs-alias-set",[923,924,11,11],"kaab programs diff","kaab-programs-diff",[926,927,11,11],"kaab programs lint","kaab-programs-lint",[929,930,11,11],"kaab programs list","kaab-programs-list",[932,933,11,11],"kaab programs pull","kaab-programs-pull",[935,936,11,11],"kaab programs push","kaab-programs-push",[938,939,11,11],"kaab proposals","kaab-proposals",[941,942,11,11],"kaab proposals approve","kaab-proposals-approve",[944,945,11,11],"kaab proposals list","kaab-proposals-list",[947,948,11,11],"kaab proposals reject","kaab-proposals-reject",[950,951,11,11],"kaab proposals show","kaab-proposals-show",[953,954,11,11],"kaab schedules","kaab-schedules",[956,957,11,11],"kaab schedules create","kaab-schedules-create",[959,960,11,11],"kaab schedules list","kaab-schedules-list",[962,963,11,11],"kaab schedules pause","kaab-schedules-pause",[965,966,11,11],"kaab schedules resume","kaab-schedules-resume",[968,969,11,11],"kaab schedules runs","kaab-schedules-runs",[971,972,11,11],"kaab sessions","kaab-sessions",[974,975,11,11],"kaab sessions create","kaab-sessions-create",[977,978,11,11],"kaab sessions delete","kaab-sessions-delete",[980,981,11,11],"kaab sessions list","kaab-sessions-list",[983,984,11,11],"kaab sessions verify","kaab-sessions-verify",[986,987,11,11],"kaab usage","kaab-usage",[989,990,11,11],"kaab version","kaab-version",[992,993,11,11],"kaab webhooks","kaab-webhooks",[995,996,11,11],"kaab webhooks create","kaab-webhooks-create",[998,999,11,11],"kaab webhooks deliveries","kaab-webhooks-deliveries",[1001,1002,11,11],"kaab webhooks list","kaab-webhooks-list",[1004,1005,11,11],"kaab webhooks test","kaab-webhooks-test",[125,126,11,11],[1008,1009,11,11],"Plans and pricing","plans",[1011,1012,1013,1014],"Changelog","\u002Fchangelog","i-lucide-history",[1015,1016],[27,1012,11,11],[1017,1018,11,11],"Deprecations","deprecations",{"id":1020,"title":10,"body":1021,"breaking":1604,"date":1605,"description":1606,"extension":1607,"generated":1604,"meta":1608,"navigation":1609,"path":6,"seo":1610,"stem":1611,"version":1605,"__hash__":1612},"docs\u002F1.getting-started\u002F01.index.md",{"type":1022,"value":1023,"toc":1588},"minimark",[1024,1028,1033,1036,1039,1043,1046,1096,1105,1107,1146,1150,1168,1172,1201,1205,1215,1217,1235,1239,1262,1266,1269,1393,1409,1456,1467,1471,1495,1506,1510,1552,1555,1584],[1025,1026,1027],"p",{},"Kaabist runs automation programs against websites and returns what they found as typed JSON, through one API. It is built for the flows that break ordinary scrapers: logins with a one-time code, pages that render in JavaScript, dialogs in the way, markup that changes overnight, and steps that place an order and must never run twice.",[1029,1030,1032],"h2",{"id":1031},"when-to-use-it","When to use it",[1025,1034,1035],{},"Use Kaabist when a program has to keep working against a site you do not control: reading a price list every hour, exporting a report from a portal behind a login, filling a form on a schedule. Reading one public page is the entry-level case and costs one request; the same API carries the twenty-step flow behind a sign-in.",[1025,1037,1038],{},"Kaabist is not a crawler. It runs the steps you describe on the pages you name; it does not discover links and follow them on its own.",[1029,1040,1042],{"id":1041},"the-model","The model",[1044,1045,29],"h3",{"id":30},[1025,1047,1048,1049,1052,1053,1056,1057,1059,1060,1062,1063,1062,1065,1062,1067,1062,1069,1071,1072,1074,1075,1078,1079,1082,1083,1086,1087,1090,1091,1095],{},"A ",[1050,1051,489],"strong",{}," is a JSON document: typed ",[1054,1055,528],"code",{},", ordered ",[1054,1058,537],{}," (",[1054,1061,590],{},", ",[1054,1064,545],{},[1054,1066,547],{},[1054,1068,592],{},[1054,1070,569],{}," and so on), an ",[1054,1073,569],{}," schema that says what data to return, and policies. Each saved change is a new ",[1050,1076,1077],{},"program version",", and a version never changes once it is published. ",[1050,1080,1081],{},"Aliases"," such as ",[1054,1084,1085],{},"latest"," and ",[1054,1088,1089],{},"production"," point at versions, so you can publish version 4 and keep production on version 3 until you are ready. See ",[1092,1093,29],"a",{"href":1094},"\u002Fconcepts\u002Fprograms-and-versions",".",[1025,1097,1098,1099,1101,1102,1104],{},"A request that sends a URL and an extract schema instead of a program name is the same thing: it compiles to a two-step program (",[1054,1100,590],{},", then ",[1054,1103,569],{},") and runs through the same engine.",[1044,1106,170],{"id":171},[1025,1108,1048,1109,1111,1112,1115,1116,1119,1120,1062,1123,1062,1126,1062,1129,1062,1132,1062,1135,1138,1139,1142,1143,1095],{},[1050,1110,478],{}," is one run of one program version with one set of inputs. You create it with ",[1054,1113,1114],{},"POST \u002Fv1\u002Fjobs"," and read it back as one envelope whose keys depend on its ",[1054,1117,1118],{},"status",": ",[1054,1121,1122],{},"queued",[1054,1124,1125],{},"running",[1054,1127,1128],{},"awaiting_input",[1054,1130,1131],{},"needs_attention",[1054,1133,1134],{},"succeeded",[1054,1136,1137],{},"failed"," or ",[1054,1140,1141],{},"canceled",". See ",[1092,1144,19],{"href":1145},"\u002Fgetting-started\u002Fenvelope",[1044,1147,1149],{"id":1148},"tiers","Tiers",[1025,1151,1152,1153,1156,1157,1160,1161,1164,1165,1095],{},"Kaabist fetches a page in one of three ways, cheapest first: ",[1054,1154,1155],{},"http"," (one request, no browser), ",[1054,1158,1159],{},"browser"," (a real Chromium) and ",[1054,1162,1163],{},"stealth"," (a hardened browser on a residential address). A job starts as low as its program allows, moves up when the page needs more, and Kaabist remembers what each site needed. See ",[1092,1166,32],{"href":1167},"\u002Fconcepts\u002Ftiers-and-escalation",[1044,1169,1171],{"id":1170},"parking","Parking",[1025,1173,1174,1175,1178,1179,1181,1182,1184,1185,1187,1188,1062,1191,1138,1194,1197,1198,1095],{},"When a job needs a person, it ",[1050,1176,1177],{},"parks"," instead of failing. A planned park is ",[1054,1180,1128],{},": an ",[1054,1183,592],{}," step asked for a one-time code. An unplanned park is ",[1054,1186,1131],{},", with a reason such as ",[1054,1189,1190],{},"drift",[1054,1192,1193],{},"obstacle",[1054,1195,1196],{},"session_expired",", a screenshot and, where Kaabist has one, a proposed fix. You answer with the API, from the panel, or by sending your own end user a hosted page. See ",[1092,1199,44],{"href":1200},"\u002Fconcepts\u002Fhuman-in-the-loop",[1044,1202,1204],{"id":1203},"healing","Healing",[1025,1206,1207,1208,1210,1211,1095],{},"Every field in a program keeps several locators and a record of what it matched when you confirmed it. When the page changes and the locator stops matching, Kaabist looks for the element that took its place. A confident match is used for that job only; a change to your program is always a ",[1050,1209,498],{}," you approve. See ",[1092,1212,1214],{"href":1213},"\u002Fconcepts\u002Fself-healing","Self-healing",[1044,1216,113],{"id":114},[1025,1218,1219,1220,1223,1224,1227,1228,1231,1232,1095],{},"A step marked ",[1054,1221,1222],{},"side_effect: true"," (placing an order, sending a message) runs behind a fence: Kaabist records that it is about to run before acting and that it ran after its ",[1054,1225,1226],{},"expect"," holds. A step that was started and never confirmed is never run again automatically; the job parks as ",[1054,1229,1230],{},"side_effect_ambiguous"," for a person to decide. See ",[1092,1233,113],{"href":1234},"\u002Fguides\u002Fside-effect-safety",[1029,1236,1238],{"id":1237},"the-sites-in-these-docs","The sites in these docs",[1025,1240,1241,1242,1245,1246,1249,1250,1253,1254,1257,1258,1261],{},"The worked examples in these docs target fictional sites under the reserved ",[1054,1243,1244],{},"example.com"," domain, each standing for one kind of real-world behaviour: a server-rendered shop (",[1054,1247,1248],{},"https:\u002F\u002Fshop.example.com","), a single-page app that draws its content from a JSON API (",[1054,1251,1252],{},"https:\u002F\u002Fapp.example.com","), a login with a one-time code (",[1054,1255,1256],{},"https:\u002F\u002Fportal.example.com",") and a non-idempotent order form (",[1054,1259,1260],{},"https:\u002F\u002Fcheckout.example.com","). They show the shape of each request and result; to run one, point it at a site of your own.",[1029,1263,1265],{"id":1264},"worked-example","Worked example",[1025,1267,1268],{},"The smallest useful job reads one product page of a shop:",[1270,1271,1275],"pre",{"className":1272,"code":1273,"language":680,"meta":1274,"style":1274},"language-json shiki shiki-themes kaab-code kaab-code kaab-code","{\n  \"url\": \"https:\u002F\u002Fshop.example.com\u002Fp\u002F1\",\n  \"extract\": {\n    \"title\": \"h1\",\n    \"price\": { \"selector\": \".price\", \"type\": \"money\", \"locale\": \"tr\", \"currency\": \"TRY\" }\n  }\n}\n","",[1054,1276,1277,1286,1304,1315,1328,1381,1387],{"__ignoreMap":1274},[1278,1279,1282],"span",{"class":1280,"line":1281},"line",1,[1278,1283,1285],{"class":1284},"sTzsn","{\n",[1278,1287,1289,1293,1297,1301],{"class":1280,"line":1288},2,[1278,1290,1292],{"class":1291},"sqn18","  \"url\"",[1278,1294,1296],{"class":1295},"sQm2-",":",[1278,1298,1300],{"class":1299},"suOy4"," \"https:\u002F\u002Fshop.example.com\u002Fp\u002F1\"",[1278,1302,1303],{"class":1295},",\n",[1278,1305,1307,1310,1312],{"class":1280,"line":1306},3,[1278,1308,1309],{"class":1291},"  \"extract\"",[1278,1311,1296],{"class":1295},[1278,1313,1314],{"class":1284}," {\n",[1278,1316,1318,1321,1323,1326],{"class":1280,"line":1317},4,[1278,1319,1320],{"class":1291},"    \"title\"",[1278,1322,1296],{"class":1295},[1278,1324,1325],{"class":1299}," \"h1\"",[1278,1327,1303],{"class":1295},[1278,1329,1331,1334,1336,1339,1342,1344,1347,1350,1353,1355,1358,1360,1363,1365,1368,1370,1373,1375,1378],{"class":1280,"line":1330},5,[1278,1332,1333],{"class":1291},"    \"price\"",[1278,1335,1296],{"class":1295},[1278,1337,1338],{"class":1284}," { ",[1278,1340,1341],{"class":1291},"\"selector\"",[1278,1343,1296],{"class":1295},[1278,1345,1346],{"class":1299}," \".price\"",[1278,1348,1349],{"class":1295},",",[1278,1351,1352],{"class":1291}," \"type\"",[1278,1354,1296],{"class":1295},[1278,1356,1357],{"class":1299}," \"money\"",[1278,1359,1349],{"class":1295},[1278,1361,1362],{"class":1291}," \"locale\"",[1278,1364,1296],{"class":1295},[1278,1366,1367],{"class":1299}," \"tr\"",[1278,1369,1349],{"class":1295},[1278,1371,1372],{"class":1291}," \"currency\"",[1278,1374,1296],{"class":1295},[1278,1376,1377],{"class":1299}," \"TRY\"",[1278,1379,1380],{"class":1284}," }\n",[1278,1382,1384],{"class":1280,"line":1383},6,[1278,1385,1386],{"class":1284},"  }\n",[1278,1388,1390],{"class":1280,"line":1389},7,[1278,1391,1392],{"class":1284},"}\n",[1025,1394,1395,1396,1398,1399,1401,1402,1404,1405,1408],{},"Kaabist compiles it to a program with a ",[1054,1397,590],{}," and an ",[1054,1400,569],{},", runs it at the ",[1054,1403,1155],{}," tier because nothing in it needs a browser, and answers with ",[1054,1406,1407],{},"status: \"succeeded\""," and:",[1270,1410,1412],{"className":1272,"code":1411,"language":680,"meta":1274,"style":1274},"{ \"title\": \"Kulaklık Klasik 101\", \"price\": { \"amount\": 1337.4, \"currency\": \"TRY\" } }\n",[1054,1413,1414],{"__ignoreMap":1274},[1278,1415,1416,1419,1422,1424,1427,1429,1432,1434,1436,1439,1441,1445,1447,1449,1451,1453],{"class":1280,"line":1281},[1278,1417,1418],{"class":1284},"{ ",[1278,1420,1421],{"class":1291},"\"title\"",[1278,1423,1296],{"class":1295},[1278,1425,1426],{"class":1299}," \"Kulaklık Klasik 101\"",[1278,1428,1349],{"class":1295},[1278,1430,1431],{"class":1291}," \"price\"",[1278,1433,1296],{"class":1295},[1278,1435,1338],{"class":1284},[1278,1437,1438],{"class":1291},"\"amount\"",[1278,1440,1296],{"class":1295},[1278,1442,1444],{"class":1443},"sHJIl"," 1337.4",[1278,1446,1349],{"class":1295},[1278,1448,1372],{"class":1291},[1278,1450,1296],{"class":1295},[1278,1452,1377],{"class":1299},[1278,1454,1455],{"class":1284}," } }\n",[1025,1457,1458,1459,1462,1463,1466],{},"The price arrives as a number and a currency, not as the string ",[1054,1460,1461],{},"1.337,40 TL",", because the field declares its type and locale. ",[1092,1464,16],{"href":1465},"\u002Fgetting-started\u002Ffirst-job"," runs this request in each language.",[1029,1468,1470],{"id":1469},"the-path-through-getting-started","The path through Getting started",[1472,1473,1474,1485,1490],"ol",{},[1475,1476,1477,1480,1481,1484],"li",{},[1092,1478,13],{"href":1479},"\u002Fgetting-started\u002Fkeys-and-modes",": create an ",[1054,1482,1483],{},"sk_test_"," key, and learn the conventions every endpoint shares.",[1475,1486,1487,1489],{},[1092,1488,16],{"href":1465},": install an SDK or the CLI and run the request above.",[1475,1491,1492,1494],{},[1092,1493,19],{"href":1145},": what each status carries, and how each SDK waits for a job to finish.",[1025,1496,1497,1498,1501,1502,1505],{},"Then read the ",[1092,1499,1500],{"href":23},"concepts"," in order, or go straight to a ",[1092,1503,1504],{"href":84},"guide"," for your task.",[1029,1507,1509],{"id":1508},"pitfalls","Pitfalls",[1511,1512,1513,1529,1538],"ul",{},[1475,1514,1515,1518,1519,1086,1521,1523,1524,1086,1526,1528],{},[1050,1516,1517],{},"Treating a parked job as a failure."," ",[1054,1520,1128],{},[1054,1522,1131],{}," are states you can act on. A client that switches only on ",[1054,1525,1134],{},[1054,1527,1137],{}," leaves parked jobs waiting until they expire.",[1475,1530,1531,1534,1535,1537],{},[1050,1532,1533],{},"Building against live keys."," Use an ",[1054,1536,1483],{}," key while you develop: test jobs run for real, reserve no credits, and are capped by a daily count instead.",[1475,1539,1540,1543,1544,1547,1548,1551],{},[1050,1541,1542],{},"Expecting a guess."," When a value cannot be read, Kaabist returns ",[1054,1545,1546],{},"null"," with a warning, or parks, rather than returning something plausible. Read ",[1054,1549,1550],{},"warnings[]"," on every succeeded job.",[1029,1553,155],{"id":1554},"reference",[1511,1556,1557,1563,1569,1579],{},[1475,1558,1559],{},[1092,1560,1562],{"href":1561},"\u002Freference\u002Fapi\u002Fjobs\u002Fcreate-job","Create a job",[1475,1564,1565],{},[1092,1566,1568],{"href":1567},"\u002Freference\u002Fapi\u002Fschemas\u002Fjob","The job object",[1475,1570,1571,1086,1575],{},[1092,1572,1574],{"href":1573},"\u002Freference\u002Fcodes#job-statuses","Job statuses",[1092,1576,1578],{"href":1577},"\u002Freference\u002Fcodes#attention-reasons","attention reasons",[1475,1580,1581],{},[1092,1582,1583],{"href":525},"The DSL reference",[1585,1586,1587],"style",{},"html pre.shiki code .sTzsn, html code.shiki .sTzsn{--shiki-light:var(--kaab-code-foreground);--shiki-default:var(--kaab-code-foreground);--shiki-dark:var(--kaab-code-foreground)}html pre.shiki code .sqn18, html code.shiki .sqn18{--shiki-light:var(--kaab-code-token-keyword);--shiki-default:var(--kaab-code-token-keyword);--shiki-dark:var(--kaab-code-token-keyword)}html pre.shiki code .sQm2-, html code.shiki .sQm2-{--shiki-light:var(--kaab-code-token-punctuation);--shiki-default:var(--kaab-code-token-punctuation);--shiki-dark:var(--kaab-code-token-punctuation)}html pre.shiki code .suOy4, html code.shiki .suOy4{--shiki-light:var(--kaab-code-token-string-expression);--shiki-default:var(--kaab-code-token-string-expression);--shiki-dark:var(--kaab-code-token-string-expression)}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sHJIl, html code.shiki .sHJIl{--shiki-light:var(--kaab-code-token-constant);--shiki-default:var(--kaab-code-token-constant);--shiki-dark:var(--kaab-code-token-constant)}",{"title":1274,"searchDepth":1306,"depth":1306,"links":1589},[1590,1591,1599,1600,1601,1602,1603],{"id":1031,"depth":1288,"text":1032},{"id":1041,"depth":1288,"text":1042,"children":1592},[1593,1594,1595,1596,1597,1598],{"id":30,"depth":1306,"text":29},{"id":171,"depth":1306,"text":170},{"id":1148,"depth":1306,"text":1149},{"id":1170,"depth":1306,"text":1171},{"id":1203,"depth":1306,"text":1204},{"id":114,"depth":1306,"text":113},{"id":1237,"depth":1288,"text":1238},{"id":1264,"depth":1288,"text":1265},{"id":1469,"depth":1288,"text":1470},{"id":1508,"depth":1288,"text":1509},{"id":1554,"depth":1288,"text":155},false,null,"The Kaabist model in one page (programs, jobs, tiers, parking, healing and side-effect safety) and the path through Getting started.","md",{},true,{"title":10,"description":1606},"1.getting-started\u002F01.index","yuizyGqo_RScYx2W9d9puPzJg95rNafvusYz8jNLLSk",[1605,1614],{"title":13,"path":1479,"stem":1615,"description":1616,"children":-1},"1.getting-started\u002F02.keys-and-modes","API keys, their scopes and rotation, live and test mode, and the conventions every Kaabist endpoint shares: errors, pagination, idempotency and waiting.",1793591003131]