task_update
Update an existing saved Figranium automation task by correcting its name or URL, replacing action sequences, changing variables, stealth settings, extraction script, or schedule, without executing it.
Instructions
Update one or more fields on an existing, saved Figranium browser-automation task.
When to use
Use this after task_list identifies the task to modify—for example, to correct its name or URL, replace its action sequence, change input variables, adjust stealth settings, or revise its extraction script or schedule. The task remains stored under the same taskId and is not executed by this operation.
Required request shape
taskIdis required and must be the ID of an existing task.Include at least one additional field. An ID-only request is rejected because it would make no change.
Every other field is optional: omitted fields are left unchanged.
Repeating the same request is safe and produces the same stored configuration.
Important update behavior
For compound fields—
actions,variables,stealth,translation, andschedule—send the complete value you want stored for that field, rather than only a nested fragment.actionsare an ordered replacement sequence. Useagentorheadfulmode for actions;scrapemode does not support them. Close everyif,while,repeat, orforeachblock with anendaction.Use
{$variable_name}for task-variable references in URLs, headers, bodies, and action values. Do not use{{variable_name}}or${variable_name}.This tool changes saved configuration but does not run or delete a task. Use
task_executeto validate an updated workflow andtask_deleteonly when permanent removal is intended.
Examples
Rename a task: { "taskId": "task_101", "name": "Daily lead extractor" }.
Replace its workflow and output extraction: { "taskId": "task_101", "actions": [{ "type": "wait_selector", "selector": "[data-testid='results']" }], "extractionScript": "return document.title" }.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Initial URL to navigate to when the task starts. Expected type: string. Example: 'https://news.ycombinator.com' | |
| mode | No | Execution mode. Use 'agent' by default, including for scraping, because it supports action blocks. 'scrape' does not support action blocks and is only for exceptional, extremely fast action-free scraping. 'headful' runs in a visible browser window with human oversight. Expected type: string enum. Example: 'agent' | |
| name | No | Descriptive name of the automation task. Expected type: string. Example: 'HackerNews Scraper' | |
| wait | No | Standard delay in seconds to wait after navigation and page loads to let dynamic scripts complete. Expected type: number. Example: 5 | |
| taskId | Yes | ID of the existing task to modify. Get it from task_list. Required; must be a non-empty string. Example: 'task_101'. | |
| actions | No | Sequential list of browser actions/control flow steps to execute. Action blocks require 'agent' or 'headful' mode and are not supported in 'scrape' mode. Note: Variable references MUST use '{$variable_name}' syntax. | |
| stealth | No | Configures realistic stealth, anti-bot, and human behavior simulation on the browser instance. | |
| schedule | No | Task automatic execution schedule. Expected type: object. | |
| selector | No | Default CSS selector to wait for on the page load before starting actions. Expected type: string. Example: '.main-content' | |
| variables | No | Task INPUT variables and caller-overridable configuration only. Do not declare output-only fields or transient runtime state here. Use Set Variable for mid-task state. Expected type: record object of variable configurations. | |
| description | No | Detailed description of what the task automates. Expected type: string. Example: 'Logs in and extracts weekly leads' | |
| humanTyping | No | Vary typing speeds and insert tiny delays to simulate organic human typing. Expected type: boolean. Example: true | |
| includeHtml | No | Whether to include the raw page HTML in the execution response. Expected type: boolean. Example: false | |
| translation | No | Optional page translation for Agent and headful runs. It is disabled by default and is not available in Scrape mode. | |
| rotateProxies | No | Rotate through configured proxy IPs to prevent IP-based rate limiting. Expected type: boolean. Example: false | |
| rotateViewport | No | Vary viewport resolutions randomly to simulate multiple desktop and mobile devices. Expected type: boolean. Example: true | |
| disableRecording | No | Disable video/VNC recording of this task to save storage. Expected type: boolean. Example: true | |
| extractionFormat | No | Target export format of any extracted data. Expected type: string enum. Example: 'json' | json |
| extractionScript | No | Post-execution extraction script for the task's actual final output. Final structured fields, lists, tables, parsing, and extraction logic belong here rather than in task variables or JavaScript action blocks. Expected type: string. Example: 'return Array.from(document.querySelectorAll("a")).map(el => el.href)' | |
| includeShadowDom | No | Whether to parse and resolve target elements residing in Shadow DOMs. Expected type: boolean. Example: true | |
| rotateUserAgents | No | Rotate user agents across requests to avoid pattern blocking and fingerprinting. Expected type: boolean. Example: true | |
| downloadCabinetId | No | Cabinet used for intercepted downloads; omitted uses the default Cabinet. Expected type: string. Example: 'cab_basic' | |
| statelessExecution | No | If set to true, clear browser cookies and session states between runs. Expected type: boolean. Example: false |