Run a Bee Code software-development turn

Versioned, structured NDJSON agent protocol for local IDE, CLI, and API clients. Tool calls, file deltas, approvals, progress, completion, and failure are machine events rather than assistant prose.

post/bee/code/v1/turns

Request

  • Base URL: https://api.bee.heossi.com
  • URL: https://api.bee.heossi.com/bee/code/v1/turns
  • Auth: HTTP bearer

Request body

protocol'bee.code.v1' required
session_idstring required
run_idstring uuid

Stable durable run identifier across every manager/tool cycle for one customer task.

turn_idstring required
model'bee-cell' | 'bee-brood' | 'bee-comb' | 'bee-buzz' | 'bee-hive' | 'bee-swarm' required
mode'manual' | 'plan' | 'edit' | 'auto' required
effort'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'ultracode'

Optional product effort level; omitted keeps the plane's default output budget.

enable_thinkingboolean

Enable the selected model's explicit thinking mode. Requests are rejected when the model does not support it.

requeststring required
cursorinteger
workspaceobject required
capabilitiesobject required

Response

Ordered Bee Code event stream.

Changes

No recorded changes to this operation across all 1 revision of this API.