---
title: "Say what you know first-hand — recorded as yours, on the claim behind what you are looking at"
method: POST
path: "/workspaces/{id}/questions/{questionId}/own-evidence"
tags: ["evidence"]
---

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

`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

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.

## Path parameters

- `id` string, uuid, required
- `questionId` string, uuid, required

## Headers

- `Idempotency-Key` string

## Request body

- OwnEvidenceBody
  - `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.
  - `targetId` string, uuid, required
  - `statement` string, required: What they know first-hand, in their own words.
  - `stance` 'supports' | 'contradicts' | 'qualifies', required

## Response `201`

The evidence, theirs and accepted.

- Evidence
  - `id` string, uuid, required
  - `workspaceId` string, uuid, required
  - `questionId` string, uuid, required
  - `propositionId` string, uuid, required
  - `stance` 'supports' | 'contradicts' | 'qualifies', required
  - `summary` string, required
  - `source` string, required
  - `sourceUrl` string
  - `sourceKind` 'official-statistics' | 'law' | 'institution' | 'research' | 'modelling' | 'polling' | 'advocacy' | 'proposal' | 'expert-judgement' | 'management-estimate' | 'internal' | 'news' | 'first-person' | 'other', required
  - `sourceItemId` string, uuid: The question’s source document it was taken from.
  - `assertedBy` string
  - `assertedRole` 'decides' | 'knows' | 'affects' | 'affected' | 'challenges'
  - `declaredInterest` string: A stake whoever asserts it has in the outcome.
  - `publishedOn` string: When the source was published, YYYY-MM-DD.
  - `accessedOn` string: When it was read, YYYY-MM-DD.
  - `pinpoint` string: Where in the source: a page, table or section.
  - `quote` string: 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.
  - `quoteFound` boolean: 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.
  - `derivesFromId` string, 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.
  - `whyThisSource` string: 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.
  - `decidedBy` string, uuid
  - `decidedByName` string
  - `decidedAt` string
  - `createdBy` string, uuid
  - `createdAt` string, required
  - `draftId` string, uuid: Set where SwingFactor drafted it.
  - `updatedAt` string, required
  - `links` EvidenceLinks, required: Relative /v1 URLs to follow.
    - `self` string, required
    - `decision` string, required
    - `proposition` string, required
    - `question` string, required

## Other responses

- `401`: No token, or not a valid one: `unauthorized`.
- `403`: Not a person acting as themselves.
- `404`: No such question or claim, or not one you can add to.
- `422`: Nothing said, or no name on the profile to record it under.

---

[API](https://skmtc.dev/swingfactor/apis/swingfactor-api.md) · [All operations](https://skmtc.dev/swingfactor/apis/swingfactor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/swingfactor/apis/swingfactor-api/revisions/c2fe881a39c3?raw)