model

Record a decision: the option chosen, why, and the model as it was

Recorded by a person and never rewritten. Unless a snapshot is named, the model is frozen now, named for the decision; that snapshot is kept while the decision stands.

post/workspaces/{id}/questions/{questionId}/decisions

Request

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

Path parameters

idstring uuid required

The workspace's id (a UUID).

questionIdstring uuid required

The question's id (a UUID).

Headers

Idempotency-Keystring

Any unique string. The same key, method, path and body within 24 hours answers with the first response instead of creating again; the same key on a different request is 409 idempotency_key_reused.

Request body

optionIdstring uuid required
configurationIdstring uuid

An accepted configuration of the option chosen, where one was.

rationalestring required
snapshotIdstring uuid

The snapshot it was made on. Absent: one is frozen now, named for the decision.

stanceVersionIdstring uuid

A version of a stance the recorder holds on this question, cited by the act. Shown only as the stance’s holder allows; never part of the record.

Response

The decisions, with it.

totalinteger required
offsetinteger required
limitinteger required

Changes

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