---
title: "Poll next bridge commands"
method: POST
path: "/v1/private/local-runners/{runnerId}/bridge/commands/next"
tags: ["Runners"]
---

# Poll next bridge commands

`POST /v1/private/local-runners/{runnerId}/bridge/commands/next`

Long-poll for pending bridge commands (batch)

## Path parameters

- `runnerId` string, uuid, required

## Request body

- BridgeCommandNextRequest
  - `max_commands` integer

## Response `200`

Commands batch

- BridgeCommandBatchResponse
  - `commands` BridgeCommandItem[]
    - `command_id` string, uuid
    - `type` 'ReadFile' | 'WriteFile' | 'EditFile' | 'ListFiles' | 'SearchFiles' | 'Exec'
    - `args` JsonNode
    - `timeout_seconds` integer
    - `submitted_at` string, date-time

## Other responses

- `404` — Not found

---

[API](https://skmtc.net/comet-ml/apis/opik-rest-api.md) · [All operations](https://skmtc.net/comet-ml/apis/opik-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/comet-ml/opik-rest-api/versions/4ed2fbc97cc3/schema)