INintunedhq
webTasks

Web Task - Start

Start a Web Task. The task runs asynchronously; poll the result endpoint for status and output.

post/{workspaceId}/web-tasks/start

Request

  • Base URL
    https://app.intuned.io/api/v1/workspace
  • Auth
    API key in header x-api-key

Path parameters

workspaceIdstring uuid required

Your workspace ID. How to find it?

Request body

taskstring required

Natural-language description of what to do.

startUrlstring uri

URL the agent should start from.

parametersobject

Free-form parameters substituted into the task at runtime.

outputSchemaobject

Schema describing the expected output shape. Accepts JSON-Schema-shaped objects as well as Intuned's extended type vocabulary (e.g. { type: 'attachment' }).

reuseKeystring

Caller-provided key that ties this task to a persisted code and resources tree.

model'haiku' | 'sonnet' | 'opus'

Anthropic model the agent should run with. Defaults to 'haiku' when omitted.

proxystring uri

Proxy URL to use for all browser traffic in this task.

authstring

Id of a captured web task auth (recorder-based session). When set, the agent's browser is pre-loaded with that session's storage state so the task runs authenticated.

Example request

{
  "task": "Scrape YC companies from batch S24",
  "startUrl": "https://www.ycombinator.com/companies",
  "parameters": {
    "batch": "S24"
  },
  "reuseKey": "yc_companies"
}

Response

Web task accepted and queued for execution.

webTaskIdstring required

Unique web task id, prefixed nanoid (wt_...).

status'pending' required

Example response

{
  "webTaskId": "wt_123"
}

Changes

No recorded changes to this operation across all 1 revision of this API.