---
title: Agent runs
description: Provision and control agent sandbox runs.
canonical_url: https://wiblo.app/docs/developers/api/agent-runs
last_updated: 2026-07-28T18:08:25+02:00
md_url: https://wiblo.app/docs/developers/api/agent-runs.md
---

# Agent runs

## Endpoints

- `GET` [List agent runs](/docs/developers/api/agent-runs/list-agent-runs) — `/v1/workspaces/{workspaceId}/agent-runs`
- `POST` [Create agent run](/docs/developers/api/agent-runs/create-agent-run) — `/v1/agent-runs`
- `GET` [Get agent run](/docs/developers/api/agent-runs/get-agent-run) — `/v1/agent-runs/{runId}`
- `GET` [Get agent run events](/docs/developers/api/agent-runs/get-agent-run-events) — `/v1/agent-runs/{runId}/events`
- `POST` [Ingest agent run events](/docs/developers/api/agent-runs/ingest-agent-run-events) — `/v1/agent-runs/{runId}/events/ingest`
- `GET` [Get agent run runtime status](/docs/developers/api/agent-runs/get-agent-run-runtime-status) — `/v1/agent-runs/{runId}/runtime-status`
- `GET` [Get agent run dev status](/docs/developers/api/agent-runs/get-agent-run-dev-status) — `/v1/agent-runs/{runId}/dev-status`
- `POST` [Stop agent sandbox](/docs/developers/api/agent-runs/stop-agent-sandbox) — `/v1/agent-runs/{runId}/sandbox/stop`
- `POST` [Snapshot agent sandbox](/docs/developers/api/agent-runs/snapshot-agent-sandbox) — `/v1/agent-runs/{runId}/sandbox/snapshot`
- `POST` [Interrupt agent run](/docs/developers/api/agent-runs/interrupt-agent-run) — `/v1/agent-runs/{runId}/interrupt`
- `POST` [Keepalive agent run](/docs/developers/api/agent-runs/keepalive-agent-run) — `/v1/agent-runs/{runId}/keepalive`
- `POST` [End agent run](/docs/developers/api/agent-runs/end-agent-run) — `/v1/agent-runs/{runId}/end`
- `POST` [Prewarm agent run](/docs/developers/api/agent-runs/prewarm-agent-run) — `/v1/agent-runs/{runId}/prewarm`