evidence

Say what you know first-hand — recorded as yours, on the claim behind what you are looking at

The database stamps the rest from who is signed in: first-person, asserted by them as affected, read today. It stands accepted, as theirs. Only a person acting as themselves — never a draft or the assistant — and only an editor of the question’s workspace.

post/workspaces/{id}/questions/{questionId}/own-evidence

Request

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

What the person is looking at: a claim, or evidence, what a claim rests on, a range or a threshold — the claim behind it gets the evidence.

targetIdstring uuid required
statementstring required

What they know first-hand, in their own words.

stance'supports' | 'contradicts' | 'qualifies' required

Example request

{
  "statement": "My Solterra does 250 miles in summer and 190 in winter."
}

Response

The evidence, theirs and accepted.

idstring uuid required
workspaceIdstring uuid required
questionIdstring uuid required
propositionIdstring uuid required
stance'supports' | 'contradicts' | 'qualifies' required
summarystring required
sourcestring required
sourceUrlstring
sourceKind'official-statistics' | 'law' | 'institution' | 'research' | 'modelling' | 'polling' | 'advocacy' | 'proposal' | 'expert-judgement' | 'management-estimate' | 'internal' | 'news' | 'first-person' | 'other' required
sourceItemIdstring uuid

The question’s source document it was taken from.

assertedBystring
assertedRole'decides' | 'knows' | 'affects' | 'affected' | 'challenges'
declaredIntereststring

A stake whoever asserts it has in the outcome.

publishedOnstring

When the source was published, YYYY-MM-DD.

accessedOnstring

When it was read, YYYY-MM-DD.

pinpointstring

Where in the source: a page, table or section.

quotestring

The passage it rests on, word for word, in the words of the version of its source that was read — found there before it was kept. A quote from an uploaded document is shown to its workspace only.

quoteFoundboolean

Whether the quote was found in its source as read: false where it was looked for and is not there. Absent where nothing has looked yet.

derivesFromIdstring uuid

The evidence it derives from. Evidence sharing a root is one family, not independent confirmation.

lean'larger' | 'smaller' | 'either'

For a qualification: which way it leans.

whyThisSourcestring

Why this source was chosen for this claim, in words: the authority on the fact, independent evidence, an interested party’s own claim, a person’s own experience, or a secondary source and why.

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

Example response

{
  "summary": "Net fiscal balance -£25.3bn, -10.9% of GDP.",
  "source": "Scottish Government, GERS 2025-26"
}

Changes

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