paper

Update Paper Deployment

Move a LIVE or PAUSED paper run onto the strategy's head (S01 §3.13).

The twin of update_live: the same coordination marker (UPDATE_PENDING / UPDATE_FAILED / UPDATE), the same PAUSED barrier with the Scheduler change behind it, and the same artifact gates (equivalence, validity, known issues, flow-series grade, serving with no account), without the account-mode gate and without operator blocks. The completing transaction restores the original status, binds a fresh config from the ONE builder through deployments.config_id (never strategies.active_config_id, PT2-45), sets last_viewed_at (an update is a visit) and writes the UPDATE row and UPDATE_COMPLETED with the new commit; after commit on_paper_update_completed fires once. A retry completes a pending update rather than starting a new one.

The label and the marker (SOAK-S2): the run is relabelled v{N} by the target commit's sequence, as the create labels it, and NO release tag is minted (live's _reserve_live_update_release is not called): a paper move is not a release, and a reserved release-vN.0 shifted the strategy's live version sequence. The marker's version_string is the paper-owned key :func:_paper_update_coordination_key, unique per update on the run, so live's resolver (unchanged) still pairs each pending update with its own UPDATE event.

post/v1/paper/{deployment_id}/update

Request

  • Base URL: https://api.usekeel.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.usekeel.io/v1/paper/{deployment_id}/update
  • Auth: none declared

Path parameters

deployment_idstring required

Headers

Authorizationstring nullable
X-Org-Idstring nullable

Request body

schedulestring nullable

Optional cron spelling; it must equal the selected commit's derived schedule.

Response

Successful Response

deployment_idstring required
strategy_idstring required
namestring required
statusstring required
schedulestring nullable
source_hashstring nullable
s3_keystring nullable
org_idstring nullable
account_idstring nullable
deployed_atstring nullable
stopped_atstring nullable
created_atstring nullable
updated_atstring nullable
deployed_commit_idstring nullable
deployed_version_stringstring nullable
config_idstring nullable
total_pnlnumber nullable
position_countinteger nullable
remainingobject nullable
execution_style'market' | 'maker' nullable
paused_reasonstring nullable
paused_atstring nullable
tranchingobject nullable
health'running' | 'degraded' | 'stalled' | 'stopped' nullable
serving_warningsobject[] nullable

Changes

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