Quickstart

This quickstart uses the REST API so it works before the SDK packages reach their registries. You will create a server-side key, start a browser task, and poll the durable run until it finishes.

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 flow repeatable

Build an ordered workflow with named outputs.

Use a published automation

Run an immutable Blueprint revision.

Add an SDK

Use the TypeScript or Python client after package release.

Review production behavior

Handle retries, timeouts, and terminal failures.

Get started

Build automations

Production

Prerequisites

Read the result

Make the flow repeatable

Use a published automation

Add an SDK

Review production behavior

​Prerequisites

​Read the result

Make the flow repeatable

Use a published automation

Add an SDK

Review production behavior

Prerequisites

Read the result