# Runners

Local runner management endpoints

## Operations

| Method | Path | Operation |
| --- | --- | --- |
| `GET` | `/v1/private/local-runners` | [List local runners](../listrunners.md) |
| `POST` | `/v1/private/local-runners/jobs` | [Create local runner job](../createjob.md) |
| `GET` | `/v1/private/local-runners/jobs/{jobId}` | [Get local runner job](../getjob.md) |
| `POST` | `/v1/private/local-runners/jobs/{jobId}/cancel` | [Cancel local runner job](../canceljob.md) |
| `GET` | `/v1/private/local-runners/jobs/{jobId}/logs` | [Get local runner job logs](../getjoblogs.md) |
| `POST` | `/v1/private/local-runners/jobs/{jobId}/logs` | [Append local runner job logs](../appendjoblogs.md) |
| `POST` | `/v1/private/local-runners/jobs/{jobId}/results` | [Report local runner job result](../reportjobresult.md) |
| `DELETE` | `/v1/private/local-runners/{runnerId}` | [Disconnect local runner](../disconnectrunner.md) |
| `GET` | `/v1/private/local-runners/{runnerId}` | [Get local runner](../getrunner.md) |
| `PUT` | `/v1/private/local-runners/{runnerId}/agents` | [Register local runner agents](../registeragents.md) |
| `POST` | `/v1/private/local-runners/{runnerId}/bridge/commands` | [Submit bridge command](../createbridgecommand.md) |
| `POST` | `/v1/private/local-runners/{runnerId}/bridge/commands/next` | [Poll next bridge commands](../nextbridgecommands.md) |
| `GET` | `/v1/private/local-runners/{runnerId}/bridge/commands/{commandId}` | [Get bridge command](../getbridgecommand.md) |
| `POST` | `/v1/private/local-runners/{runnerId}/bridge/commands/{commandId}/results` | [Report bridge command result](../reportbridgeresult.md) |
| `PATCH` | `/v1/private/local-runners/{runnerId}/checklist` | [Patch runner checklist](../patchchecklist.md) |
| `POST` | `/v1/private/local-runners/{runnerId}/heartbeats` | [Local runner heartbeat](../heartbeat.md) |
| `GET` | `/v1/private/local-runners/{runnerId}/jobs` | [List local runner jobs](../listjobs.md) |
| `POST` | `/v1/private/local-runners/{runnerId}/jobs/next` | [Next local runner job](../nextjob.md) |

## Related pages

- [Activate a pairing session](../activatepairingsession.md)
- [Add blueprint to existing config](../updateagentconfig.md)
- [Add items to annotation queue](../additemstoannotationqueue.md)
- [Add span comment](../addspancomment.md)
- [Add span feedback score](../addspanfeedbackscore.md)
- [Add thread comment](../addthreadcomment.md)
- [Add trace comment](../addtracecomment.md)
- [Add trace feedback score](../addtracefeedbackscore.md)
- [Agent Configs](./agent-configs.md)
- [Agent Insights](./agent-insights.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.