{"openapi":"3.1.0","info":{"title":"Listaro API","version":"1.0.0","description":"Use the Listaro tools and saved workflows from your applications."},"servers":[{"url":"https://listaro.vercel.app"}],"paths":{"/api/v1/operations/list_extraction_presets":{"post":{"operationId":"list_extraction_presets","summary":"list extraction presets","description":"List the six source-observed extraction presets and their field schemas. Required API key scope: list_extraction_presets. Hosted execution requires a connected engine. Local filesystem paths are unavailable.","tags":["Read and manage"],"security":[{"ListaroKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"An 8–128 character key for one execution. Retain it after an uncertain response; use a new key for new work.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false},"example":{}}}},"responses":{"200":{"description":"Structured operation result. Inspect status, warnings, completeness and evidence; an HTTP success does not imply full capture.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/v1/operations/crawl_site":{"post":{"operationId":"crawl_site","summary":"crawl site","description":"Queue an exact-origin durable crawl with bounded budgets, robots policies, recovery and source evidence. Required API key scope: crawl_site. Hosted execution requires a connected engine. Local filesystem paths are unavailable.","tags":["Collect and analyze"],"security":[{"ListaroKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"An 8–128 character key for one execution. Retain it after an uncertain response; use a new key for new work.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sync":{"type":"object","properties":{"baselineCrawlId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"mode":{"default":"full","type":"string","enum":["full","incremental"]},"emitUnchanged":{"default":false,"type":"boolean"}},"additionalProperties":false},"dataset":{"type":"object","properties":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"recordSelector":{"type":"string","minLength":1,"maxLength":256},"primaryKeyFields":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"}},"onInvalid":{"default":"retain_with_errors","type":"string","enum":["retain_with_errors","reject_record"]},"dedupe":{"default":"none","type":"string","enum":["none","primary_key"]}},"additionalProperties":false},"rag":{"type":"object","properties":{"enabled":{"type":"boolean"},"chunkStrategy":{"default":"section","type":"string","enum":["section","fixed"]},"maxTokensPerChunk":{"default":512,"type":"integer","minimum":16,"maximum":8192},"overlapTokens":{"default":32,"type":"integer","minimum":0,"maximum":1024},"includeBoilerplate":{"default":false,"type":"boolean"}},"required":["enabled"],"additionalProperties":false},"budget":{"type":"object","properties":{"maxPages":{"type":"integer","minimum":0,"maximum":30000},"maxRequests":{"type":"integer","minimum":0,"maximum":200000},"maxFetchedBytes":{"type":"integer","minimum":0,"maximum":2000000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30000},"maxDurationMs":{"type":"integer","minimum":1,"maximum":3600000},"maxArtifactsBytes":{"type":"integer","minimum":0,"maximum":2000000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000}},"additionalProperties":false},"seedUrl":{"type":"string","maxLength":2048,"format":"uri"},"maxPages":{"default":5,"type":"integer","minimum":1,"maximum":30000},"maxDepth":{"default":1,"type":"integer","minimum":0,"maximum":20},"maxBytesPerPage":{"default":1000000,"type":"integer","minimum":1024,"maximum":5000000},"timeoutMs":{"type":"integer","minimum":500,"maximum":30000},"renderMode":{"default":"never","type":"string","enum":["never","auto","always","guarded"]},"preset":{"type":"string","enum":["general","product","business","article","event","job"]},"useSitemaps":{"default":false,"type":"boolean"},"fieldSpecs":{"default":[],"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"},"selector":{"type":"string","minLength":1,"maxLength":256},"attribute":{"type":"string","pattern":"^[a-z][a-z0-9:_-]{0,63}$"},"multiple":{"type":"boolean"}},"required":["name","selector"],"additionalProperties":false}},"includePatterns":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"excludePatterns":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"crawlDelayMs":{"type":"integer","minimum":0,"maximum":60000},"maxDurationMs":{"type":"integer","minimum":1000,"maximum":3600000},"maxTotalBytes":{"type":"integer","minimum":1024,"maximum":2000000000},"maxConcurrency":{"type":"integer","minimum":1,"maximum":16},"maxSitemapDocuments":{"type":"integer","minimum":1,"maximum":1000},"idempotencyKey":{"type":"string","minLength":1,"maxLength":128}},"required":["seedUrl"],"additionalProperties":false},"example":{"seedUrl":"https://example.org","maxPages":5,"maxDepth":1,"renderMode":"never","useSitemaps":true}}}},"responses":{"200":{"description":"Structured operation result. Inspect status, warnings, completeness and evidence; an HTTP success does not imply full capture.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/v1/operations/get_job":{"post":{"operationId":"get_job","summary":"get job","description":"Get durable lifecycle, attempts, cancellation, progress counts and result references. Required API key scope: get_job. Hosted execution requires a connected engine. Local filesystem paths are unavailable.","tags":["Read and manage"],"security":[{"ListaroKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"An 8–128 character key for one execution. Retain it after an uncertain response; use a new key for new work.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"jobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"includeRecentEvents":{"type":"boolean"},"eventCursor":{"type":"string","maxLength":1024},"eventLimit":{"default":20,"type":"integer","minimum":1,"maximum":100},"batchCursor":{"type":"string","maxLength":1024},"batchLimit":{"default":20,"type":"integer","minimum":1,"maximum":50}},"required":["jobId"],"additionalProperties":false},"example":{"jobId":"11111111-1111-4111-8111-111111111111"}}}},"responses":{"200":{"description":"Structured operation result. Inspect status, warnings, completeness and evidence; an HTTP success does not imply full capture.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/v1/operations/get_crawl":{"post":{"operationId":"get_crawl","summary":"get crawl","description":"Read source-backed crawl pages with stable cursor pagination and verified artifacts. Required API key scope: get_crawl. Hosted execution requires a connected engine. Local filesystem paths are unavailable.","tags":["Read and manage"],"security":[{"ListaroKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"An 8–128 character key for one execution. Retain it after an uncertain response; use a new key for new work.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"crawlId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"changeFilter":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"string","enum":["added","updated","unchanged","unavailable","excluded","unknown","deleted_confirmed"]}},"limit":{"default":20,"type":"integer","minimum":1,"maximum":50},"cursor":{"type":"string","maxLength":1024}},"required":["crawlId"],"additionalProperties":false},"example":{"crawlId":"11111111-1111-4111-8111-111111111111","limit":20}}}},"responses":{"200":{"description":"Structured operation result. Inspect status, warnings, completeness and evidence; an HTTP success does not imply full capture.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/v1/operations/create_watch":{"post":{"operationId":"create_watch","summary":"create watch","description":"Save a watch definition with automatic scheduling OFF. Required API key scope: create_watch. Hosted execution requires a connected engine. Local filesystem paths are unavailable.","tags":["Collect and analyze"],"security":[{"ListaroKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"An 8–128 character key for one execution. Retain it after an uncertain response; use a new key for new work.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sync":{"type":"object","properties":{"mode":{"default":"full","type":"string","enum":["full","incremental"]},"baselineCrawlId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"emitUnchanged":{"default":false,"type":"boolean"}},"additionalProperties":false},"dataset":{"type":"object","properties":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"recordSelector":{"type":"string","minLength":1,"maxLength":256},"primaryKeyFields":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"}},"onInvalid":{"default":"retain_with_errors","type":"string","enum":["retain_with_errors","reject_record"]},"dedupe":{"default":"none","type":"string","enum":["none","primary_key"]}},"additionalProperties":false},"rag":{"type":"object","properties":{"enabled":{"type":"boolean"},"chunkStrategy":{"default":"section","type":"string","enum":["section","fixed"]},"maxTokensPerChunk":{"default":512,"type":"integer","minimum":16,"maximum":8192},"overlapTokens":{"default":32,"type":"integer","minimum":0,"maximum":1024},"includeBoilerplate":{"default":false,"type":"boolean"}},"required":["enabled"],"additionalProperties":false},"budget":{"type":"object","properties":{"maxPages":{"type":"integer","minimum":0,"maximum":30000},"maxRequests":{"type":"integer","minimum":0,"maximum":200000},"maxFetchedBytes":{"type":"integer","minimum":0,"maximum":2000000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30000},"maxDurationMs":{"type":"integer","minimum":1,"maximum":3600000},"maxArtifactsBytes":{"type":"integer","minimum":0,"maximum":2000000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000}},"additionalProperties":false},"seedUrl":{"type":"string","maxLength":2048,"format":"uri"},"maxPages":{"default":5,"type":"integer","minimum":1,"maximum":50},"maxDepth":{"default":1,"type":"integer","minimum":0,"maximum":20},"maxBytesPerPage":{"default":1000000,"type":"integer","minimum":1024,"maximum":5000000},"timeoutMs":{"type":"integer","minimum":500,"maximum":30000},"renderMode":{"default":"never","type":"string","enum":["never","auto","always","guarded"]},"preset":{"type":"string","enum":["general","product","business","article","event","job"]},"useSitemaps":{"default":false,"type":"boolean"},"fieldSpecs":{"default":[],"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"},"selector":{"type":"string","minLength":1,"maxLength":256},"attribute":{"type":"string","pattern":"^[a-z][a-z0-9:_-]{0,63}$"},"multiple":{"type":"boolean"}},"required":["name","selector"],"additionalProperties":false}},"includePatterns":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"excludePatterns":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"crawlDelayMs":{"type":"integer","minimum":0,"maximum":60000},"maxDurationMs":{"type":"integer","minimum":1000,"maximum":3600000},"maxTotalBytes":{"type":"integer","minimum":1024,"maximum":2000000000},"maxConcurrency":{"type":"integer","minimum":1,"maximum":16},"maxSitemapDocuments":{"type":"integer","minimum":1,"maximum":1000},"label":{"type":"string","maxLength":120},"intervalMinutes":{"default":360,"type":"integer","minimum":60,"maximum":10080}},"required":["seedUrl"],"additionalProperties":false},"example":{"seedUrl":"https://example.org","maxPages":5,"maxDepth":1,"renderMode":"never","useSitemaps":true,"intervalMinutes":1440}}}},"responses":{"200":{"description":"Structured operation result. Inspect status, warnings, completeness and evidence; an HTTP success does not imply full capture.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/v1/operations/check_watch":{"post":{"operationId":"check_watch","summary":"check watch","description":"Coalesce and queue a manual baseline or change check. Required API key scope: check_watch. Hosted execution requires a connected engine. Local filesystem paths are unavailable.","tags":["Collect and analyze"],"security":[{"ListaroKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"An 8–128 character key for one execution. Retain it after an uncertain response; use a new key for new work.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"watchId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["watchId"],"additionalProperties":false},"example":{"watchId":"11111111-1111-4111-8111-111111111111"}}}},"responses":{"200":{"description":"Structured operation result. Inspect status, warnings, completeness and evidence; an HTTP success does not imply full capture.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/v1/operations/set_watch_schedule":{"post":{"operationId":"set_watch_schedule","summary":"set watch schedule","description":"Explicitly enable or disable a persisted watch schedule. Required API key scope: set_watch_schedule. Hosted execution requires a connected engine. Local filesystem paths are unavailable.","tags":["Read and manage"],"security":[{"ListaroKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"An 8–128 character key for one execution. Retain it after an uncertain response; use a new key for new work.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"watchId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"enabled":{"type":"boolean"},"intervalMinutes":{"type":"integer","minimum":60,"maximum":10080}},"required":["watchId","enabled"],"additionalProperties":false},"example":{"watchId":"11111111-1111-4111-8111-111111111111","enabled":false,"intervalMinutes":1440}}}},"responses":{"200":{"description":"Structured operation result. Inspect status, warnings, completeness and evidence; an HTTP success does not imply full capture.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/v1/operations/list_watches":{"post":{"operationId":"list_watches","summary":"list watches","description":"List saved watches with bounded pagination. Required API key scope: list_watches. Hosted execution requires a connected engine. Local filesystem paths are unavailable.","tags":["Read and manage"],"security":[{"ListaroKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"An 8–128 character key for one execution. Retain it after an uncertain response; use a new key for new work.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":50,"type":"integer","minimum":1,"maximum":50},"cursor":{"type":"string","maxLength":1024}},"additionalProperties":false},"example":{"limit":20}}}},"responses":{"200":{"description":"Structured operation result. Inspect status, warnings, completeness and evidence; an HTTP success does not imply full capture.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/v1/operations/compare_crawls":{"post":{"operationId":"compare_crawls","summary":"compare crawls","description":"Compare all observed pages from same-origin snapshots; missing observations never assert deletion. Required API key scope: compare_crawls. Hosted execution requires a connected engine. Local filesystem paths are unavailable.","tags":["Collect and analyze"],"security":[{"ListaroKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"An 8–128 character key for one execution. Retain it after an uncertain response; use a new key for new work.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"beforeRunId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"afterRunId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["beforeRunId","afterRunId"],"additionalProperties":false},"example":{"beforeRunId":"11111111-1111-4111-8111-111111111111","afterRunId":"22222222-2222-4222-8222-222222222222"}}}},"responses":{"200":{"description":"Structured operation result. Inspect status, warnings, completeness and evidence; an HTTP success does not imply full capture.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/v1/operations/get_change_report":{"post":{"operationId":"get_change_report","summary":"get change report","description":"Read a saved source-backed watch comparison with pagination. Required API key scope: get_change_report. Hosted execution requires a connected engine. Local filesystem paths are unavailable.","tags":["Read and manage"],"security":[{"ListaroKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"An 8–128 character key for one execution. Retain it after an uncertain response; use a new key for new work.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"reportId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"changeFilter":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"string","enum":["added","updated","unchanged","unavailable","excluded","unknown","deleted_confirmed"]}},"limit":{"default":40,"type":"integer","minimum":1,"maximum":50},"cursor":{"type":"string","maxLength":1024}},"required":["reportId"],"additionalProperties":false},"example":{"reportId":"11111111-1111-4111-8111-111111111111","limit":20}}}},"responses":{"200":{"description":"Structured operation result. Inspect status, warnings, completeness and evidence; an HTTP success does not imply full capture.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/v1/operations/scrape_page":{"post":{"operationId":"scrape_page","summary":"scrape page","description":"Acquire a page once and return Markdown, HTML, JSON, links, metadata, images or screenshot artifacts. Required API key scope: scrape_page. Hosted execution requires a connected engine. Local filesystem paths are unavailable.","tags":["Collect and analyze"],"security":[{"ListaroKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"An 8–128 character key for one execution. Retain it after an uncertain response; use a new key for new work.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"dataset":{"type":"object","properties":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"recordSelector":{"type":"string","minLength":1,"maxLength":256},"primaryKeyFields":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"}},"onInvalid":{"default":"retain_with_errors","type":"string","enum":["retain_with_errors","reject_record"]},"dedupe":{"default":"none","type":"string","enum":["none","primary_key"]}},"additionalProperties":false},"rag":{"type":"object","properties":{"enabled":{"type":"boolean"},"chunkStrategy":{"default":"section","type":"string","enum":["section","fixed"]},"maxTokensPerChunk":{"default":512,"type":"integer","minimum":16,"maximum":8192},"overlapTokens":{"default":32,"type":"integer","minimum":0,"maximum":1024},"includeBoilerplate":{"default":false,"type":"boolean"}},"required":["enabled"],"additionalProperties":false},"budget":{"type":"object","properties":{"maxPages":{"type":"integer","minimum":0,"maximum":30000},"maxRequests":{"type":"integer","minimum":0,"maximum":200000},"maxFetchedBytes":{"type":"integer","minimum":0,"maximum":2000000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30000},"maxDurationMs":{"type":"integer","minimum":1,"maximum":3600000},"maxArtifactsBytes":{"type":"integer","minimum":0,"maximum":2000000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000}},"additionalProperties":false},"url":{"type":"string","maxLength":2048,"format":"uri"},"formats":{"default":["markdown","metadata"],"minItems":1,"maxItems":8,"type":"array","items":{"type":"string","enum":["markdown","html","rawHtml","json","links","metadata","images","screenshot"]}},"renderMode":{"default":"auto","type":"string","enum":["never","auto","always"]},"waitFor":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"maxLength":256},"timeoutMs":{"type":"integer","minimum":1,"maximum":10000}},"additionalProperties":false},"extract":{"type":"object","properties":{"fields":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"},"selector":{"type":"string","minLength":1,"maxLength":256},"attribute":{"type":"string","pattern":"^[a-z][a-z0-9:_-]{0,63}$"},"multiple":{"type":"boolean"}},"required":["name","selector"],"additionalProperties":false}},"preset":{"type":"string","enum":["general","product","business","article","event","job"]},"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"records":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"maxLength":256},"fields":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"},"selector":{"type":"string","minLength":1,"maxLength":256},"attribute":{"type":"string","pattern":"^[a-z][a-z0-9:_-]{0,63}$"},"multiple":{"type":"boolean"}},"required":["name","selector"],"additionalProperties":false}}},"required":["selector","fields"],"additionalProperties":false}},"additionalProperties":false},"timeoutMs":{"type":"integer","minimum":500,"maximum":30000},"maxBytes":{"type":"integer","minimum":1024,"maximum":5000000}},"required":["url"],"additionalProperties":false},"example":{"url":"https://example.org","formats":["markdown","metadata","images"],"renderMode":"never"}}}},"responses":{"200":{"description":"Structured operation result. Inspect status, warnings, completeness and evidence; an HTTP success does not imply full capture.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/v1/operations/map_site":{"post":{"operationId":"map_site","summary":"map site","description":"Discover exact-scope URLs from sitemaps and a bounded link sample; discovered URLs are not verified page fetches. Required API key scope: map_site. Hosted execution requires a connected engine. Local filesystem paths are unavailable.","tags":["Collect and analyze"],"security":[{"ListaroKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"An 8–128 character key for one execution. Retain it after an uncertain response; use a new key for new work.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"budget":{"type":"object","properties":{"maxPages":{"type":"integer","minimum":0,"maximum":30000},"maxRequests":{"type":"integer","minimum":0,"maximum":200000},"maxFetchedBytes":{"type":"integer","minimum":0,"maximum":2000000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30000},"maxDurationMs":{"type":"integer","minimum":1,"maximum":3600000},"maxArtifactsBytes":{"type":"integer","minimum":0,"maximum":2000000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000}},"additionalProperties":false},"url":{"type":"string","maxLength":2048,"format":"uri"},"maxUrls":{"default":1000,"type":"integer","minimum":1,"maximum":100000},"maxSitemapDocuments":{"default":100,"type":"integer","minimum":1,"maximum":1000},"maxDepth":{"default":2,"type":"integer","minimum":0,"maximum":20},"includeSubdomains":{"default":false,"type":"boolean"},"includePatterns":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"excludePatterns":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"useSitemaps":{"default":true,"type":"boolean"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://example.org","maxUrls":20,"maxDepth":2,"useSitemaps":true}}}},"responses":{"200":{"description":"Structured operation result. Inspect status, warnings, completeness and evidence; an HTTP success does not imply full capture.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/v1/operations/scrape_batch":{"post":{"operationId":"scrape_batch","summary":"scrape batch","description":"Queue 1–1000 input-order page results with isolated failures, retries and cancellation. Required API key scope: scrape_batch. Hosted execution requires a connected engine. Local filesystem paths are unavailable.","tags":["Collect and analyze"],"security":[{"ListaroKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"An 8–128 character key for one execution. Retain it after an uncertain response; use a new key for new work.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"dataset":{"type":"object","properties":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"recordSelector":{"type":"string","minLength":1,"maxLength":256},"primaryKeyFields":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"}},"onInvalid":{"default":"retain_with_errors","type":"string","enum":["retain_with_errors","reject_record"]},"dedupe":{"default":"none","type":"string","enum":["none","primary_key"]}},"additionalProperties":false},"rag":{"type":"object","properties":{"enabled":{"type":"boolean"},"chunkStrategy":{"default":"section","type":"string","enum":["section","fixed"]},"maxTokensPerChunk":{"default":512,"type":"integer","minimum":16,"maximum":8192},"overlapTokens":{"default":32,"type":"integer","minimum":0,"maximum":1024},"includeBoilerplate":{"default":false,"type":"boolean"}},"required":["enabled"],"additionalProperties":false},"budget":{"type":"object","properties":{"maxPages":{"type":"integer","minimum":0,"maximum":30000},"maxRequests":{"type":"integer","minimum":0,"maximum":200000},"maxFetchedBytes":{"type":"integer","minimum":0,"maximum":2000000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30000},"maxDurationMs":{"type":"integer","minimum":1,"maximum":3600000},"maxArtifactsBytes":{"type":"integer","minimum":0,"maximum":2000000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000}},"additionalProperties":false},"urls":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"string","maxLength":2048,"format":"uri"}},"formats":{"default":["markdown","metadata"],"minItems":1,"maxItems":8,"type":"array","items":{"type":"string","enum":["markdown","html","rawHtml","json","links","metadata","images","screenshot"]}},"renderMode":{"default":"auto","type":"string","enum":["never","auto","always"]},"extract":{"type":"object","properties":{"fields":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"},"selector":{"type":"string","minLength":1,"maxLength":256},"attribute":{"type":"string","pattern":"^[a-z][a-z0-9:_-]{0,63}$"},"multiple":{"type":"boolean"}},"required":["name","selector"],"additionalProperties":false}},"preset":{"type":"string","enum":["general","product","business","article","event","job"]},"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"records":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"maxLength":256},"fields":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"},"selector":{"type":"string","minLength":1,"maxLength":256},"attribute":{"type":"string","pattern":"^[a-z][a-z0-9:_-]{0,63}$"},"multiple":{"type":"boolean"}},"required":["name","selector"],"additionalProperties":false}}},"required":["selector","fields"],"additionalProperties":false}},"additionalProperties":false},"maxConcurrency":{"default":4,"type":"integer","minimum":1,"maximum":16},"idempotencyKey":{"type":"string","minLength":1,"maxLength":128}},"required":["urls"],"additionalProperties":false},"example":{"urls":["https://example.org"],"formats":["markdown","metadata"],"renderMode":"never","maxConcurrency":2}}}},"responses":{"200":{"description":"Structured operation result. Inspect status, warnings, completeness and evidence; an HTTP success does not imply full capture.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/v1/operations/get_artifact":{"post":{"operationId":"get_artifact","summary":"get artifact","description":"Read a checksum-verified workspace artifact with bounded UTF-8 or base64 ranges. Required API key scope: get_artifact. Hosted execution requires a connected engine. Local filesystem paths are unavailable.","tags":["Read and manage"],"security":[{"ListaroKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"An 8–128 character key for one execution. Retain it after an uncertain response; use a new key for new work.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"artifactId":{"type":"string","pattern":"^a_[0-9a-f]{64}$"},"offset":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"limitBytes":{"default":32768,"type":"integer","minimum":1,"maximum":65536},"encoding":{"type":"string","enum":["utf8","base64"]}},"required":["artifactId"],"additionalProperties":false},"example":{"artifactId":"a_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","offset":0,"limitBytes":32768}}}},"responses":{"200":{"description":"Structured operation result. Inspect status, warnings, completeness and evidence; an HTTP success does not imply full capture.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/v1/operations/cancel_job":{"post":{"operationId":"cancel_job","summary":"cancel job","description":"Idempotently cancel a queued or running workspace job while preserving completed evidence. Required API key scope: cancel_job. Hosted execution requires a connected engine. Local filesystem paths are unavailable.","tags":["Read and manage"],"security":[{"ListaroKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"An 8–128 character key for one execution. Retain it after an uncertain response; use a new key for new work.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"jobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"reason":{"type":"string","maxLength":500}},"required":["jobId"],"additionalProperties":false},"example":{"jobId":"11111111-1111-4111-8111-111111111111"}}}},"responses":{"200":{"description":"Structured operation result. Inspect status, warnings, completeness and evidence; an HTTP success does not imply full capture.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/v1/operations/parse_document":{"post":{"operationId":"parse_document","summary":"parse document","description":"Parse PDF, DOCX, XLSX, HTML or TXT with source evidence, page/sheet metadata and resource limits. Required API key scope: parse_document. Hosted execution requires a connected engine. Local filesystem paths are unavailable.","tags":["Collect and analyze"],"security":[{"ListaroKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"An 8–128 character key for one execution. Retain it after an uncertain response; use a new key for new work.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"rag":{"type":"object","properties":{"enabled":{"type":"boolean"},"chunkStrategy":{"default":"section","type":"string","enum":["section","fixed"]},"maxTokensPerChunk":{"default":512,"type":"integer","minimum":16,"maximum":8192},"overlapTokens":{"default":32,"type":"integer","minimum":0,"maximum":1024},"includeBoilerplate":{"default":false,"type":"boolean"}},"required":["enabled"],"additionalProperties":false},"budget":{"type":"object","properties":{"maxPages":{"type":"integer","minimum":0,"maximum":30000},"maxRequests":{"type":"integer","minimum":0,"maximum":200000},"maxFetchedBytes":{"type":"integer","minimum":0,"maximum":2000000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30000},"maxDurationMs":{"type":"integer","minimum":1,"maximum":3600000},"maxArtifactsBytes":{"type":"integer","minimum":0,"maximum":2000000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000}},"additionalProperties":false},"url":{"type":"string","maxLength":2048,"format":"uri"},"artifactId":{"type":"string","pattern":"^a_[0-9a-f]{64}$"},"formats":{"default":["text","markdown"],"minItems":1,"maxItems":4,"type":"array","items":{"type":"string","enum":["text","markdown","json","tables"]}},"maxBytes":{"default":10000000,"type":"integer","minimum":1,"maximum":20000000}},"additionalProperties":false},"example":{"url":"https://example.org/example.pdf","formats":["markdown","text"],"maxBytes":1000000}}}},"responses":{"200":{"description":"Structured operation result. Inspect status, warnings, completeness and evidence; an HTTP success does not imply full capture.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/v1/operations/browser_session":{"post":{"operationId":"browser_session","summary":"browser session","description":"Create, inspect or close an ephemeral browser context with TTL and resource limits. Required API key scope: browser_session. Hosted execution requires a connected engine. Local filesystem paths are unavailable.","tags":["Collect and analyze"],"security":[{"ListaroKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"An 8–128 character key for one execution. Retain it after an uncertain response; use a new key for new work.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"budget":{"type":"object","properties":{"maxPages":{"type":"integer","minimum":0,"maximum":30000},"maxRequests":{"type":"integer","minimum":0,"maximum":200000},"maxFetchedBytes":{"type":"integer","minimum":0,"maximum":2000000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30000},"maxDurationMs":{"type":"integer","minimum":1,"maximum":3600000},"maxArtifactsBytes":{"type":"integer","minimum":0,"maximum":2000000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000}},"additionalProperties":false},"action":{"type":"string","enum":["create","get","close"]},"sessionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"initialUrl":{"type":"string","maxLength":2048,"format":"uri"},"ttlSeconds":{"default":120,"type":"integer","minimum":1,"maximum":600}},"required":["action"],"additionalProperties":false},"example":{"action":"create","initialUrl":"https://example.org","ttlSeconds":120}}}},"responses":{"200":{"description":"Structured operation result. Inspect status, warnings, completeness and evidence; an HTTP success does not imply full capture.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/v1/operations/browser_action":{"post":{"operationId":"browser_action","summary":"browser action","description":"Navigate, click, fill, scroll, wait, snapshot or screenshot in an authorized guarded browser session. Required API key scope: browser_action. Hosted execution requires a connected engine. Local filesystem paths are unavailable.","tags":["Collect and analyze"],"security":[{"ListaroKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"An 8–128 character key for one execution. Retain it after an uncertain response; use a new key for new work.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"budget":{"type":"object","properties":{"maxPages":{"type":"integer","minimum":0,"maximum":30000},"maxRequests":{"type":"integer","minimum":0,"maximum":200000},"maxFetchedBytes":{"type":"integer","minimum":0,"maximum":2000000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30000},"maxDurationMs":{"type":"integer","minimum":1,"maximum":3600000},"maxArtifactsBytes":{"type":"integer","minimum":0,"maximum":2000000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000}},"additionalProperties":false},"sessionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"action":{"type":"string","enum":["navigate","click","fill","scroll","wait_for","snapshot","screenshot"]},"url":{"type":"string","maxLength":2048,"format":"uri"},"selector":{"type":"string","minLength":1,"maxLength":256},"text":{"type":"string","maxLength":4000},"direction":{"type":"string","enum":["up","down"]},"amount":{"type":"integer","minimum":1,"maximum":10000},"timeoutMs":{"default":3000,"type":"integer","minimum":1,"maximum":10000}},"required":["sessionId","action"],"additionalProperties":false},"example":{"sessionId":"11111111-1111-4111-8111-111111111111","action":"snapshot","timeoutMs":3000}}}},"responses":{"200":{"description":"Structured operation result. Inspect status, warnings, completeness and evidence; an HTTP success does not imply full capture.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/v1/operations/search_web":{"post":{"operationId":"search_web","summary":"search web","description":"Discover ranked public-web URLs through private, keyless metasearch by default. Results are discovered, not fetched or independently verified; optional legacy providers have different coverage. Required API key scope: search_web. Hosted execution requires a connected engine. Local filesystem paths are unavailable.","tags":["Collect and analyze"],"security":[{"ListaroKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"An 8–128 character key for one execution. Retain it after an uncertain response; use a new key for new work.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"budget":{"type":"object","properties":{"maxPages":{"type":"integer","minimum":0,"maximum":30000},"maxRequests":{"type":"integer","minimum":0,"maximum":200000},"maxFetchedBytes":{"type":"integer","minimum":0,"maximum":2000000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30000},"maxDurationMs":{"type":"integer","minimum":1,"maximum":3600000},"maxArtifactsBytes":{"type":"integer","minimum":0,"maximum":2000000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000}},"additionalProperties":false},"query":{"type":"string","minLength":1,"maxLength":500},"limit":{"default":5,"type":"integer","minimum":1,"maximum":10},"provider":{"type":"string","maxLength":40},"language":{"type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$"},"region":{"type":"string","pattern":"^[a-zA-Z]{2}$"}},"required":["query"],"additionalProperties":false},"example":{"query":"Open-source crawling tools","limit":5}}}},"responses":{"200":{"description":"Structured operation result. Inspect status, warnings, completeness and evidence; an HTTP success does not imply full capture.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}},"/api/v1/workflows/templates":{"get":{"operationId":"workflowTemplates","tags":["Workflows"],"summary":"List workflow templates","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[],"responses":{"200":{"description":"Workflow result","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/api/v1/workflows":{"get":{"operationId":"listWorkflows","tags":["Workflows"],"summary":"List saved workflows","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Workflow result","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"createWorkflow","tags":["Workflows"],"summary":"Create a saved workflow","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","oneOf":[{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"default":"","type":"string","maxLength":800},"budget":{"default":{},"type":"object","properties":{"maxPages":{"type":"integer","minimum":1,"maximum":200},"maxRequests":{"type":"integer","minimum":1,"maximum":500},"maxFetchedBytes":{"type":"integer","minimum":1024,"maximum":300000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30},"maxDurationMs":{"type":"integer","minimum":1000,"maximum":1800000},"maxArtifactsBytes":{"type":"integer","minimum":1024,"maximum":500000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000},"maxModelTokens":{"type":"integer","minimum":0,"maximum":20000}},"additionalProperties":false},"kind":{"type":"string","const":"deep_research"},"inputs":{"type":"object","properties":{"question":{"type":"string","minLength":8,"maxLength":1500},"sourceUrls":{"maxItems":25,"type":"array","items":{"type":"string","maxLength":2048}},"sourceArtifacts":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^a_[a-f0-9]{64}$"}},"allowedDomains":{"default":[],"maxItems":25,"type":"array","items":{"type":"string","maxLength":253}},"requiredDomains":{"default":[],"maxItems":25,"type":"array","items":{"type":"string","maxLength":253}},"excludedDomains":{"default":[],"maxItems":25,"type":"array","items":{"type":"string","maxLength":253}},"depth":{"default":"quick","type":"string","enum":["quick","thorough","comprehensive"]},"minimumSources":{"default":2,"type":"integer","minimum":1,"maximum":20},"language":{"type":"string","pattern":"^[a-z]{2}(?:-[A-Z]{2})?$"},"region":{"type":"string","pattern":"^[a-zA-Z]{2}$"},"timeframe":{"type":"string","maxLength":120},"reportSections":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"mode":{"default":"report","type":"string","enum":["report","dossier"]},"synthesis":{"type":"string","enum":["extractive","model"]},"renderMode":{"default":"auto","type":"string","enum":["never","auto","always"]}},"required":["question"],"additionalProperties":false}},"required":["name","kind","inputs"],"additionalProperties":false},{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"default":"","type":"string","maxLength":800},"budget":{"default":{},"type":"object","properties":{"maxPages":{"type":"integer","minimum":1,"maximum":200},"maxRequests":{"type":"integer","minimum":1,"maximum":500},"maxFetchedBytes":{"type":"integer","minimum":1024,"maximum":300000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30},"maxDurationMs":{"type":"integer","minimum":1000,"maximum":1800000},"maxArtifactsBytes":{"type":"integer","minimum":1024,"maximum":500000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000},"maxModelTokens":{"type":"integer","minimum":0,"maximum":20000}},"additionalProperties":false},"kind":{"type":"string","const":"structured_dataset"},"inputs":{"type":"object","properties":{"sourceUrls":{"maxItems":25,"type":"array","items":{"type":"string","maxLength":2048}},"preset":{"type":"string","enum":["general","product","business","article","event","job"]},"fields":{"default":[],"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"},"selector":{"type":"string","minLength":1,"maxLength":256},"attribute":{"type":"string","pattern":"^[a-z][a-z0-9:_-]{0,63}$"},"multiple":{"type":"boolean"}},"required":["name","selector"],"additionalProperties":false}},"recordSelector":{"type":"string","minLength":1,"maxLength":256},"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"primaryKeyFields":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"}},"onInvalid":{"default":"retain_with_errors","type":"string","enum":["retain_with_errors","reject_record"]},"existingDatasetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"discoverPages":{"default":false,"type":"boolean"},"includePatterns":{"default":[],"maxItems":24,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"excludePatterns":{"default":[],"maxItems":24,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"renderMode":{"default":"auto","type":"string","enum":["never","auto","always"]}},"required":["sourceUrls"],"additionalProperties":false}},"required":["name","kind","inputs"],"additionalProperties":false},{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"default":"","type":"string","maxLength":800},"budget":{"default":{},"type":"object","properties":{"maxPages":{"type":"integer","minimum":1,"maximum":200},"maxRequests":{"type":"integer","minimum":1,"maximum":500},"maxFetchedBytes":{"type":"integer","minimum":1024,"maximum":300000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30},"maxDurationMs":{"type":"integer","minimum":1000,"maximum":1800000},"maxArtifactsBytes":{"type":"integer","minimum":1024,"maximum":500000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000},"maxModelTokens":{"type":"integer","minimum":0,"maximum":20000}},"additionalProperties":false},"kind":{"type":"string","const":"knowledge_base"},"inputs":{"type":"object","properties":{"sourceUrls":{"maxItems":25,"type":"array","items":{"type":"string","maxLength":2048}},"sourceArtifacts":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^a_[a-f0-9]{64}$"}},"goal":{"default":"rag","type":"string","enum":["rag","reference"]},"includePatterns":{"default":[],"maxItems":24,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"excludePatterns":{"default":[],"maxItems":24,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"useSitemaps":{"default":true,"type":"boolean"},"maxDepth":{"default":2,"type":"integer","minimum":0,"maximum":4},"chunkStrategy":{"default":"section","type":"string","enum":["section","fixed"]},"maxTokensPerChunk":{"default":512,"type":"integer","minimum":64,"maximum":4096},"overlapTokens":{"default":32,"type":"integer","minimum":0,"maximum":512},"renderMode":{"default":"auto","type":"string","enum":["never","auto","always"]}},"additionalProperties":false}},"required":["name","kind","inputs"],"additionalProperties":false},{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"default":"","type":"string","maxLength":800},"budget":{"default":{},"type":"object","properties":{"maxPages":{"type":"integer","minimum":1,"maximum":200},"maxRequests":{"type":"integer","minimum":1,"maximum":500},"maxFetchedBytes":{"type":"integer","minimum":1024,"maximum":300000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30},"maxDurationMs":{"type":"integer","minimum":1000,"maximum":1800000},"maxArtifactsBytes":{"type":"integer","minimum":1024,"maximum":500000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000},"maxModelTokens":{"type":"integer","minimum":0,"maximum":20000}},"additionalProperties":false},"kind":{"type":"string","const":"competitive_intel"},"inputs":{"type":"object","properties":{"competitors":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"website":{"type":"string","maxLength":2048},"pages":{"maxItems":25,"type":"array","items":{"type":"string","maxLength":2048}}},"required":["name","website"],"additionalProperties":false}},"ownSite":{"type":"string","maxLength":2048},"focus":{"default":"all","type":"string","enum":["pricing","features","changelog","all"]},"cadence":{"default":"one_off","type":"string","enum":["one_off","daily","weekly","monthly"]},"relevantPathsOnly":{"default":true,"type":"boolean"},"renderMode":{"default":"auto","type":"string","enum":["never","auto","always"]}},"required":["competitors"],"additionalProperties":false}},"required":["name","kind","inputs"],"additionalProperties":false}]},"example":{"kind":"knowledge_base","name":"Knowledge Base Builder","inputs":{"sourceUrls":["https://docs.python.org/3/tutorial/"],"sourceArtifacts":[],"goal":"rag","includePatterns":[],"excludePatterns":[],"useSitemaps":true,"maxDepth":2,"chunkStrategy":"section","maxTokensPerChunk":512,"overlapTokens":32,"renderMode":"auto"}}}}},"responses":{"201":{"description":"Workflow result","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/api/v1/workflows/dataset-preview":{"post":{"operationId":"previewWorkflowDataset","tags":["Workflows"],"summary":"Preview dataset records from the first starting page","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["configuration"],"additionalProperties":false,"properties":{"configuration":{"$schema":"https://json-schema.org/draft/2020-12/schema","oneOf":[{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"default":"","type":"string","maxLength":800},"budget":{"default":{},"type":"object","properties":{"maxPages":{"type":"integer","minimum":1,"maximum":200},"maxRequests":{"type":"integer","minimum":1,"maximum":500},"maxFetchedBytes":{"type":"integer","minimum":1024,"maximum":300000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30},"maxDurationMs":{"type":"integer","minimum":1000,"maximum":1800000},"maxArtifactsBytes":{"type":"integer","minimum":1024,"maximum":500000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000},"maxModelTokens":{"type":"integer","minimum":0,"maximum":20000}},"additionalProperties":false},"kind":{"type":"string","const":"deep_research"},"inputs":{"type":"object","properties":{"question":{"type":"string","minLength":8,"maxLength":1500},"sourceUrls":{"maxItems":25,"type":"array","items":{"type":"string","maxLength":2048}},"sourceArtifacts":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^a_[a-f0-9]{64}$"}},"allowedDomains":{"default":[],"maxItems":25,"type":"array","items":{"type":"string","maxLength":253}},"requiredDomains":{"default":[],"maxItems":25,"type":"array","items":{"type":"string","maxLength":253}},"excludedDomains":{"default":[],"maxItems":25,"type":"array","items":{"type":"string","maxLength":253}},"depth":{"default":"quick","type":"string","enum":["quick","thorough","comprehensive"]},"minimumSources":{"default":2,"type":"integer","minimum":1,"maximum":20},"language":{"type":"string","pattern":"^[a-z]{2}(?:-[A-Z]{2})?$"},"region":{"type":"string","pattern":"^[a-zA-Z]{2}$"},"timeframe":{"type":"string","maxLength":120},"reportSections":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"mode":{"default":"report","type":"string","enum":["report","dossier"]},"synthesis":{"type":"string","enum":["extractive","model"]},"renderMode":{"default":"auto","type":"string","enum":["never","auto","always"]}},"required":["question"],"additionalProperties":false}},"required":["name","kind","inputs"],"additionalProperties":false},{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"default":"","type":"string","maxLength":800},"budget":{"default":{},"type":"object","properties":{"maxPages":{"type":"integer","minimum":1,"maximum":200},"maxRequests":{"type":"integer","minimum":1,"maximum":500},"maxFetchedBytes":{"type":"integer","minimum":1024,"maximum":300000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30},"maxDurationMs":{"type":"integer","minimum":1000,"maximum":1800000},"maxArtifactsBytes":{"type":"integer","minimum":1024,"maximum":500000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000},"maxModelTokens":{"type":"integer","minimum":0,"maximum":20000}},"additionalProperties":false},"kind":{"type":"string","const":"structured_dataset"},"inputs":{"type":"object","properties":{"sourceUrls":{"maxItems":25,"type":"array","items":{"type":"string","maxLength":2048}},"preset":{"type":"string","enum":["general","product","business","article","event","job"]},"fields":{"default":[],"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"},"selector":{"type":"string","minLength":1,"maxLength":256},"attribute":{"type":"string","pattern":"^[a-z][a-z0-9:_-]{0,63}$"},"multiple":{"type":"boolean"}},"required":["name","selector"],"additionalProperties":false}},"recordSelector":{"type":"string","minLength":1,"maxLength":256},"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"primaryKeyFields":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"}},"onInvalid":{"default":"retain_with_errors","type":"string","enum":["retain_with_errors","reject_record"]},"existingDatasetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"discoverPages":{"default":false,"type":"boolean"},"includePatterns":{"default":[],"maxItems":24,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"excludePatterns":{"default":[],"maxItems":24,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"renderMode":{"default":"auto","type":"string","enum":["never","auto","always"]}},"required":["sourceUrls"],"additionalProperties":false}},"required":["name","kind","inputs"],"additionalProperties":false},{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"default":"","type":"string","maxLength":800},"budget":{"default":{},"type":"object","properties":{"maxPages":{"type":"integer","minimum":1,"maximum":200},"maxRequests":{"type":"integer","minimum":1,"maximum":500},"maxFetchedBytes":{"type":"integer","minimum":1024,"maximum":300000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30},"maxDurationMs":{"type":"integer","minimum":1000,"maximum":1800000},"maxArtifactsBytes":{"type":"integer","minimum":1024,"maximum":500000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000},"maxModelTokens":{"type":"integer","minimum":0,"maximum":20000}},"additionalProperties":false},"kind":{"type":"string","const":"knowledge_base"},"inputs":{"type":"object","properties":{"sourceUrls":{"maxItems":25,"type":"array","items":{"type":"string","maxLength":2048}},"sourceArtifacts":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^a_[a-f0-9]{64}$"}},"goal":{"default":"rag","type":"string","enum":["rag","reference"]},"includePatterns":{"default":[],"maxItems":24,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"excludePatterns":{"default":[],"maxItems":24,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"useSitemaps":{"default":true,"type":"boolean"},"maxDepth":{"default":2,"type":"integer","minimum":0,"maximum":4},"chunkStrategy":{"default":"section","type":"string","enum":["section","fixed"]},"maxTokensPerChunk":{"default":512,"type":"integer","minimum":64,"maximum":4096},"overlapTokens":{"default":32,"type":"integer","minimum":0,"maximum":512},"renderMode":{"default":"auto","type":"string","enum":["never","auto","always"]}},"additionalProperties":false}},"required":["name","kind","inputs"],"additionalProperties":false},{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"default":"","type":"string","maxLength":800},"budget":{"default":{},"type":"object","properties":{"maxPages":{"type":"integer","minimum":1,"maximum":200},"maxRequests":{"type":"integer","minimum":1,"maximum":500},"maxFetchedBytes":{"type":"integer","minimum":1024,"maximum":300000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30},"maxDurationMs":{"type":"integer","minimum":1000,"maximum":1800000},"maxArtifactsBytes":{"type":"integer","minimum":1024,"maximum":500000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000},"maxModelTokens":{"type":"integer","minimum":0,"maximum":20000}},"additionalProperties":false},"kind":{"type":"string","const":"competitive_intel"},"inputs":{"type":"object","properties":{"competitors":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"website":{"type":"string","maxLength":2048},"pages":{"maxItems":25,"type":"array","items":{"type":"string","maxLength":2048}}},"required":["name","website"],"additionalProperties":false}},"ownSite":{"type":"string","maxLength":2048},"focus":{"default":"all","type":"string","enum":["pricing","features","changelog","all"]},"cadence":{"default":"one_off","type":"string","enum":["one_off","daily","weekly","monthly"]},"relevantPathsOnly":{"default":true,"type":"boolean"},"renderMode":{"default":"auto","type":"string","enum":["never","auto","always"]}},"required":["competitors"],"additionalProperties":false}},"required":["name","kind","inputs"],"additionalProperties":false}]},"suggest":{"type":"boolean","default":false},"useModel":{"type":"boolean","default":false}}}}}},"responses":{"200":{"description":"Workflow result","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/api/v1/workflows/{workflowId}":{"get":{"operationId":"getWorkflow","tags":["Workflows"],"summary":"Read a workflow revision","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"revision","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Workflow result","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}},"patch":{"operationId":"reviseWorkflow","tags":["Workflows"],"summary":"Save a new workflow revision","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["expectedRevision","configuration"],"properties":{"expectedRevision":{"type":"integer","minimum":1},"configuration":{"$schema":"https://json-schema.org/draft/2020-12/schema","oneOf":[{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"default":"","type":"string","maxLength":800},"budget":{"default":{},"type":"object","properties":{"maxPages":{"type":"integer","minimum":1,"maximum":200},"maxRequests":{"type":"integer","minimum":1,"maximum":500},"maxFetchedBytes":{"type":"integer","minimum":1024,"maximum":300000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30},"maxDurationMs":{"type":"integer","minimum":1000,"maximum":1800000},"maxArtifactsBytes":{"type":"integer","minimum":1024,"maximum":500000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000},"maxModelTokens":{"type":"integer","minimum":0,"maximum":20000}},"additionalProperties":false},"kind":{"type":"string","const":"deep_research"},"inputs":{"type":"object","properties":{"question":{"type":"string","minLength":8,"maxLength":1500},"sourceUrls":{"maxItems":25,"type":"array","items":{"type":"string","maxLength":2048}},"sourceArtifacts":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^a_[a-f0-9]{64}$"}},"allowedDomains":{"default":[],"maxItems":25,"type":"array","items":{"type":"string","maxLength":253}},"requiredDomains":{"default":[],"maxItems":25,"type":"array","items":{"type":"string","maxLength":253}},"excludedDomains":{"default":[],"maxItems":25,"type":"array","items":{"type":"string","maxLength":253}},"depth":{"default":"quick","type":"string","enum":["quick","thorough","comprehensive"]},"minimumSources":{"default":2,"type":"integer","minimum":1,"maximum":20},"language":{"type":"string","pattern":"^[a-z]{2}(?:-[A-Z]{2})?$"},"region":{"type":"string","pattern":"^[a-zA-Z]{2}$"},"timeframe":{"type":"string","maxLength":120},"reportSections":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"mode":{"default":"report","type":"string","enum":["report","dossier"]},"synthesis":{"type":"string","enum":["extractive","model"]},"renderMode":{"default":"auto","type":"string","enum":["never","auto","always"]}},"required":["question"],"additionalProperties":false}},"required":["name","kind","inputs"],"additionalProperties":false},{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"default":"","type":"string","maxLength":800},"budget":{"default":{},"type":"object","properties":{"maxPages":{"type":"integer","minimum":1,"maximum":200},"maxRequests":{"type":"integer","minimum":1,"maximum":500},"maxFetchedBytes":{"type":"integer","minimum":1024,"maximum":300000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30},"maxDurationMs":{"type":"integer","minimum":1000,"maximum":1800000},"maxArtifactsBytes":{"type":"integer","minimum":1024,"maximum":500000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000},"maxModelTokens":{"type":"integer","minimum":0,"maximum":20000}},"additionalProperties":false},"kind":{"type":"string","const":"structured_dataset"},"inputs":{"type":"object","properties":{"sourceUrls":{"maxItems":25,"type":"array","items":{"type":"string","maxLength":2048}},"preset":{"type":"string","enum":["general","product","business","article","event","job"]},"fields":{"default":[],"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"},"selector":{"type":"string","minLength":1,"maxLength":256},"attribute":{"type":"string","pattern":"^[a-z][a-z0-9:_-]{0,63}$"},"multiple":{"type":"boolean"}},"required":["name","selector"],"additionalProperties":false}},"recordSelector":{"type":"string","minLength":1,"maxLength":256},"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"primaryKeyFields":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"}},"onInvalid":{"default":"retain_with_errors","type":"string","enum":["retain_with_errors","reject_record"]},"existingDatasetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"discoverPages":{"default":false,"type":"boolean"},"includePatterns":{"default":[],"maxItems":24,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"excludePatterns":{"default":[],"maxItems":24,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"renderMode":{"default":"auto","type":"string","enum":["never","auto","always"]}},"required":["sourceUrls"],"additionalProperties":false}},"required":["name","kind","inputs"],"additionalProperties":false},{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"default":"","type":"string","maxLength":800},"budget":{"default":{},"type":"object","properties":{"maxPages":{"type":"integer","minimum":1,"maximum":200},"maxRequests":{"type":"integer","minimum":1,"maximum":500},"maxFetchedBytes":{"type":"integer","minimum":1024,"maximum":300000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30},"maxDurationMs":{"type":"integer","minimum":1000,"maximum":1800000},"maxArtifactsBytes":{"type":"integer","minimum":1024,"maximum":500000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000},"maxModelTokens":{"type":"integer","minimum":0,"maximum":20000}},"additionalProperties":false},"kind":{"type":"string","const":"knowledge_base"},"inputs":{"type":"object","properties":{"sourceUrls":{"maxItems":25,"type":"array","items":{"type":"string","maxLength":2048}},"sourceArtifacts":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^a_[a-f0-9]{64}$"}},"goal":{"default":"rag","type":"string","enum":["rag","reference"]},"includePatterns":{"default":[],"maxItems":24,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"excludePatterns":{"default":[],"maxItems":24,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"useSitemaps":{"default":true,"type":"boolean"},"maxDepth":{"default":2,"type":"integer","minimum":0,"maximum":4},"chunkStrategy":{"default":"section","type":"string","enum":["section","fixed"]},"maxTokensPerChunk":{"default":512,"type":"integer","minimum":64,"maximum":4096},"overlapTokens":{"default":32,"type":"integer","minimum":0,"maximum":512},"renderMode":{"default":"auto","type":"string","enum":["never","auto","always"]}},"additionalProperties":false}},"required":["name","kind","inputs"],"additionalProperties":false},{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"default":"","type":"string","maxLength":800},"budget":{"default":{},"type":"object","properties":{"maxPages":{"type":"integer","minimum":1,"maximum":200},"maxRequests":{"type":"integer","minimum":1,"maximum":500},"maxFetchedBytes":{"type":"integer","minimum":1024,"maximum":300000000},"maxRenderedPages":{"type":"integer","minimum":0,"maximum":30},"maxDurationMs":{"type":"integer","minimum":1000,"maximum":1800000},"maxArtifactsBytes":{"type":"integer","minimum":1024,"maximum":500000000},"maxProviderUnits":{"type":"integer","minimum":0,"maximum":1000},"maxModelTokens":{"type":"integer","minimum":0,"maximum":20000}},"additionalProperties":false},"kind":{"type":"string","const":"competitive_intel"},"inputs":{"type":"object","properties":{"competitors":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"website":{"type":"string","maxLength":2048},"pages":{"maxItems":25,"type":"array","items":{"type":"string","maxLength":2048}}},"required":["name","website"],"additionalProperties":false}},"ownSite":{"type":"string","maxLength":2048},"focus":{"default":"all","type":"string","enum":["pricing","features","changelog","all"]},"cadence":{"default":"one_off","type":"string","enum":["one_off","daily","weekly","monthly"]},"relevantPathsOnly":{"default":true,"type":"boolean"},"renderMode":{"default":"auto","type":"string","enum":["never","auto","always"]}},"required":["competitors"],"additionalProperties":false}},"required":["name","kind","inputs"],"additionalProperties":false}]}}}}}},"responses":{"200":{"description":"Workflow result","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}},"delete":{"operationId":"archiveWorkflow","tags":["Workflows"],"summary":"Archive a workflow","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Workflow result","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/api/v1/workflows/{workflowId}/runs":{"get":{"operationId":"workflowHistory","tags":["Workflows"],"summary":"List runs for a workflow","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Workflow result","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"startWorkflow","tags":["Workflows"],"summary":"Run a saved workflow revision","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"overrides":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}}}},"responses":{"202":{"description":"Workflow queued","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/api/v1/workflows/{workflowId}/schedule":{"get":{"operationId":"getWorkflowSchedule","tags":["Workflows"],"summary":"Read a workflow schedule","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Workflow result","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}},"put":{"operationId":"scheduleWorkflow","tags":["Workflows"],"summary":"Set a workflow schedule","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["enabled"],"properties":{"enabled":{"type":"boolean"},"intervalMinutes":{"type":"integer","minimum":60,"maximum":43200},"revision":{"type":"integer","minimum":1}}}}}},"responses":{"200":{"description":"Workflow result","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}},"delete":{"operationId":"pauseWorkflow","tags":["Workflows"],"summary":"Pause a workflow schedule","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Workflow result","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/api/v1/workflow-runs":{"get":{"operationId":"listWorkflowRuns","tags":["Workflows"],"summary":"List recent workflow runs","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Workflow result","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/api/v1/workflow-runs/{runId}":{"get":{"operationId":"getWorkflowRun","tags":["Workflows"],"summary":"Read workflow status and results","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Workflow result","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/api/v1/workflow-runs/{runId}/events":{"get":{"operationId":"workflowEvents","tags":["Workflows"],"summary":"Read ordered run events","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Workflow result","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/api/v1/workflow-runs/{runId}/cancel":{"post":{"operationId":"cancelWorkflow","tags":["Workflows"],"summary":"Cancel a run","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Workflow result","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/api/v1/workflow-runs/{runId}/dataset":{"post":{"operationId":"publishDatasetVersion","tags":["Workflows"],"summary":"Save records as an immutable dataset version","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["name"],"additionalProperties":false,"properties":{"name":{"type":"string","maxLength":120}}},{"type":"object","required":["datasetId"],"additionalProperties":false,"properties":{"datasetId":{"type":"string","format":"uuid"}}}]}}}},"responses":{"200":{"description":"Workflow result","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/api/v1/workflow-runs/{runId}/records":{"get":{"operationId":"getWorkflowRecords","tags":["Workflows"],"summary":"Browse exported records and provenance","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"after","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Workflow result","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/api/v1/workflow-runs/{runId}/compare":{"get":{"operationId":"compareDatasetVersions","tags":["Workflows"],"summary":"Compare a dataset run with a verified baseline","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"baselineRunId","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Workflow result","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/api/v1/workflow-runs/{runId}/deliverables":{"get":{"operationId":"workflowFiles","tags":["Workflows"],"summary":"List verified files","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Workflow result","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/api/v1/workflow-runs/{runId}/deliverables/{artifactId}":{"get":{"operationId":"downloadWorkflowFile","tags":["Workflows"],"summary":"Open a signed file download or read a byte range","description":"Requires the workflows:run API key scope.","security":[{"ListaroKey":[]}],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"artifactId","in":"path","required":true,"schema":{"type":"string","pattern":"^a_[a-f0-9]{64}$"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limitBytes","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Base64 byte range when an offset or limitBytes is supplied","content":{"application/json":{"schema":{"type":"object"}}}},"303":{"description":"Short-lived signed download","headers":{"Location":{"schema":{"type":"string","format":"uri"}}}},"default":{"$ref":"#/components/responses/Error"}}}}},"components":{"securitySchemes":{"ListaroKey":{"type":"http","scheme":"bearer","bearerFormat":"Listaro scoped API key"}},"responses":{"Error":{"description":"A structured error. Check its code and operation history before retrying an uncertain execution.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}}}}}}}}}}}