challenges

Challenge part of a question’s model

Anybody who can read the question may: on a public question, anybody signed in.

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

Request

  • Base URL: https://api.swingfactor.ai/v1
  • URL: https://api.swingfactor.ai/v1/workspaces/{id}/questions/{questionId}/challenges
  • 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

targetKind'proposition' | 'evidence' | 'dependency' | 'estimate' | 'break-even' required
targetIdstring uuid required
objectionstring required

Response

The challenge, open.

idstring uuid required
workspaceIdstring uuid required
questionIdstring uuid required
targetKind'proposition' | 'evidence' | 'dependency' | 'estimate' | 'break-even' required
targetIdstring uuid required
objectionstring required
plainstring

SwingFactor’s doubt said plainly: what is wrong, then what would put it right.

suggests'fix' | 'tell' | 'fine'

The answer SwingFactor recommends: fix (public sources could put it right), tell (only your own knowledge could) or fine.

raisedBystring uuid
raisedByNamestring
outcome'no-change' | 'qualified' | 'material-change' | 'new-uncertainty'

Absent while it is open.

validity'genuine' | 'partly' | 'not-genuine'

Whether it was right, apart from what it did. Absent while open, or not said.

responsestring
resolvedBystring uuid
resolvedByNamestring
resolvedAtstring
requestedChangestring

The change an editor asked for: right, and the model should change. It stays open until a person resolves it, and is kept beside the resolution after.

requestedBystring uuid
requestedByNamestring
requestedAtstring
changeCountinteger

On the list: changes since it was raised to what it was raised against. A resolution saying the model changed is refused while this is 0.

yoursboolean required

Whether the caller raised it — and so may withdraw it while it is open and unanswered.

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.