Post v0 city by city name sling

Changed on
post/v0/city/{cityName}/sling

Request

  • The document declares no server URL.
  • Auth: none declared. Required headers: X-GC-Request

Path parameters

cityNamestring required

City name.

Headers

X-GC-Requeststring required

Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.

Request body

attached_bead_idstring

Bead or convoy ID to attach formula to, in place of bead (gc sling --on).

beadstring

Bead or convoy ID to sling, like gc sling <target> <bead>. The target's default formula is cooked onto the bead unless no_formula is set; a convoy's open children are routed one by one.

forceboolean

Bypass cross-rig guards; for direct bead routes, also bypass missing-bead validation. Formula-backed graph routes may replace existing live workflow roots but still require the source bead to exist.

formulastring

Formula name. Alone, it launches the formula standalone (gc sling --formula). With attached_bead_id, it is attached to that bead (gc sling <target> <bead> --on <formula>).

mergestring

Merge strategy: direct, mr, or local.

no_convoyboolean

Do not create an auto-convoy for the routed bead.

no_formulaboolean

Suppress the target's default_sling_formula and route the raw bead (gc sling --no-formula).

ownedboolean

Mark the routed bead as owned by the target.

reassignboolean

Clear any existing human assignee on the bead before routing, so a bead claimed via bd update --claim is handed to the target's pool.

rigstring

Rig name.

scope_kindstring

Scope kind (city or rig).

scope_refstring

Scope reference.

targetstring required

Target agent or pool.

titlestring

Workflow title (gc sling --title), for an explicit or default formula.

varsobject

Formula variables (gc sling --var), for an explicit or default formula.

Response

OK

attached_bead_idstring
beadstring
convoy_idstring

Auto-convoy tracking the routed bead, when one was created or reused. Matches gc sling --json convoy_id.

dashboard_urlstring

Absolute dashboard deep link for the slung work: the run detail view when a graph workflow was launched, otherwise the runs list. Present only when the serving process also hosts the dashboard (the supervisor listener); the standalone controller API omits it.

formulastring
modestring
molecule_idstring

Root of the formula wisp attached to the bead, when a non-graph (v1) formula was attached. Matches gc sling --json molecule_id.

root_bead_idstring
statusstring required
targetstring required
warningsstring[] nullable
workflow_idstring

Changes

    • ○

      added the optional property to the response with the status

    • ○

      added the optional property to the response with the status

    • ○

      added the optional property to the response with the status

    • ○

      added the new optional request property

    • ○

      added the new optional request property

    • ○

      added the new optional request property

    • ○

      added the new optional request property

    • ○

      added the new optional request property