---
title: "Get local runner"
method: GET
path: "/v1/private/local-runners/{runnerId}"
tags: ["Runners"]
---

# Get local runner

`GET /v1/private/local-runners/{runnerId}`

Get a single local runner with its registered agents

## Path parameters

- `runnerId` string, uuid, required

## Response `200`

Runner details

- LocalRunner
  - `id` string, uuid
  - `name` string
  - `project_id` string, uuid
  - `status` 'pairing' | 'connected' | 'disconnected'
  - `connected_at` string, date-time
  - `agents` Agent[]
    - `name` string
    - `description` string
    - `language` string
    - `executable` string
    - `source_file` string
    - `params` Param[]
      - `name` string, required
      - `type` string, required
      - `presence` 'required' | 'optional'
    - `timeout` integer
  - `capabilities` string[]
  - `checklist` JsonNode
  - `type` 'connect' | 'endpoint'

## 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/revisions/bcd13aadaaf8/schema)