AgentCanvas / Pages / Developer Guide / Core / Decisions / Platform / ADR-platform-002
2026-03-23
Date
2026-03-23
Status
accepted
Field
platform
Old ID
ADR-005

Context

Original API had separate /load (send graph) and /play (start execution) endpoints, requiring the backend to hold state between calls.

Decision

Single POST /run { loop_definition, execution_id } — canvas sends the full graph definition each time.

Alternatives

Keep two-step flow with server-side session state.

Rationale

Eliminates statefulness between API calls. Each run is self-contained. Simpler error handling — no "loaded but not playing" state to manage. Slight payload overhead is negligible.

Affected docs

architecture.md