Quickstart

This quickstart uses the REST API directly. You will create a server-side key, start a browser task, and poll the durable run until it finishes. Prefer the TypeScript SDK or Python SDK when you want typed helpers and managed polling.

Prerequisites

An Infragrid workspace
Permission to manage developer API keys
curl and jq

An Infragrid API key is a server credential. Run these commands in a trusted terminal or backend environment—never in browser JavaScript.

Create an API key

Open Developer settings, choose the Browser runs preset, and create a key. Copy the ig_live_… value immediately; it is shown only once.

Export the credential

Store the key in your secret manager for production. For this terminal session:

export INFRAGRID_API_KEY="ig_live_..."

Start a browser task

Use a stable idempotency key for this logical request:

curl --request POST \
  --url https://api.infragrid.ai/v1/runs \
  --header "Authorization: Bearer $INFRAGRID_API_KEY" \
  --header "Content-Type: application/json" \
  --header "X-Idempotency-Key: quickstart-example-summary-v1" \
  --data '{
    "task": "Open example.com and summarize the page.",
    "metadata": { "source": "quickstart" }
  }'

The API returns 202 Accepted with a run whose status is usually queued or running.

Poll the durable run

Copy the returned id and request the run until it reaches completed, failed, or cancelled:

export INFRAGRID_RUN_ID="replace-with-run-id"

curl --silent --show-error \
  --url "https://api.infragrid.ai/v1/runs/$INFRAGRID_RUN_ID" \
  --header "Authorization: Bearer $INFRAGRID_API_KEY" | jq

Read the result

A completed run returns a bounded result:

{
  "id": "run-id",
  "status": "completed",
  "result": {
    "status": "completed",
    "summary": "Example Domain is a placeholder site used in documentation.",
    "steps": 3,
    "browser_actions": 1,
    "final_url": "https://example.com/",
    "outputs": {},
    "events": []
  },
  "step_count": 3
}

Make the task repeatable

Build and publish a programmable Runbook.

Add an SDK

Install the TypeScript or Python client from its public registry.

Review production behavior

Handle retries, timeouts, and terminal failures.

Get started

Build automations

Production

Prerequisites

Read the result

Make the task repeatable

Add an SDK

Review production behavior

​Prerequisites

​Read the result

Make the task repeatable

Add an SDK

Review production behavior

Prerequisites

Read the result