---
title: "Post or update vote"
method: POST
path: "/v3/votes"
tags: ["studies"]
---

# Post or update vote

`POST /v3/votes`

I am really good at finding correlations and even compensating for various onset delays and durations of action. However, you are much better than me at knowing if there's a way that a given factor could plausibly influence an outcome. You can help me learn and get better at my predictions by pressing the thumbs down button for relationships that you think are coincidences and thumbs up once that make logic sense.

## Query parameters

- `userId` number

## Request body

- Vote
  - `causeVariableId` integer, required — Cause variable id
  - `clientId` string, required — Your CureDAO client id can be obtained by creating an app at https://builder.quantimo.do
  - `createdAt` string — When the record was first created. Use UTC ISO 8601 YYYY-MM-DDThh:mm:ss datetime format
  - `effectVariableId` integer, required — Effect variable id
  - `id` integer — id
  - `updatedAt` string — When the record in the database was last updated. Use UTC ISO 8601 YYYY-MM-DDThh:mm:ss datetime format
  - `userId` integer, required — ID of User
  - `value` 'up' | 'down' | 'none', required — Vote down for implausible/not-useful or up for plausible/useful. Vote none to delete a previous vote.
  - `type` 'causality' | 'usefulness' — Your CureDAO client id can be obtained by creating an app at https://builder.quantimo.do

## Response `201`

Successful Operation

- CommonResponse
  - `description` string, required — Can be used as body of help info popup
  - `summary` string, required — Can be used as title in help info popup
  - `errors` Error[] — Array of error objects with message property
    - `message` string, required — Error message
  - `status` string — ex. OK or ERROR
  - `success` boolean — true or false
  - `code` number — Response code such as 200
  - `link` string — A super neat url you might want to share with your users!
  - `card` Card
    - `actionSheetButtons` Button[]
      - `accessibilityText` string — Ex: connect
      - `action` object — Action data
      - `additionalInformation` string — Ex: connect
      - `color` string — Ex: #f2f2f2
      - `confirmationText` string — Text to show user before executing functionName
      - `functionName` string — Name of function to call
      - `parameters` object — Data to provide to functionName or be copied to the card parameters when button is clicked and card is posted to the API
      - `html` string — Ex: connect
      - `id` string — HTML element id
      - `image` string — Ex: https://image.jpg
      - `ionIcon` string — Ex: ion-refresh
      - `link` string, required — Ex: https://local.quantimo.do
      - `stateName` string — State to go to
      - `stateParams` object — Data to provide to the state
      - `successToastText` string — Text to show user after executing functionName
      - `successAlertTitle` string — Text to show user after executing functionName
      - `successAlertBody` string — Text to show user after executing functionName
      - `text` string, required — Ex: Connect
      - `tooltip` string — Ex: This is a tooltip
      - `webhookUrl` string — Post here on button click
    - `avatar` string — Smaller square image
    - `avatarCircular` string — Smaller circular image
    - `backgroundColor` string — Ex: #f2f2f2
    - `buttons` Button[]
      - `accessibilityText` string — Ex: connect
      - `action` object — Action data
      - `additionalInformation` string — Ex: connect
      - `color` string — Ex: #f2f2f2
      - `confirmationText` string — Text to show user before executing functionName
      - `functionName` string — Name of function to call
      - `parameters` object — Data to provide to functionName or be copied to the card parameters when button is clicked and card is posted to the API
      - `html` string — Ex: connect
      - `id` string — HTML element id
      - `image` string — Ex: https://image.jpg
      - `ionIcon` string — Ex: ion-refresh
      - `link` string, required — Ex: https://local.quantimo.do
      - `stateName` string — State to go to
      - `stateParams` object — Data to provide to the state
      - `successToastText` string — Text to show user after executing functionName
      - `successAlertTitle` string — Text to show user after executing functionName
      - `successAlertBody` string — Text to show user after executing functionName
      - `text` string, required — Ex: Connect
      - `tooltip` string — Ex: This is a tooltip
      - `webhookUrl` string — Post here on button click
    - `buttonsSecondary` Button[]
      - `accessibilityText` string — Ex: connect
      - `action` object — Action data
      - `additionalInformation` string — Ex: connect
      - `color` string — Ex: #f2f2f2
      - `confirmationText` string — Text to show user before executing functionName
      - `functionName` string — Name of function to call
      - `parameters` object — Data to provide to functionName or be copied to the card parameters when button is clicked and card is posted to the API
      - `html` string — Ex: connect
      - `id` string — HTML element id
      - `image` string — Ex: https://image.jpg
      - `ionIcon` string — Ex: ion-refresh
      - `link` string, required — Ex: https://local.quantimo.do
      - `stateName` string — State to go to
      - `stateParams` object — Data to provide to the state
      - `successToastText` string — Text to show user after executing functionName
      - `successAlertTitle` string — Text to show user after executing functionName
      - `successAlertBody` string — Text to show user after executing functionName
      - `text` string, required — Ex: Connect
      - `tooltip` string — Ex: This is a tooltip
      - `webhookUrl` string — Post here on button click
    - `content` string — Ex: Content
    - `headerTitle` string — Ex: Title
    - `html` string — HTML for the entire card.
    - `htmlContent` string — Ex: <div>Content</div>
    - `id` string, required — HTML element id
    - `image` string — Larger image of variable dimensions
    - `inputFields` InputField[]
      - `displayName` string, required
      - `helpText` string
      - `hint` string
      - `icon` string
      - `id` string — HTML element id
      - `image` string
      - `key` string
      - `labelLeft` string
      - `labelRight` string
      - `link` string
      - `maxLength` integer
      - `maxValue` number
      - `minLength` integer
      - `minValue` number
      - `options` string[] — Selector list options
      - `placeholder` string — Ex: Title
      - `postUrl` string
      - `required` boolean
      - `show` boolean — Ex: Title
      - `submitButton` Button
        - `accessibilityText` string — Ex: connect
        - `action` object — Action data
        - `additionalInformation` string — Ex: connect
        - `color` string — Ex: #f2f2f2
        - `confirmationText` string — Text to show user before executing functionName
        - `functionName` string — Name of function to call
        - `parameters` object — Data to provide to functionName or be copied to the card parameters when button is clicked and card is posted to the API
        - `html` string — Ex: connect
        - `id` string — HTML element id
        - `image` string — Ex: https://image.jpg
        - `ionIcon` string — Ex: ion-refresh
        - `link` string, required — Ex: https://local.quantimo.do
        - `stateName` string — State to go to
        - `stateParams` object — Data to provide to the state
        - `successToastText` string — Text to show user after executing functionName
        - `successAlertTitle` string — Text to show user after executing functionName
        - `successAlertBody` string — Text to show user after executing functionName
        - `text` string, required — Ex: Connect
        - `tooltip` string — Ex: This is a tooltip
        - `webhookUrl` string — Post here on button click
      - `type` 'check_box' | 'date' | 'email' | 'number' | 'postal_code' | 'select_option' | 'string' | 'switch' | 'text_area' | 'unit' | 'variable_category', required — Ex: Title
      - `validationPattern` string — See http://html5pattern.com/ for examples
      - `value` string
    - `ionIcon` string — Ex: ion-refresh
    - `link` string — A link to a web page or something. Not much more to say about that.
    - `parameters` object — Key value pairs derived from user input fields, button clicks, or preset defaults
    - `relatedCards` Card[]
    - `selectedButton` Button
      - `accessibilityText` string — Ex: connect
      - `action` object — Action data
      - `additionalInformation` string — Ex: connect
      - `color` string — Ex: #f2f2f2
      - `confirmationText` string — Text to show user before executing functionName
      - `functionName` string — Name of function to call
      - `parameters` object — Data to provide to functionName or be copied to the card parameters when button is clicked and card is posted to the API
      - `html` string — Ex: connect
      - `id` string — HTML element id
      - `image` string — Ex: https://image.jpg
      - `ionIcon` string — Ex: ion-refresh
      - `link` string, required — Ex: https://local.quantimo.do
      - `stateName` string — State to go to
      - `stateParams` object — Data to provide to the state
      - `successToastText` string — Text to show user after executing functionName
      - `successAlertTitle` string — Text to show user after executing functionName
      - `successAlertBody` string — Text to show user after executing functionName
      - `text` string, required — Ex: Connect
      - `tooltip` string — Ex: This is a tooltip
      - `webhookUrl` string — Post here on button click
    - `sharingBody` string — Ex: sharingBody
    - `sharingButtons` Button[]
      - `accessibilityText` string — Ex: connect
      - `action` object — Action data
      - `additionalInformation` string — Ex: connect
      - `color` string — Ex: #f2f2f2
      - `confirmationText` string — Text to show user before executing functionName
      - `functionName` string — Name of function to call
      - `parameters` object — Data to provide to functionName or be copied to the card parameters when button is clicked and card is posted to the API
      - `html` string — Ex: connect
      - `id` string — HTML element id
      - `image` string — Ex: https://image.jpg
      - `ionIcon` string — Ex: ion-refresh
      - `link` string, required — Ex: https://local.quantimo.do
      - `stateName` string — State to go to
      - `stateParams` object — Data to provide to the state
      - `successToastText` string — Text to show user after executing functionName
      - `successAlertTitle` string — Text to show user after executing functionName
      - `successAlertBody` string — Text to show user after executing functionName
      - `text` string, required — Ex: Connect
      - `tooltip` string — Ex: This is a tooltip
      - `webhookUrl` string — Post here on button click
    - `sharingTitle` string — Ex: sharingTitle
    - `subHeader` string — Ex: subTitle
    - `subTitle` string — Ex: subTitle
    - `title` string — Ex: Title

## Other responses

- `401` — Not Authenticated

---

[API](https://skmtc.net/quantimo/apis/curedao-unified-health-api.md) · [All operations](https://skmtc.net/quantimo/apis/curedao-unified-health-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/quantimo/curedao-unified-health-api/versions/7ac03025c3d2/schema)