evidence

Edit evidence — new words are proposed again

patch/workspaces/{id}/questions/{questionId}/evidence/{evidenceId}

Request

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

Path parameters

idstring uuid required

The workspace's id (a UUID).

questionIdstring uuid required

The question's id (a UUID).

evidenceIdstring uuid required

The evidence's id (a UUID).

Request body

stance'supports' | 'contradicts' | 'qualifies'
summarystring
sourcestring
sourceKind'official-statistics' | 'law' | 'institution' | 'research' | 'modelling' | 'polling' | 'advocacy' | 'proposal' | 'expert-judgement' | 'management-estimate' | 'internal' | 'news' | 'first-person' | 'other'

Defaults to other. first-person: a person’s own expectation or experience — it names them as assertedBy, affected.

assertedBystring
declaredIntereststring

A stake the asserter has in the outcome.

pinpointstring
quotestring

The passage, word for word, from the source document sourceItemId names: refused unless it is in the document as read, but for its spacing. Kept in the document’s own words. An empty string on an edit clears it.

whyThisSourcestring

Why this source fits the claim, in a sentence. An empty string on an edit clears it.

reasonstring

Why — kept in the history.

Example request

{
  "declaredInterest": "Funded by the Yes campaign",
  "publishedOn": "2026-10-13",
  "accessedOn": "2026-10-13",
  "pinpoint": "Table 4"
}

Response

The evidence.

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.