---
name: neotask-runner-and-desktop
description: Inspect runner enrollment and human-controlled desktop handoffs.
---

# Runner and desktop

Launch state: **Live**.

Inspect runner enrollment and human-controlled desktop handoffs.

Read [the authenticated capabilities](https://neotask.ai/api/agent/v1/capabilities) before each request. It is the current account decision for scope, claim, setup, approval, plan, quota, model, and service state.

Use [the runner index](https://neotask.ai/docs/runner/llms.txt) for the linked Markdown pages.

## Rules

- A documented operation does not grant permission.
- Use a row only when its capability record reports `scopeGranted: true`, `availability: "available"`, and the required launch state.
- Planned rows are contract records. Their routes are not mounted and must not be called.
- Keep bearer tokens, provider credentials, handoff handles, and tenant identifiers out of URLs, logs, and generated content.
- Follow any returned claim, approval, pairing, integration, or checkout action through the human flow. Do not complete a human-only action as the agent.

## Operations

- [Enroll a local or hosted runner](https://neotask.ai/docs/api/create-runner-enrollment.md): `POST /api/agent/v1/runners`, scope `neotask:runners:write`, status **implemented, currently approval_required**, reason `human_approval_required`
- [List enrolled runners](https://neotask.ai/docs/api/list-agent-runners.md): `GET /api/agent/v1/runners`, scope `neotask:runners:read`, status **implemented**, reason `none`
- [Rotate a runner credential](https://neotask.ai/docs/api/rotate-agent-runner.md): `POST /api/agent/v1/runners/{runnerId}/rotate`, scope `neotask:runners:write`, status **implemented**, reason `none`
- [Revoke an enrolled runner](https://neotask.ai/docs/api/revoke-agent-runner.md): `DELETE /api/agent/v1/runners/{runnerId}`, scope `neotask:runners:write`, status **implemented**, reason `none`

Full API index: https://neotask.ai/docs/api/llms.txt
MCP resource: `https://neotask.ai/mcp`
Runner control protocol: https://neotask.ai/docs/runner/control-plane.md
Runner control OpenAPI: https://neotask.ai/docs/runner/openapi.yaml
Runner controls: confirm enrollment, report liveness, drain safely, claim and maintain leases, and poll or acknowledge autonomy controls.
Runner lifecycle: begin a drain, wait for server-derived readiness, finish the local transaction, then resume or abort with the same lifecycle fence.