Browser tasks

A browser task is the smallest way to ask Infragrid to explore a site and return a result. Use it when the route through the site is not known in advance.

Public cloud browser tasks are read-only jobs, not directly connectable Playwright or CDP sessions. They use a clean, ephemeral browser without local cookies or signed-in sessions. Approval-requiring actions, credentials, payments, destructive controls, and external submissions fail closed. Use the desktop product for work that needs an existing local session or direct human control.

Start a task

const created = await client.runs.create({
  task: "Find the pricing page and summarize the plans.",
  metadata: { customerId: "cust_123" },
  idempotencyKey: "pricing-summary-cust-123-v1"
})

const finished = await client.runs.wait(created.id)
console.log(finished.result?.summary)

created = client.runs.create(
    task="Find the pricing page and summarize the plans.",
    metadata={"customerId": "cust_123"},
    idempotency_key="pricing-summary-cust-123-v1",
)
finished = client.runs.wait(created["id"])
print(finished["result"]["summary"])

curl --request POST \
  --url https://agent.infragrid.ai/v1/runs \
  --header "Authorization: Bearer $INFRAGRID_API_KEY" \
  --header "Content-Type: application/json" \
  --header "X-Idempotency-Key: pricing-summary-cust-123-v1" \
  --data '{"task":"Find the pricing page and summarize the plans.","metadata":{"customerId":"cust_123"}}'

Lifecycle

queued → running → completed, failed, or cancelled The create call returns as soon as the run is durably accepted. Poll GET /v1/runs/{run_id}, use an SDK wait helper, or recover the same run later by ID.

Task-writing guidance

State the desired outcome and important constraints.
Name the target site or starting URL when known.
Ask for a bounded, inspectable result.
Keep credentials out of the task string and metadata.
Use an ordered workflow when exact sequencing matters.

Metadata

Metadata is application-defined JSON returned with the run. Use it for safe correlation values such as a customer ID, job name, or environment. The serialized object is limited to 16 KB.

Metadata and the resolved task are stored with the cloud run. Do not place passwords, session cookies, API keys, or extracted secrets in either field.

Cancel a run

Cancellation is idempotent. A run that is already terminal returns its terminal state.

const cancelled = await client.runs.cancel(created.id)

cancelled = client.runs.cancel(created["id"])

Get started

Build automations

Production

Start a task

Lifecycle

Task-writing guidance

Metadata

Cancel a run

​Start a task

​Lifecycle

​Task-writing guidance

​Metadata

​Cancel a run

Start a task

Lifecycle

Task-writing guidance

Metadata

Cancel a run