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: customer-job-123-v1" \
--data '{
"task": "Open example.com and summarize the page.",
"executionTarget": "cloud",
"metadata": { "source": "api-reference" }
}'
{
"id": "5d7b1f8a-4b20-4ac0-aef2-857a8fd6b9d3",
"status": "queued",
"executionTarget": "cloud"
}
Runs
Create a run
Start one durable ad-hoc task Run.
POST
/
v1
/
runs
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: customer-job-123-v1" \
--data '{
"task": "Open example.com and summarize the page.",
"executionTarget": "cloud",
"metadata": { "source": "api-reference" }
}'
{
"id": "5d7b1f8a-4b20-4ac0-aef2-857a8fd6b9d3",
"status": "queued",
"executionTarget": "cloud"
}
Requires
runs:write. Local execution also requires runs:local; existing keys are not granted this scope automatically. Returns 202 Accepted when the run is durably queued.
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: customer-job-123-v1" \
--data '{
"task": "Open example.com and summarize the page.",
"executionTarget": "cloud",
"metadata": { "source": "api-reference" }
}'
string
Stable mutation key containing 1–255 printable ASCII characters without spaces. Strongly recommended.
string
Free-form browser or computer-use goal. Maximum 20,000 characters.
object
Application-defined correlation metadata. Maximum 16 KB. Defaults to an empty object.
string
cloud (default) runs on Infragrid-managed infrastructure. local queues the task for the API-key owner’s paired, signed-in Infragrid Desktop.Do not place secrets in the task or metadata. Use a Runbook for reusable programmable steps.
Local API runs currently support free-form
task requests. They remain queued until the key owner’s Infragrid Desktop is online, signed in, and connected to the same workspace. The desktop opens a new agent conversation and runs the task on that computer using its local browser context.Response
{
"id": "5d7b1f8a-4b20-4ac0-aef2-857a8fd6b9d3",
"status": "queued",
"executionTarget": "cloud"
}
uuid
required
Durable run identifier.
string
required
Usually
queued or running on acceptance.string
required
local or cloud. Infrastructure providers are intentionally not exposed by the public API.Poll Get a run or use an SDK
wait helper until the run is terminal.Last modified on August 28, 2026