switching

Edit a range — new numbers or a new source are proposed again

patch/workspaces/{id}/questions/{questionId}/estimates/{estimateId}

Request

  • Base URL: https://api.swingfactor.ai/v1
  • URL: https://api.swingfactor.ai/v1/workspaces/{id}/questions/{questionId}/estimates/{estimateId}
  • Auth: HTTP bearer

Path parameters

idstring uuid required

The workspace's id (a UUID).

questionIdstring uuid required

The question's id (a UUID).

estimateIdstring uuid required

The estimate's id (a UUID).

Request body

lownumber
highnumber
sourcestring
assertedBystring
everyScenarioboolean

It holds whichever scenario happens. Never with a scenario. Neither: not stated.

everyConfigurationboolean
derivationstring
measuredAgainststring
reasonstring

Why — kept in the history.

Response

The range.

idstring uuid required
workspaceIdstring uuid required
questionIdstring uuid required
variableIdstring uuid required
lownumber required
highnumber required
sourcestring required
assertedBystring
assertedRole'decides' | 'knows' | 'affects' | 'affected' | 'challenges'
horizon'transition' | 'early' | 'medium' | 'long' | 'every'

The matched horizon: transition (Day One), early adjustment, medium term, long run, or every horizon. None: not stated — never every.

scenarioIdstring uuid
everyScenarioboolean

It holds whichever scenario happens. Never with a scenario. Neither: not stated.

configurationIdstring uuid

The configuration it holds under: the same quantity under another package is another range.

everyConfigurationboolean

It holds under every configuration of the options its claim bears on. Neither: not stated.

basis'published' | 'derived' | 'judgement'

Published by its source, derived by the project (with its arithmetic), or a judgement.

derivationstring

For a derived range: its arithmetic.

measuredAgainststring

The baseline it is measured against.

status'proposed' | 'accepted' | 'rejected' required

Changes only by a person’s decision.

decidedBystring uuid
decidedByNamestring
decidedAtstring
createdBystring uuid
createdAtstring required
draftIdstring uuid

Set where SwingFactor drafted it.

updatedAtstring required

Changes

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