Get bridge command | Opik Documentation

GET/v1/private/local-runners/{runnerId}/bridge/commands/{commandId}Get bridge command

Get bridge command status, optionally long-polling for completion

Parameters

runnerIdstring · uuidpathrequired

commandIdstring · uuidpathrequired

waitbooleanquery

default false

timeoutinteger · int32query

default 30

Responses

objectBridgeCommand

argsobject

command_idstring · uuid

completed_atstring · date-time

duration_msinteger · int64

errorobject

picked_up_atstring · date-time

resultobject

runner_idstring · uuid

statusstring

one of "pending", "picked_up", "completed", "failed", "timed_out"

submitted_atstring · date-time

timeout_secondsinteger · int32

typestring

one of "ReadFile", "WriteFile", "EditFile", "ListFiles", "SearchFiles", "Exec"

Example response

{
  "args": {},
  "command_id": "00000000-0000-0000-0000-000000000000",
  "completed_at": "2026-06-09T00:00:00Z",
  "duration_ms": 0,
  "error": {},
  "picked_up_at": "2026-06-09T00:00:00Z",
  "result": {},
  "runner_id": "00000000-0000-0000-0000-000000000000",
  "status": "completed",
  "submitted_at": "2026-06-09T00:00:00Z",
  "timeout_seconds": 0,
  "type": "EditFile"
}

objectErrorMessage

codeinteger · int32

detailsstring

messagestring

Example response

{
  "code": 0,
  "details": "string",
  "message": "string"
}

Examples

runnerIdrequiredpath parameter

commandIdrequiredpath parameter

waitquery parameter

timeoutquery parameter

curl -X GET 'http://localhost:5173/api/v1/private/local-runners/00000000-0000-0000-0000-000000000000/bridge/commands/00000000-0000-0000-0000-000000000000?timeout=30&wait=false'

const response = await fetch('http://localhost:5173/api/v1/private/local-runners/00000000-0000-0000-0000-000000000000/bridge/commands/00000000-0000-0000-0000-000000000000?timeout=30&wait=false', { method: 'GET' });
const data = await response.json();

const response = await fetch('http://localhost:5173/api/v1/private/local-runners/00000000-0000-0000-0000-000000000000/bridge/commands/00000000-0000-0000-0000-000000000000?timeout=30&wait=false', { method: 'GET' });
console.log(await response.json());

import requests

response = requests.request("GET", "http://localhost:5173/api/v1/private/local-runners/00000000-0000-0000-0000-000000000000/bridge/commands/00000000-0000-0000-0000-000000000000?timeout=30&wait=false")
print(response.json())

package main

import (
	"context"
	"net/http"
)

func main() {
	ctx := context.Background()
	req, err := http.NewRequestWithContext(ctx, "GET", "http://localhost:5173/api/v1/private/local-runners/00000000-0000-0000-0000-000000000000/bridge/commands/00000000-0000-0000-0000-000000000000?timeout=30&wait=false", nil)
	if err != nil {
		panic(err)
	}
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

<?php
$request = curl_init("http://localhost:5173/api/v1/private/local-runners/00000000-0000-0000-0000-000000000000/bridge/commands/00000000-0000-0000-0000-000000000000?timeout=30&wait=false");
curl_setopt($request, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($request);
curl_close($request);

var request = HttpRequest.newBuilder(URI.create("http://localhost:5173/api/v1/private/local-runners/00000000-0000-0000-0000-000000000000/bridge/commands/00000000-0000-0000-0000-000000000000?timeout=30&wait=false"))
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

require 'net/http'

uri = URI("http://localhost:5173/api/v1/private/local-runners/00000000-0000-0000-0000-000000000000/bridge/commands/00000000-0000-0000-0000-000000000000?timeout=30&wait=false")
request = Net::HTTPGenericRequest.new("GET", false, true, uri)
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "http://localhost:5173/api/v1/private/local-runners/00000000-0000-0000-0000-000000000000/bridge/commands/00000000-0000-0000-0000-000000000000?timeout=30&wait=false");
using var response = await client.SendAsync(request);

{
  "args": {},
  "command_id": "00000000-0000-0000-0000-000000000000",
  "completed_at": "2026-06-09T00:00:00Z",
  "duration_ms": 0,
  "error": {},
  "picked_up_at": "2026-06-09T00:00:00Z",
  "result": {},
  "runner_id": "00000000-0000-0000-0000-000000000000",
  "status": "completed",
  "submitted_at": "2026-06-09T00:00:00Z",
  "timeout_seconds": 0,
  "type": "EditFile"
}

{
  "code": 0,
  "details": "string",
  "message": "string"
}