Web Tasks

​

What are Web Tasks?

• Scraping a directory.
• Filling a multi-page form.
• Downloading a batch of files.
• Pulling data out of a table.

​

When to use Web Tasks

• The task benefits from generated code, such as crawling pages, extracting data across many entities, repeated multi-step actions.
• You’ll run the same task (or variations of it) more than once. The payoff comes from reuse.
• You want the API to write and maintain the automation for you instead of owning the code yourself.

• You want to run the deterministic code without AI in the loop, or you want to control exactly when AI is involved.
• You want to write, debug, and own the automation code yourself, in the online IDE or locally with the CLI.
• You need full visibility into the code and every execution, such as browser traces, logs, and attempt timeline.
• You want advanced issue monitoring and auto-maintenance via self-healing projects.
• You need platform features like AuthSessions, Jobs and scheduling, or Sinks.

​

Core concepts

​

Start and result

• POST /{workspaceId}/web-tasks/start - submit the task. Returns a webTaskId immediately.
• GET /{workspaceId}/web-tasks/{webTaskId}/result - poll for status and result.

​

Request fields

​

Status model

• pending: created, not yet executing.
• started: executing.
• completed: finished. The response includes an outcome of success or failed.

​

Result delivery

• Inline: small outputs (booleans, short text, small arrays, small objects) come back directly in the response under result.data.
• File: large outputs come back as a downloadable URL under result.file, often with a preview (row count and a small sample). File URLs are signed and expire after 7 days.

​

Cost

• cost.aiUsd: AI/model cost in dollars.
• cost.compute: runtime compute usage in hours.

​

Reuse and the reuseKey

​

Example

import { IntunedClient } from "@intuned/client";

const client = new IntunedClient({
  apiKey: "<YOUR_API_KEY>",
  workspaceId: "<YOUR_WORKSPACE_ID>",
});

const result = await client.webTasks.run(
  {
    task: "Scrape companies from the YC directory",
    startUrl: "https://www.ycombinator.com/companies",
    parameters: { batch: "S24" },
    reuseKey: "yc_companies",
  },
  { pollIntervalMs: 5000, timeoutMs: 10 * 60 * 1000 },
);

console.log(result.status, result.outcome);

# Start a task
curl -X POST "https://api.intuned.io/{workspaceId}/web-tasks/start" \
  -H "x-api-key: $INTUNED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "Scrape companies from the YC directory",
    "startUrl": "https://www.ycombinator.com/companies",
    "parameters": { "batch": "S24" },
    "reuseKey": "yc_companies"
  }'

# Poll for the result
curl "https://api.intuned.io/{workspaceId}/web-tasks/{webTaskId}/result" \
  -H "x-api-key: $INTUNED_API_KEY"

​

Example responses

{
  "webTaskId": "wt_123",
  "status": "completed",
  "outcome": "success",
  "result": {
    "type": "inline",
    "data": [
      {
        "name": "ExampleCo",
        "batch": "S24",
        "url": "https://www.ycombinator.com/companies/exampleco"
      }
    ]
  },
  "reuse": {
    "key": "yc_companies",
    "used": false,
    "created": true,
    "updated": true
  },
  "cost": {
    "aiUsd": 0.42,
    "compute": { "unit": "hours", "amount": 0.023 }
  }
}

​

Cost and billing

​

Limits

• Each workspace can run up to 10 different Web Tasks concurrently (Contact support if you need a higher limit).
• Same-reuseKey runs are serialized: runs that share a reuseKey execute one at a time so two runs don’t update the same code concurrently. Runs with different keys can run in parallel.
• Failed runs return outcome: "failed" with an error.code. Possible codes: workspace-rate-limited, unauthenticated, no-ai-credits-left, timeout, rejected, internal-error.

​

FAQ

​

Next steps