{"info":{"name":"Listaro hosted API","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json","description":"Nineteen canonical operations. Supply a scoped API key in a private local environment. Replace fixture IDs with real workspace resource IDs. Set a fresh idempotencyKey for new work and retain it for retries. Use a workflow-scoped key with the Workflows requests."},"auth":{"type":"bearer","bearer":[{"key":"token","value":"{{apiKey}}","type":"string"}]},"variable":[{"key":"baseUrl","value":"https://listaro.vercel.app"},{"key":"apiKey","value":"","type":"string"},{"key":"idempotencyKey","value":"replace-for-each-new-operation"}],"item":[{"name":"Workflows","item":[{"name":"List workflow templates","request":{"method":"GET","url":"{{baseUrl}}/api/v1/workflows/templates","header":[]}},{"name":"List saved workflows","request":{"method":"GET","url":"{{baseUrl}}/api/v1/workflows","header":[]}},{"name":"Create a saved workflow","request":{"method":"POST","url":"{{baseUrl}}/api/v1/workflows","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"kind\": \"knowledge_base\",\n  \"name\": \"Knowledge Base Builder\",\n  \"inputs\": {\n    \"sourceUrls\": [\n      \"https://docs.python.org/3/tutorial/\"\n    ],\n    \"sourceArtifacts\": [],\n    \"goal\": \"rag\",\n    \"includePatterns\": [],\n    \"excludePatterns\": [],\n    \"useSitemaps\": true,\n    \"maxDepth\": 2,\n    \"chunkStrategy\": \"section\",\n    \"maxTokensPerChunk\": 512,\n    \"overlapTokens\": 32,\n    \"renderMode\": \"auto\"\n  }\n}"}}},{"name":"Preview dataset records from the first starting page","request":{"method":"POST","url":"{{baseUrl}}/api/v1/workflows/dataset-preview","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"configuration\": {\n    \"kind\": \"structured_dataset\",\n    \"name\": \"Structured Dataset Builder\",\n    \"inputs\": {\n      \"sourceUrls\": [\n        \"https://books.toscrape.com/\"\n      ],\n      \"preset\": \"product\",\n      \"fields\": [],\n      \"primaryKeyFields\": [],\n      \"onInvalid\": \"retain_with_errors\",\n      \"discoverPages\": false,\n      \"includePatterns\": [],\n      \"excludePatterns\": [],\n      \"renderMode\": \"auto\"\n    }\n  },\n  \"suggest\": true\n}"}}},{"name":"Read a workflow revision","request":{"method":"GET","url":"{{baseUrl}}/api/v1/workflows/{{workflowId}}","header":[]}},{"name":"Save a new workflow revision","request":{"method":"PATCH","url":"{{baseUrl}}/api/v1/workflows/{{workflowId}}","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"expectedRevision\": 1,\n  \"configuration\": {\n    \"kind\": \"knowledge_base\",\n    \"name\": \"Knowledge Base Builder\",\n    \"inputs\": {\n      \"sourceUrls\": [\n        \"https://docs.python.org/3/tutorial/\"\n      ],\n      \"sourceArtifacts\": [],\n      \"goal\": \"rag\",\n      \"includePatterns\": [],\n      \"excludePatterns\": [],\n      \"useSitemaps\": true,\n      \"maxDepth\": 2,\n      \"chunkStrategy\": \"section\",\n      \"maxTokensPerChunk\": 512,\n      \"overlapTokens\": 32,\n      \"renderMode\": \"auto\"\n    }\n  }\n}"}}},{"name":"Archive a workflow","request":{"method":"DELETE","url":"{{baseUrl}}/api/v1/workflows/{{workflowId}}","header":[]}},{"name":"List runs for a workflow","request":{"method":"GET","url":"{{baseUrl}}/api/v1/workflows/{{workflowId}}/runs","header":[]}},{"name":"Run a saved workflow revision","request":{"method":"POST","url":"{{baseUrl}}/api/v1/workflows/{{workflowId}}/runs","header":[{"key":"Idempotency-Key","value":"{{idempotencyKey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"revision\": 1\n}"}}},{"name":"Read a workflow schedule","request":{"method":"GET","url":"{{baseUrl}}/api/v1/workflows/{{workflowId}}/schedule","header":[]}},{"name":"Set a workflow schedule","request":{"method":"PUT","url":"{{baseUrl}}/api/v1/workflows/{{workflowId}}/schedule","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"enabled\": true,\n  \"intervalMinutes\": 1440\n}"}}},{"name":"Pause a workflow schedule","request":{"method":"DELETE","url":"{{baseUrl}}/api/v1/workflows/{{workflowId}}/schedule","header":[]}},{"name":"List recent workflow runs","request":{"method":"GET","url":"{{baseUrl}}/api/v1/workflow-runs","header":[]}},{"name":"Read workflow status and results","request":{"method":"GET","url":"{{baseUrl}}/api/v1/workflow-runs/{{runId}}","header":[]}},{"name":"Read ordered run events","request":{"method":"GET","url":"{{baseUrl}}/api/v1/workflow-runs/{{runId}}/events","header":[]}},{"name":"Cancel a run","request":{"method":"POST","url":"{{baseUrl}}/api/v1/workflow-runs/{{runId}}/cancel","header":[]}},{"name":"Save records as an immutable dataset version","request":{"method":"POST","url":"{{baseUrl}}/api/v1/workflow-runs/{{runId}}/dataset","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"name\": \"Verified sources\"\n}"}}},{"name":"Browse exported records and provenance","request":{"method":"GET","url":"{{baseUrl}}/api/v1/workflow-runs/{{runId}}/records","header":[]}},{"name":"Compare a dataset run with a verified baseline","request":{"method":"GET","url":"{{baseUrl}}/api/v1/workflow-runs/{{runId}}/compare","header":[]}},{"name":"List verified files","request":{"method":"GET","url":"{{baseUrl}}/api/v1/workflow-runs/{{runId}}/deliverables","header":[]}},{"name":"Open a signed file download or read a byte range","request":{"method":"GET","url":"{{baseUrl}}/api/v1/workflow-runs/{{runId}}/deliverables/{{artifactId}}","header":[]}}]},{"name":"list_extraction_presets","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":"{{baseUrl}}/api/v1/operations/list_extraction_presets","description":"List the six source-observed extraction presets and their field schemas. Scope: list_extraction_presets","body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}}}},{"name":"crawl_site","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Idempotency-Key","value":"{{idempotencyKey}}"}],"url":"{{baseUrl}}/api/v1/operations/crawl_site","description":"Queue an exact-origin durable crawl with bounded budgets, robots policies, recovery and source evidence. Scope: crawl_site","body":{"mode":"raw","raw":"{\n  \"seedUrl\": \"https://example.org\",\n  \"maxPages\": 5,\n  \"maxDepth\": 1,\n  \"renderMode\": \"never\",\n  \"useSitemaps\": true\n}","options":{"raw":{"language":"json"}}}}},{"name":"get_job","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":"{{baseUrl}}/api/v1/operations/get_job","description":"Get durable lifecycle, attempts, cancellation, progress counts and result references. Scope: get_job","body":{"mode":"raw","raw":"{\n  \"jobId\": \"11111111-1111-4111-8111-111111111111\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"get_crawl","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":"{{baseUrl}}/api/v1/operations/get_crawl","description":"Read source-backed crawl pages with stable cursor pagination and verified artifacts. Scope: get_crawl","body":{"mode":"raw","raw":"{\n  \"crawlId\": \"11111111-1111-4111-8111-111111111111\",\n  \"limit\": 20\n}","options":{"raw":{"language":"json"}}}}},{"name":"create_watch","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Idempotency-Key","value":"{{idempotencyKey}}"}],"url":"{{baseUrl}}/api/v1/operations/create_watch","description":"Save a watch definition with automatic scheduling OFF. Scope: create_watch","body":{"mode":"raw","raw":"{\n  \"seedUrl\": \"https://example.org\",\n  \"maxPages\": 5,\n  \"maxDepth\": 1,\n  \"renderMode\": \"never\",\n  \"useSitemaps\": true,\n  \"intervalMinutes\": 1440\n}","options":{"raw":{"language":"json"}}}}},{"name":"check_watch","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Idempotency-Key","value":"{{idempotencyKey}}"}],"url":"{{baseUrl}}/api/v1/operations/check_watch","description":"Coalesce and queue a manual baseline or change check. Scope: check_watch","body":{"mode":"raw","raw":"{\n  \"watchId\": \"11111111-1111-4111-8111-111111111111\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"set_watch_schedule","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":"{{baseUrl}}/api/v1/operations/set_watch_schedule","description":"Explicitly enable or disable a persisted watch schedule. Scope: set_watch_schedule","body":{"mode":"raw","raw":"{\n  \"watchId\": \"11111111-1111-4111-8111-111111111111\",\n  \"enabled\": false,\n  \"intervalMinutes\": 1440\n}","options":{"raw":{"language":"json"}}}}},{"name":"list_watches","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":"{{baseUrl}}/api/v1/operations/list_watches","description":"List saved watches with bounded pagination. Scope: list_watches","body":{"mode":"raw","raw":"{\n  \"limit\": 20\n}","options":{"raw":{"language":"json"}}}}},{"name":"compare_crawls","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Idempotency-Key","value":"{{idempotencyKey}}"}],"url":"{{baseUrl}}/api/v1/operations/compare_crawls","description":"Compare all observed pages from same-origin snapshots; missing observations never assert deletion. Scope: compare_crawls","body":{"mode":"raw","raw":"{\n  \"beforeRunId\": \"11111111-1111-4111-8111-111111111111\",\n  \"afterRunId\": \"22222222-2222-4222-8222-222222222222\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"get_change_report","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":"{{baseUrl}}/api/v1/operations/get_change_report","description":"Read a saved source-backed watch comparison with pagination. Scope: get_change_report","body":{"mode":"raw","raw":"{\n  \"reportId\": \"11111111-1111-4111-8111-111111111111\",\n  \"limit\": 20\n}","options":{"raw":{"language":"json"}}}}},{"name":"scrape_page","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Idempotency-Key","value":"{{idempotencyKey}}"}],"url":"{{baseUrl}}/api/v1/operations/scrape_page","description":"Acquire a page once and return Markdown, HTML, JSON, links, metadata, images or screenshot artifacts. Scope: scrape_page","body":{"mode":"raw","raw":"{\n  \"url\": \"https://example.org\",\n  \"formats\": [\n    \"markdown\",\n    \"metadata\",\n    \"images\"\n  ],\n  \"renderMode\": \"never\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"map_site","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Idempotency-Key","value":"{{idempotencyKey}}"}],"url":"{{baseUrl}}/api/v1/operations/map_site","description":"Discover exact-scope URLs from sitemaps and a bounded link sample; discovered URLs are not verified page fetches. Scope: map_site","body":{"mode":"raw","raw":"{\n  \"url\": \"https://example.org\",\n  \"maxUrls\": 20,\n  \"maxDepth\": 2,\n  \"useSitemaps\": true\n}","options":{"raw":{"language":"json"}}}}},{"name":"scrape_batch","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Idempotency-Key","value":"{{idempotencyKey}}"}],"url":"{{baseUrl}}/api/v1/operations/scrape_batch","description":"Queue 1–1000 input-order page results with isolated failures, retries and cancellation. Scope: scrape_batch","body":{"mode":"raw","raw":"{\n  \"urls\": [\n    \"https://example.org\"\n  ],\n  \"formats\": [\n    \"markdown\",\n    \"metadata\"\n  ],\n  \"renderMode\": \"never\",\n  \"maxConcurrency\": 2\n}","options":{"raw":{"language":"json"}}}}},{"name":"get_artifact","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":"{{baseUrl}}/api/v1/operations/get_artifact","description":"Read a checksum-verified local artifact with bounded UTF-8 or base64 ranges. Scope: get_artifact","body":{"mode":"raw","raw":"{\n  \"artifactId\": \"a_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n  \"offset\": 0,\n  \"limitBytes\": 32768\n}","options":{"raw":{"language":"json"}}}}},{"name":"cancel_job","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":"{{baseUrl}}/api/v1/operations/cancel_job","description":"Idempotently cancel a queued or running local job while preserving completed evidence. Scope: cancel_job","body":{"mode":"raw","raw":"{\n  \"jobId\": \"11111111-1111-4111-8111-111111111111\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"parse_document","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Idempotency-Key","value":"{{idempotencyKey}}"}],"url":"{{baseUrl}}/api/v1/operations/parse_document","description":"Parse PDF, DOCX, XLSX, HTML or TXT with source evidence, page/sheet metadata and resource limits. Scope: parse_document","body":{"mode":"raw","raw":"{\n  \"url\": \"https://example.org/example.pdf\",\n  \"formats\": [\n    \"markdown\",\n    \"text\"\n  ],\n  \"maxBytes\": 1000000\n}","options":{"raw":{"language":"json"}}}}},{"name":"browser_session","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Idempotency-Key","value":"{{idempotencyKey}}"}],"url":"{{baseUrl}}/api/v1/operations/browser_session","description":"Create, inspect or close an ephemeral browser context with TTL and resource limits. Scope: browser_session","body":{"mode":"raw","raw":"{\n  \"action\": \"create\",\n  \"initialUrl\": \"https://example.org\",\n  \"ttlSeconds\": 120\n}","options":{"raw":{"language":"json"}}}}},{"name":"browser_action","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Idempotency-Key","value":"{{idempotencyKey}}"}],"url":"{{baseUrl}}/api/v1/operations/browser_action","description":"Navigate, click, fill, scroll, wait, snapshot or screenshot in an authorized guarded browser session. Scope: browser_action","body":{"mode":"raw","raw":"{\n  \"sessionId\": \"11111111-1111-4111-8111-111111111111\",\n  \"action\": \"snapshot\",\n  \"timeoutMs\": 3000\n}","options":{"raw":{"language":"json"}}}}},{"name":"search_web","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Idempotency-Key","value":"{{idempotencyKey}}"}],"url":"{{baseUrl}}/api/v1/operations/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. Scope: search_web","body":{"mode":"raw","raw":"{\n  \"query\": \"Open-source crawling tools\",\n  \"limit\": 5\n}","options":{"raw":{"language":"json"}}}}}]}