Responses & runs

A response is one browser-agent execution created with POST /api/v1/responses. Banana Peel stores it as a run you can list in the console and via GET /api/v1/runs. The unit of work is the response — one task, one result, ready for production.

A run is not a session — a session is a live browser you hold open and drive yourself over CDP, with no task known to Banana Peel. Runs are what you asked for; sessions are what you're holding.

What you send

• input — task text (OpenAI-style string or message array)
• url — optional explicit target (also parsed from input)
• routing — smart, runner, category, or chain
• model — use banana-peel

What you get

• OpenAI-compatible fields: id, status, output, output_text
• banana_peel — runner used, ranked chain, cost, timing, session, screenshot, artifacts, fallback_from

See also

• Create a response
• Routing