{"openapi":"3.1.0","jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","info":{"title":"50heads API","version":"2.0.0","summary":"Ask verified real people a five-second question and get the split back.","description":"Estimate, ask, wait and read results. Money is in credits (1 credit = 1p). Every ask needs an Idempotency-Key. Generated from the Zod schemas the API validates against; the reference is at https://50heads.com/en-us/docs/api.","contact":{"name":"50heads support","url":"https://50heads.com/contact","email":"support@50heads.com"},"license":{"name":"Proprietary","url":"https://50heads.com/legal/terms"}},"servers":[{"url":"https://api.50heads.com"}],"tags":[{"name":"pricing","x-displayName":"Pricing and config","description":"Unauthenticated and rate limited. Estimate as often as you like; it never spends."},{"name":"questions","x-displayName":"Questions","description":"Ask, wait and read results. Asking reserves the full price from your credits; answers not given are refunded when the question closes."},{"name":"drafts","x-displayName":"Drafts and uploads","description":"Save work in progress and upload images before you ask."},{"name":"projects","x-displayName":"Projects","description":"Group questions into projects in the account the key belongs to (yours or a team's). Label, archive and give each question your own reference with the question routes."},{"name":"account","x-displayName":"Credits","description":"Balance and ledger. Credits are bought on the web; the API spends them."},{"name":"support","x-displayName":"Support","description":"Open a ticket from a script or an agent. Replies come by email and in the portal."},{"name":"webhooks","x-displayName":"Webhook endpoints","description":"Managed in the portal under Developers; listed here for completeness."}],"paths":{"/v1/billing/estimate":{"post":{"operationId":"estimate","tags":["pricing"],"summary":"Price, time and validation for a question draft.","description":"Counts as half a request against the rate limit. `validation` lists anything that would stop the ask, one issue per field.","x-50heads-scope":null,"x-50heads-client":"quote","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EstimateRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quote"}}}},"400":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/config":{"get":{"operationId":"config","tags":["pricing"],"summary":"Credit exchange rates, the country table and question languages.","x-50heads-scope":null,"x-50heads-client":"config","security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppConfig"}}}},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/templates":{"get":{"operationId":"templates","tags":["pricing"],"summary":"Fixed-price question templates.","x-50heads-scope":"templates:read","x-50heads-client":"public.templates","security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplatesResponse"}}}},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/public/countries":{"get":{"operationId":"countries","tags":["pricing"],"summary":"Where heads answer from, the languages they read and pool size bands by tier.","x-50heads-scope":null,"x-50heads-client":"public.countries","security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountriesResponse"}}}},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/tags":{"get":{"operationId":"tags","tags":["pricing"],"summary":"The self-declared tags you can target at any tier, by group (one trait per group).","x-50heads-scope":null,"x-50heads-client":"public.tags","security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagCatalogue"}}}},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/public/stats":{"get":{"operationId":"stats","tags":["pricing"],"summary":"Heads online now, answers this week and the median time to fifty answers.","x-50heads-scope":null,"x-50heads-client":"public.stats","security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicStats"}}}},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions":{"post":{"operationId":"ask","tags":["questions"],"summary":"Ask a question.","description":"Requires an Idempotency-Key header (a UUID). The same key returns the same question for 24 hours; a different body with the same key is `idempotency_conflict`. Fails with `insufficient_credits`, `spend_cap_exceeded` or `content_refused` without spending anything.","x-50heads-scope":"questions:write","x-50heads-client":"asks.createWith","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"bearer":[]},{"oauth2":["questions:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskRequest"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}}},"get":{"operationId":"list","tags":["questions"],"summary":"Your questions, newest first.","x-50heads-scope":"questions:read","x-50heads-client":"asks.list","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["draft","scheduled","live","complete","underfilled","cancelled","refused"]}},{"name":"since","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"projectId","in":"query","required":false,"schema":{"type":"string"}},{"name":"label","in":"query","required":false,"schema":{"type":"string"}},{"name":"externalRef","in":"query","required":false,"schema":{"type":"string"}},{"name":"archived","in":"query","required":false,"schema":{"type":"string","enum":["exclude","only","include"]}},{"name":"bookmarked","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"mine","in":"query","required":false,"schema":{"type":"boolean"}}],"security":[{"bearer":[]},{"oauth2":["questions:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions/{id}":{"get":{"operationId":"get","tags":["questions"],"summary":"One question and its progress.","x-50heads-scope":"questions:read","x-50heads-client":"asks.get","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."}],"security":[{"bearer":[]},{"oauth2":["questions:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"operationId":"update","tags":["questions"],"summary":"Complete early once minAnswers heads have answered, or file it: project, labels, archive, bookmark and a set-once externalRef.","description":"If that many have already answered, the question closes now and what was not answered is refunded. Changing an externalRef once set is refused with 409 external_ref_set.","x-50heads-scope":"questions:write","x-50heads-client":"asks.update","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."}],"security":[{"bearer":[]},{"oauth2":["questions:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionUpdate"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions/labels":{"get":{"operationId":"labels","tags":["questions"],"summary":"Labels in use in the account, most used first.","x-50heads-scope":"questions:read","x-50heads-client":"asks.labels","security":[{"bearer":[]},{"oauth2":["questions:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabelsResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/projects":{"get":{"operationId":"projectsList","tags":["projects"],"summary":"Projects in use, or the archived ones.","x-50heads-scope":"questions:read","x-50heads-client":"projects.list","parameters":[{"name":"archived","in":"query","required":false,"schema":{"type":"boolean"}}],"security":[{"bearer":[]},{"oauth2":["questions:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectsListResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"operationId":"projectsCreate","tags":["projects"],"summary":"Make a project.","x-50heads-scope":"questions:write","x-50heads-client":"projects.create","security":[{"bearer":[]},{"oauth2":["questions:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectsCreateRequest"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectsCreateResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/projects/{id}":{"patch":{"operationId":"projectsUpdate","tags":["projects"],"summary":"Rename, bookmark or archive a project.","x-50heads-scope":"questions:write","x-50heads-client":"projects.update","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."}],"security":[{"bearer":[]},{"oauth2":["questions:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectsUpdateRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectsUpdateResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"delete":{"operationId":"projectsDelete","tags":["projects"],"summary":"Delete a project. Its questions stay, outside any project.","x-50heads-scope":"questions:write","x-50heads-client":"projects.remove","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."}],"security":[{"bearer":[]},{"oauth2":["questions:write"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectsDeleteResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions/{id}/result":{"get":{"operationId":"result","tags":["questions"],"summary":"The result so far. Partial while the question is live.","description":"With a filter, the distribution, breakdowns and answers are of matching answers only; `nUnfiltered` counts them all and `suppressed` is true when a country or age band matched too few to show. `insights` is the summary of written answers once there is one.","x-50heads-scope":"questions:read","x-50heads-client":"asks.result","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."},{"name":"option","in":"query","required":false,"schema":{"description":"Answers that picked this option (0-based; ranking: ranked it first).","type":"integer","minimum":0,"maximum":8}},{"name":"tier","in":"query","required":false,"schema":{"description":"Answers from heads at this tier.","type":"integer","minimum":1,"maximum":3}},{"name":"country","in":"query","required":false,"schema":{"description":"ISO country code. Fewer than 5 matching answers show none.","type":"string","minLength":2,"maxLength":2}},{"name":"age_band","in":"query","required":false,"schema":{"description":"Age band such as \"25-34\". Fewer than 5 matching answers show none.","type":"string"}},{"name":"q","in":"query","required":false,"schema":{"description":"Words in reasons and written answers (and their translations).","type":"string","maxLength":100}}],"security":[{"bearer":[]},{"oauth2":["questions:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions/{id}/answers":{"get":{"operationId":"answers","tags":["questions"],"summary":"Matching answers, newest first, a page at a time, with reasons and translations.","x-50heads-scope":"questions:read","x-50heads-client":"asks.answers","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."},{"name":"option","in":"query","required":false,"schema":{"description":"Answers that picked this option (0-based; ranking: ranked it first).","type":"integer","minimum":0,"maximum":8}},{"name":"tier","in":"query","required":false,"schema":{"description":"Answers from heads at this tier.","type":"integer","minimum":1,"maximum":3}},{"name":"country","in":"query","required":false,"schema":{"description":"ISO country code. Fewer than 5 matching answers show none.","type":"string","minLength":2,"maxLength":2}},{"name":"age_band","in":"query","required":false,"schema":{"description":"Age band such as \"25-34\". Fewer than 5 matching answers show none.","type":"string"}},{"name":"q","in":"query","required":false,"schema":{"description":"Words in reasons and written answers (and their translations).","type":"string","maxLength":100}},{"name":"limit","in":"query","required":false,"schema":{"description":"Default 50.","type":"integer","minimum":1,"maximum":200}},{"name":"cursor","in":"query","required":false,"schema":{"description":"nextCursor from the previous page.","type":"string","maxLength":200}}],"security":[{"bearer":[]},{"oauth2":["questions:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswersResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions/{id}/insights":{"get":{"operationId":"insights","tags":["questions"],"summary":"The summary of the written answers: themes with counts and quotes, sentiment, a takeaway.","description":"Made by a machine from the reasons and free text, never from who answered; counts and quotes are computed from the answers. Written in the account's language, with the question-language original.","x-50heads-scope":"questions:read","x-50heads-client":"asks.insights","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."}],"security":[{"bearer":[]},{"oauth2":["questions:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InsightsResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"operationId":"summarise","tags":["questions"],"summary":"Make a fresh summary now: once every 10 minutes while live; the final one when it closes.","description":"429 rate_limited with retryAfterMs while a recent summary stands; 409 too_few_answers under three written answers.","x-50heads-scope":"questions:read","x-50heads-client":"asks.summarise","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."}],"security":[{"bearer":[]},{"oauth2":["questions:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummariseResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions/{id}/wait":{"get":{"operationId":"wait","tags":["questions"],"summary":"Hold the request until the question is answered, up to 25 seconds a call.","description":"Call again while `done` is false. `minAnswers` completes early once that many heads have answered.","x-50heads-scope":"questions:read","x-50heads-client":"asks.wait","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."},{"name":"seconds","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":25}},{"name":"minAnswers","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":9007199254740991}}],"security":[{"bearer":[]},{"oauth2":["questions:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions/{id}/cancel":{"post":{"operationId":"cancel","tags":["questions"],"summary":"Stop a live question and refund the answers not given.","x-50heads-scope":"questions:write","x-50heads-client":"asks.cancel","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."}],"security":[{"bearer":[]},{"oauth2":["questions:write"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions/{id}/share":{"post":{"operationId":"share","tags":["questions"],"summary":"Turn the public results page on or off.","x-50heads-scope":"questions:write","x-50heads-client":"asks.share","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."}],"security":[{"bearer":[]},{"oauth2":["questions:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions/{id}/export.csv":{"get":{"operationId":"export","tags":["questions"],"summary":"Every answer as CSV: option or text, reason, translations, tier, attestation reference, time, and taps for a click test.","x-50heads-scope":"questions:read","x-50heads-client":"asks.exportCsvUrl","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."},{"name":"option","in":"query","required":false,"schema":{"description":"Answers that picked this option (0-based; ranking: ranked it first).","type":"integer","minimum":0,"maximum":8}},{"name":"tier","in":"query","required":false,"schema":{"description":"Answers from heads at this tier.","type":"integer","minimum":1,"maximum":3}},{"name":"country","in":"query","required":false,"schema":{"description":"ISO country code. Fewer than 5 matching answers show none.","type":"string","minLength":2,"maxLength":2}},{"name":"age_band","in":"query","required":false,"schema":{"description":"Age band such as \"25-34\". Fewer than 5 matching answers show none.","type":"string"}},{"name":"q","in":"query","required":false,"schema":{"description":"Words in reasons and written answers (and their translations).","type":"string","maxLength":100}}],"security":[{"bearer":[]},{"oauth2":["questions:read"]}],"responses":{"200":{"description":"The file.","content":{"text/csv":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions/{id}/export.pdf":{"get":{"operationId":"exportPdf","tags":["questions"],"summary":"A one-page PDF report: the question, the chart, what it means and the answers (pinned first).","x-50heads-scope":"questions:read","x-50heads-client":"asks.exportUrl","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."}],"security":[{"bearer":[]},{"oauth2":["questions:read"]}],"responses":{"200":{"description":"The file.","content":{"application/pdf":{"schema":{"type":"string"}}}},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions/{id}/export.png":{"get":{"operationId":"exportPng","tags":["questions"],"summary":"The chart as a PNG to share: size=square (1080×1080, default), wide (1200×675) or story (1080×1920).","x-50heads-scope":"questions:read","x-50heads-client":"asks.exportUrl","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."},{"name":"size","in":"query","required":false,"schema":{"type":"string","enum":["square","wide","story"]}}],"security":[{"bearer":[]},{"oauth2":["questions:read"]}],"responses":{"200":{"description":"The file.","content":{"image/png":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions/{id}/exports":{"post":{"operationId":"exportLink","tags":["questions"],"summary":"A PDF report or PNG chart as a signed link that works for an hour without signing in.","x-50heads-scope":"questions:read","x-50heads-client":"asks.export","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."}],"security":[{"bearer":[]},{"oauth2":["questions:read"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportLinkRequest"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportLinkResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions/{id}/heads":{"post":{"operationId":"addHeads","tags":["questions"],"summary":"Reopen a finished question for n more heads, same wording and targeting; answers merge. dryRun quotes only.","description":"Needs an Idempotency-Key unless dryRun. The question must be complete or underfilled.","x-50heads-scope":"questions:write","x-50heads-client":"asks.addHeads","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"bearer":[]},{"oauth2":["questions:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddHeadsRequest"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddHeadsResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions/{id}/answers/{ref}/flag":{"post":{"operationId":"flagAnswer","tags":["questions"],"summary":"Flag one answer, named by its attestation reference, for review. Upheld: removed and refunded.","x-50heads-scope":"questions:write","x-50heads-client":"asks.flagAnswer","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."},{"name":"ref","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearer":[]},{"oauth2":["questions:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlagAnswerRequest"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlagAnswerResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions/{id}/answers/{ref}/pin":{"post":{"operationId":"pinAnswer","tags":["questions"],"summary":"Pin an answer to the top of the results and the PDF report, or unpin it.","x-50heads-scope":"questions:write","x-50heads-client":"asks.pinAnswer","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."},{"name":"ref","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearer":[]},{"oauth2":["questions:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PinAnswerRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PinAnswerResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions/{id}/share-links":{"get":{"operationId":"shareLinks","tags":["questions"],"summary":"Private share links for a question (tokens are never shown again).","x-50heads-scope":"questions:read","x-50heads-client":"asks.shareLinks.list","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."}],"security":[{"bearer":[]},{"oauth2":["questions:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareLinksResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"operationId":"createShareLink","tags":["questions"],"summary":"A private, unlisted link to the full results with written answers; expires in 1 to 90 days.","x-50heads-scope":"questions:write","x-50heads-client":"asks.shareLinks.create","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."}],"security":[{"bearer":[]},{"oauth2":["questions:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateShareLinkRequest"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateShareLinkResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions/{id}/share-links/{linkId}":{"delete":{"operationId":"revokeShareLink","tags":["questions"],"summary":"Revoke a private share link; it stops working at once.","x-50heads-scope":"questions:write","x-50heads-client":"asks.shareLinks.revoke","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."},{"name":"linkId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearer":[]},{"oauth2":["questions:write"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevokeShareLinkResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/public/shared/{token}":{"get":{"operationId":"sharedResult","tags":["questions"],"summary":"The results behind a private share link. No sign-in; never cached; noindex.","x-50heads-scope":null,"x-50heads-client":"public.shared","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SharedResultResponse"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions/{id}/heatmap.png":{"get":{"operationId":"heatmap","tags":["questions"],"summary":"A click test's heatmap as a transparent PNG to lay over the image. Add ?aspect=width/height to match it.","x-50heads-scope":"questions:read","x-50heads-client":"asks.heatmapUrl","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."}],"security":[{"bearer":[]},{"oauth2":["questions:read"]}],"responses":{"200":{"description":"The file.","content":{"image/png":{"schema":{"type":"string"}}}},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v2/questions/{id}/dispute":{"post":{"operationId":"dispute","tags":["questions"],"summary":"Dispute a result within 7 days of it closing.","x-50heads-scope":"questions:write","x-50heads-client":"asks.dispute","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The question id."}],"security":[{"bearer":[]},{"oauth2":["questions:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisputeRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectsDeleteResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/public/results/{code}":{"get":{"operationId":"publicResult","tags":["questions"],"summary":"A result its requester made public.","x-50heads-scope":null,"x-50heads-client":"public.results","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"},"description":"The public results code."}],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicResultResponse"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/drafts":{"get":{"operationId":"draftsList","tags":["drafts"],"summary":"Saved drafts.","x-50heads-scope":"questions:read","x-50heads-client":"drafts.list","security":[{"bearer":[]},{"oauth2":["questions:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftsListResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"operationId":"draftsSave","tags":["drafts"],"summary":"Save a draft. PUT /v1/drafts/{id} updates one; DELETE removes it.","x-50heads-scope":"questions:write","x-50heads-client":"drafts.save","security":[{"bearer":[]},{"oauth2":["questions:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftsSaveRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Draft"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/uploads":{"post":{"operationId":"uploads","tags":["drafts"],"summary":"A pre-signed URL to upload an image or sound clip.","description":"PUT the file to `uploadUrl` with the returned headers (the URL is the credential, for 15 minutes), then use `publicUrl` in the question. Images are checked and their metadata stripped before heads see them.","x-50heads-scope":"questions:write","x-50heads-client":"uploads.create","security":[{"bearer":[]},{"oauth2":["questions:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadsRequest"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadsResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/uploads/import":{"post":{"operationId":"uploadsImport","tags":["drafts"],"summary":"Copy an image from a public https link into 50heads.","description":"The image is fetched on our side (public https hosts only, three redirects at most), checked like an upload and stored. JPEG, PNG or WebP up to 5 MB.","x-50heads-scope":"questions:write","x-50heads-client":"uploads.importUrl","security":[{"bearer":[]},{"oauth2":["questions:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadsImportRequest"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadsImportResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/billing/balance":{"get":{"operationId":"balance","tags":["account"],"summary":"Credits, what is reserved by live questions, and what is left under this key's daily cap.","x-50heads-scope":"account:read","x-50heads-client":"billing.balance","security":[{"bearer":[]},{"oauth2":["account:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Balance"}}}},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/billing/ledger":{"get":{"operationId":"ledger","tags":["account"],"summary":"Every credit movement, newest first.","x-50heads-scope":"account:read","x-50heads-client":"billing.ledger","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}}],"security":[{"bearer":[]},{"oauth2":["account:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LedgerResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/billing/checkout":{"post":{"operationId":"checkout","tags":["account"],"summary":"Start a card or bank-transfer purchase (portal session only).","description":"Not available to API keys: buying credits needs a signed-in person.","x-50heads-scope":null,"x-50heads-client":"billing.checkout","security":[{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutInput"}}}},"responses":{"200":{"description":"OK"},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/support/tickets":{"post":{"operationId":"supportTicket","tags":["support"],"summary":"Open a support ticket.","description":"Signed in (key, OAuth or session), the reply goes to the account's email. Without a token, send `email`. 10 tickets an hour.","x-50heads-scope":null,"x-50heads-client":"support.create","security":[{"bearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportTicketInput"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportTicketResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/webhooks/endpoints":{"get":{"operationId":"webhooksList","tags":["webhooks"],"summary":"Your webhook endpoints.","x-50heads-scope":null,"x-50heads-client":"developer.webhooks","security":[{"session":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhooksListResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"operationId":"webhooksCreate","tags":["webhooks"],"summary":"Add an endpoint. The secret is shown once.","x-50heads-scope":null,"x-50heads-client":"developer.createWebhook","security":[{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhooksCreateRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhooksCreateResponse"}}}},"400":{"$ref":"#/components/responses/Invalid"},"401":{"$ref":"#/components/responses/Unauthorised"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"An API key (fh_live_…) from Developers in the portal, or an OAuth access token. Keys carry scopes and a daily spend cap."},"oauth2":{"type":"oauth2","description":"OAuth 2.1 with PKCE (S256) and the resource parameter https://mcp.50heads.com/mcp; dynamic client registration and the device grant are supported.","flows":{"authorizationCode":{"authorizationUrl":"https://auth.50heads.com/authorize","tokenUrl":"https://auth.50heads.com/token","refreshUrl":"https://auth.50heads.com/token","scopes":{"questions:read":"Read your questions and results","questions:write":"Ask questions and spend up to your cap","templates:read":"Read templates","account:read":"Read your balance and connection"}}}},"session":{"type":"http","scheme":"bearer","description":"A portal session. Not available to API keys."}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":true,"description":"A fresh UUID per ask. The same key returns the same question for 24 hours and never charges twice.","schema":{"type":"string","minLength":1,"maxLength":200}}},"responses":{"Invalid":{"description":"The request is not valid; `error.details.validation` lists the fixes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorised":{"description":"No key or token, or it expired or was revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"The key or token lacks the scope (`insufficient_scope`), or the action is not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"No such question on this account, or no such endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"PaymentRequired":{"description":"`insufficient_credits` or `spend_cap_reached`; nothing was spent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Conflict":{"description":"`idempotency_conflict`: that key was used for a different question.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Too many requests; wait for Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine code, such as insufficient_credits."},"message":{"type":"string","description":"One plain sentence."},"details":{"type":"object","additionalProperties":true}}}}},"QuestionV2":{"type":"object","properties":{"type":{"type":"string","enum":["single_choice","multi_choice","ab_image","pairwise","scale_1_5","ranking","yes_mostly_no","free_text","click_test","reaction"]},"text":{"type":"string","maxLength":600},"context":{"type":"string","maxLength":120},"language":{"default":"en","type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$"},"options":{"default":[],"maxItems":8,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","maxLength":40},"imageUrl":{"type":"string","format":"uri"}},"required":["label"],"additionalProperties":false}},"neither":{"default":false,"type":"boolean"},"stimulus":{"type":"object","properties":{"imageUrl":{"type":"string","format":"uri"},"audioUrl":{"type":"string","format":"uri"},"text":{"type":"string","maxLength":120},"exposureMs":{"type":"integer","minimum":2000,"maximum":10000}},"additionalProperties":false},"n":{"default":50,"type":"integer","minimum":10,"maximum":5000},"tier":{"default":1,"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3}]},"rush":{"default":false,"type":"boolean"},"targeting":{"type":"object","properties":{"countries":{"default":[],"maxItems":50,"type":"array","items":{"type":"string","minLength":2,"maxLength":2}},"tags":{"default":[],"maxItems":20,"type":"array","items":{"type":"string"}},"ageBands":{"maxItems":6,"type":"array","items":{"type":"string","enum":["18-24","25-34","35-44","45-54","55-64","65+"]}},"genders":{"maxItems":3,"type":"array","items":{"type":"string","enum":["woman","man","non_binary"]}},"verifiedAge":{"type":"boolean"}},"required":["countries","tags"],"additionalProperties":false},"clickTest":{"type":"object","properties":{"maxTaps":{"default":1,"type":"integer","minimum":1,"maximum":5}},"required":["maxTaps"],"additionalProperties":false},"scheduledFor":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"publicResults":{"default":false,"type":"boolean"},"reason":{"default":"off","type":"string","enum":["off","optional","required"]},"contentFlag":{"type":"string","enum":["none","medical","violence","distressing","alcohol_gambling","political"]},"id":{"type":"string"},"status":{"type":"string","enum":["draft","scheduled","live","complete","underfilled","cancelled","refused"]},"source":{"type":"string","enum":["app","portal","api","mcp"]},"answered":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"creditsPerAnswer":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"creditsReserved":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"creditsSpent":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"etaMinutes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"leaderLine":{"type":["string","null"]},"refusedCategory":{"type":["string","null"]},"publicCode":{"type":["string","null"]},"createdAt":{"type":"string"},"liveAt":{"type":["string","null"]},"closedAt":{"type":["string","null"]},"teamId":{"type":["string","null"]},"askedBy":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"projectId":{"type":["string","null"]},"labels":{"type":"array","items":{"type":"string"}},"archived":{"type":"boolean"},"bookmarked":{"type":"boolean"},"externalRef":{"type":["string","null"]}},"required":["type","text","language","options","neither","n","tier","rush","publicResults","reason","id","status","source","answered","creditsPerAnswer","creditsReserved","creditsSpent","etaMinutes","leaderLine","refusedCategory","publicCode","createdAt","liveAt","closedAt"],"additionalProperties":false},"ResultV2":{"type":"object","properties":{"questionId":{"type":"string"},"status":{"type":"string","enum":["in_progress","complete","underfilled","cancelled"]},"nRequested":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"nAccepted":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"distribution":{"type":"array","items":{"type":"object","properties":{"option":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"share":{"type":"number"},"averageRank":{"type":"number"},"appearances":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"strength":{"type":"number"},"rank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["option","count","share"],"additionalProperties":false}},"mean":{"type":["number","null"]},"summary":{"type":"object","properties":{"winner":{"type":["string","null"]},"margin":{"type":["number","null"]},"confidence":{"anyOf":[{"type":"string","enum":["low","medium","high"]},{"type":"null"}]},"note":{"type":"string"},"suggestedFollowUp":{"type":["string","null"]}},"required":["winner","margin","confidence","note","suggestedFollowUp"],"additionalProperties":false},"tier":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"language":{"type":"string"},"verificationLine":{"type":"string"},"medianSeconds":{"type":["number","null"]},"creditsSpent":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"answers":{"type":"array","items":{"type":"object","properties":{"option":{"type":["string","null"]},"text":{"type":["string","null"]},"translatedText":{"type":["string","null"]},"reason":{"type":["string","null"]},"translatedReason":{"type":["string","null"]},"tier":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"attestationRef":{"type":"string"},"answeredAt":{"type":"string"},"pinned":{"type":"boolean"},"flag":{"anyOf":[{"type":"object","properties":{"reason":{"type":"string","enum":["off_topic","low_effort","abusive","automated"]},"status":{"type":"string","enum":["open","upheld","dismissed"]},"refundCredits":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"},"decidedAt":{"type":["string","null"]}},"required":["reason","status","refundCredits","createdAt","decidedAt"],"additionalProperties":false},{"type":"null"}]},"taps":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["x","y"],"additionalProperties":false}}},"required":["option","text","tier","attestationRef","answeredAt"],"additionalProperties":false}},"breakdown":{"type":"array","items":{"type":"object","properties":{"tagId":{"type":"string"},"label":{"type":"string"},"n":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"distribution":{"type":"array","items":{"type":"object","properties":{"option":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"share":{"type":"number"},"averageRank":{"type":"number"},"appearances":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"strength":{"type":"number"},"rank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["option","count","share"],"additionalProperties":false}}},"required":["tagId","label","n","distribution"],"additionalProperties":false}},"refundCredits":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"breakdowns":{"type":"array","items":{"type":"object","properties":{"dimension":{"type":"string","enum":["country","tier","age_band","gender","tag"]},"segments":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"n":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"distribution":{"type":"array","items":{"type":"object","properties":{"option":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"share":{"type":"number"},"averageRank":{"type":"number"},"appearances":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"strength":{"type":"number"},"rank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["option","count","share"],"additionalProperties":false}}},"required":["label","n","distribution"],"additionalProperties":false}}},"required":["dimension","segments"],"additionalProperties":false}},"clicks":{"type":"object","properties":{"imageUrl":{"type":["string","null"]},"taps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"points":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["x","y"],"additionalProperties":false}},"grid":{"type":"array","items":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"gridSize":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"hotspots":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"share":{"type":"number"}},"required":["x","y","w","h","count","share"],"additionalProperties":false}},"heatmapUrl":{"type":["string","null"]}},"required":["imageUrl","taps","points","grid","gridSize","hotspots","heatmapUrl"],"additionalProperties":false},"sentiment":{"type":"object","properties":{"positive":{"type":"number"},"neutral":{"type":"number"},"negative":{"type":"number"}},"required":["positive","neutral","negative"],"additionalProperties":false},"translationLanguage":{"type":["string","null"]},"insights":{"anyOf":[{"type":"object","properties":{"questionId":{"type":"string"},"language":{"type":"string"},"sourceLanguage":{"type":"string"},"takeaway":{"type":"string"},"themes":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"share":{"type":"number"},"sentiment":{"type":"string","enum":["positive","neutral","negative"]},"option":{"type":["string","null"]},"quotes":{"maxItems":3,"type":"array","items":{"type":"string"}}},"required":["label","count","share","sentiment","option","quotes"],"additionalProperties":false}},"sentiment":{"type":"object","properties":{"positive":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"neutral":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"negative":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["positive","neutral","negative"],"additionalProperties":false},"basedOn":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"answersAtTime":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"original":{"anyOf":[{"type":"object","properties":{"takeaway":{"type":"string"},"themes":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"quotes":{"type":"array","items":{"type":"string"}}},"required":["label","quotes"],"additionalProperties":false}}},"required":["takeaway","themes"],"additionalProperties":false},{"type":"null"}]},"kind":{"type":"string","enum":["interim","final"]},"generatedAt":{"type":"string"},"refreshAfter":{"type":["string","null"]},"engine":{"type":"string"}},"required":["questionId","language","sourceLanguage","takeaway","themes","sentiment","basedOn","answersAtTime","original","kind","generatedAt","refreshAfter","engine"],"additionalProperties":false},{"type":"null"}]},"filter":{"type":"object","properties":{"option":{"type":"integer","minimum":0,"maximum":8},"tier":{"type":"integer","minimum":1,"maximum":3},"country":{},"ageBand":{"type":"string","pattern":"^[0-9]{2}(-[0-9]{2}|\\+)$"},"gender":{"type":"string","enum":["woman","man","non_binary"]},"q":{"type":"string","minLength":1,"maxLength":100}},"additionalProperties":false},"nUnfiltered":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"suppressed":{"type":"boolean"},"facets":{"type":"object","properties":{"tiers":{"type":"array","items":{"type":"object","properties":{"tier":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"n":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["tier","n"],"additionalProperties":false}},"countries":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"string"},"n":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["code","label","n"],"additionalProperties":false}},"ageBands":{"type":"array","items":{"type":"object","properties":{"band":{"type":"string"},"n":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["band","n"],"additionalProperties":false}},"genders":{"type":"array","items":{"type":"object","properties":{"gender":{"type":"string"},"n":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["gender","n"],"additionalProperties":false}}},"required":["tiers","countries","ageBands"],"additionalProperties":false}},"required":["questionId","status","nRequested","nAccepted","distribution","mean","summary","tier","language","verificationLine","medianSeconds","creditsSpent","answers","refundCredits"],"additionalProperties":false},"Template":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"draft":{"type":"object","properties":{"type":{"type":"string","enum":["single_choice","multi_choice","ab_image","pairwise","scale_1_5","ranking","yes_mostly_no","free_text","click_test","reaction"]},"text":{"type":"string","maxLength":600},"context":{"type":"string","maxLength":120},"language":{"default":"en","type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$"},"options":{"default":[],"maxItems":8,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","maxLength":40},"imageUrl":{"type":"string","format":"uri"}},"required":["label"],"additionalProperties":false}},"neither":{"default":false,"type":"boolean"},"stimulus":{"type":"object","properties":{"imageUrl":{"type":"string","format":"uri"},"audioUrl":{"type":"string","format":"uri"},"text":{"type":"string","maxLength":120},"exposureMs":{"type":"integer","minimum":2000,"maximum":10000}},"additionalProperties":false},"n":{"default":50,"type":"integer","minimum":10,"maximum":5000},"tier":{"default":1,"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3}]},"rush":{"default":false,"type":"boolean"},"targeting":{"type":"object","properties":{"countries":{"default":[],"maxItems":50,"type":"array","items":{"type":"string","minLength":2,"maxLength":2}},"tags":{"default":[],"maxItems":20,"type":"array","items":{"type":"string"}},"ageBands":{"maxItems":6,"type":"array","items":{"type":"string","enum":["18-24","25-34","35-44","45-54","55-64","65+"]}},"genders":{"maxItems":3,"type":"array","items":{"type":"string","enum":["woman","man","non_binary"]}},"verifiedAge":{"type":"boolean"}},"required":["countries","tags"],"additionalProperties":false},"clickTest":{"type":"object","properties":{"maxTaps":{"default":1,"type":"integer","minimum":1,"maximum":5}},"required":["maxTaps"],"additionalProperties":false},"scheduledFor":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"publicResults":{"default":false,"type":"boolean"},"reason":{"default":"off","type":"string","enum":["off","optional","required"]},"contentFlag":{"type":"string","enum":["none","medical","violence","distressing","alcohol_gambling","political"]}},"required":["type","text","language","options","neither","n","tier","rush","publicResults","reason"],"additionalProperties":false},"priceCredits":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","name","description","draft","priceCredits"],"additionalProperties":false},"Draft":{"type":"object","properties":{"id":{"type":"string"},"draft":{"type":"object","properties":{"type":{"type":"string","enum":["single_choice","multi_choice","ab_image","pairwise","scale_1_5","ranking","yes_mostly_no","free_text","click_test","reaction"]},"text":{"type":"string","maxLength":600},"context":{"type":"string","maxLength":120},"language":{"default":"en","type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$"},"options":{"default":[],"maxItems":8,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","maxLength":40},"imageUrl":{"type":"string","format":"uri"}},"required":["label"],"additionalProperties":false}},"neither":{"default":false,"type":"boolean"},"stimulus":{"type":"object","properties":{"imageUrl":{"type":"string","format":"uri"},"audioUrl":{"type":"string","format":"uri"},"text":{"type":"string","maxLength":120},"exposureMs":{"type":"integer","minimum":2000,"maximum":10000}},"additionalProperties":false},"n":{"default":50,"type":"integer","minimum":10,"maximum":5000},"tier":{"default":1,"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3}]},"rush":{"default":false,"type":"boolean"},"targeting":{"type":"object","properties":{"countries":{"default":[],"maxItems":50,"type":"array","items":{"type":"string","minLength":2,"maxLength":2}},"tags":{"default":[],"maxItems":20,"type":"array","items":{"type":"string"}},"ageBands":{"maxItems":6,"type":"array","items":{"type":"string","enum":["18-24","25-34","35-44","45-54","55-64","65+"]}},"genders":{"maxItems":3,"type":"array","items":{"type":"string","enum":["woman","man","non_binary"]}},"verifiedAge":{"type":"boolean"}},"required":["countries","tags"],"additionalProperties":false},"clickTest":{"type":"object","properties":{"maxTaps":{"default":1,"type":"integer","minimum":1,"maximum":5}},"required":["maxTaps"],"additionalProperties":false},"scheduledFor":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"publicResults":{"default":false,"type":"boolean"},"reason":{"default":"off","type":"string","enum":["off","optional","required"]},"contentFlag":{"type":"string","enum":["none","medical","violence","distressing","alcohol_gambling","political"]}},"required":["type"],"additionalProperties":false},"updatedAt":{"type":"string"}},"required":["id","draft","updatedAt"],"additionalProperties":false},"Balance":{"type":"object","properties":{"credits":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"reserved":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expiring":{"type":"array","items":{"type":"object","properties":{"credits":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expiresAt":{"type":"string"}},"required":["credits","expiresAt"],"additionalProperties":false}},"currency":{"type":"string","enum":["GBP","USD","EUR","CAD"]},"capRemaining":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"freeQuestionToday":{"type":"boolean"}},"required":["credits","reserved","expiring","currency","capRemaining","freeQuestionToday"],"additionalProperties":false},"LedgerRow":{"type":"object","properties":{"id":{"type":"string"},"at":{"type":"string"},"kind":{"type":"string","enum":["purchase","ask","refund","say","bonus","referral","payout","payout_returned","fee","expiry","clawback","adjustment","tier2_fee","not_paid"]},"title":{"type":"string"},"state":{"type":"string","enum":["pending","available","in_flight","paid","reversed","not_paid"]},"amount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ref":{"type":["string","null"]},"notPaid":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string","enum":["rejected","clawback"]},"reason":{"type":"string","enum":["too_fast","repeat","check_question","automated","linked_accounts","shared_payout_method","confirmed_fraud"]},"amount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"status":{"type":"string","enum":["not_paid","appealed","upheld","not_upheld"]},"appealBy":{"type":["string","null"]},"decisionBy":{"type":["string","null"]}},"required":["id","source","reason","amount","status","appealBy","decisionBy"],"additionalProperties":false},{"type":"null"}]},"by":{"type":["string","null"]},"releaseAt":{"type":["string","null"]}},"required":["id","at","kind","title","state","amount","ref"],"additionalProperties":false},"AppConfig":{"type":"object","properties":{"rates":{"type":"object","propertyNames":{"type":"string","enum":["GBP","USD","EUR","CAD"]},"additionalProperties":{"type":"number"},"required":["GBP","USD","EUR","CAD"]},"ratesDate":{"type":"string"},"countries":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"payMultiplier":{"type":"number"},"minWithdrawalPence":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"payoutRails":{"type":"array","items":{"type":"string"}},"otpChannel":{"type":"string","enum":["sms","whatsapp"]},"taxFields":{"type":"array","items":{"type":"string"}},"tier2Available":{"type":"boolean"},"currency":{"type":"string","enum":["GBP","USD","EUR","CAD"]},"wiseFields":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"example":{"type":"string"},"pattern":{"type":"string"}},"required":["key","label"],"additionalProperties":false}}},"required":["payMultiplier","minWithdrawalPence","payoutRails","otpChannel","taxFields","tier2Available","currency"],"additionalProperties":false}},"defaultCountry":{"type":"object","properties":{"payMultiplier":{"type":"number"},"minWithdrawalPence":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"payoutRails":{"type":"array","items":{"type":"string"}},"otpChannel":{"type":"string","enum":["sms","whatsapp"]},"taxFields":{"type":"array","items":{"type":"string"}},"tier2Available":{"type":"boolean"},"currency":{"type":"string","enum":["GBP","USD","EUR","CAD"]},"wiseFields":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"example":{"type":"string"},"pattern":{"type":"string"}},"required":["key","label"],"additionalProperties":false}}},"required":["payMultiplier","minWithdrawalPence","payoutRails","otpChannel","taxFields","tier2Available","currency"],"additionalProperties":false},"questionLanguages":{"type":"array","items":{"type":"string","enum":["en","es","pt","hi","fr","de","id","tl"]}},"reverifyDays":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tier1PayPence":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tier2PayMultiplier":{"type":"number"},"answeringCountries":{"type":"array","items":{"type":"string"}}},"required":["rates","ratesDate","countries","defaultCountry","questionLanguages","reverifyDays","tier1PayPence","tier2PayMultiplier"],"additionalProperties":false},"PublicStats":{"type":"object","properties":{"headsOnlineNow":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"answersThisWeek":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"medianMinutesTo50":{"type":"number"},"headEarningsPerHour":{"type":"object","properties":{"low":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"high":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["low","high"],"additionalProperties":false},"updatedAt":{"type":"string"}},"required":["headsOnlineNow","answersThisWeek","medianMinutesTo50","headEarningsPerHour","updatedAt"],"additionalProperties":false},"CountryAvailability":{"type":"object","properties":{"code":{"type":"string","minLength":2,"maxLength":2},"name":{"type":"string"},"languages":{"type":"array","items":{"type":"string"}},"tier2Available":{"type":"boolean"},"poolBands":{"type":"object","properties":{"tier1":{"type":["string","null"]},"tier2":{"type":["string","null"]},"tier3":{"type":["string","null"]}},"required":["tier1","tier2","tier3"],"additionalProperties":false}},"required":["code","name","languages","tier2Available","poolBands"],"additionalProperties":false},"TagCatalogue":{"type":"object","properties":{"groups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","enum":["life_stage","household","income","education","occupation","interests","habits","shopping","health","media","pets","tech"]},"label":{"type":"string"},"why":{"type":"string"},"max":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","label","why","max"],"additionalProperties":false}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"group":{"type":"string","enum":["life_stage","household","income","education","occupation","interests","habits","shopping","health","media","pets","tech"]},"label":{"type":"string"}},"required":["id","group","label"],"additionalProperties":false}}},"required":["groups","tags"],"additionalProperties":false},"WebhookEndpoint":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"events":{"type":"array","items":{"type":"string","enum":["question.reserved","question.completed","question.underfilled","question.cancelled","question.refused","credits.purchased","credits.low","credits.expiring","dispute.resolved","connection.cap_warning"]}},"secret":{"type":"string"},"createdAt":{"type":"string"},"lastDeliveryAt":{"type":["string","null"]},"lastStatus":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"description":{"type":["string","null"]},"enabled":{"type":"boolean"},"disabledReason":{"type":["string","null"]},"lastSuccessAt":{"type":["string","null"]}},"required":["id","url","events","secret","createdAt","lastDeliveryAt","lastStatus"],"additionalProperties":false},"Quote":{"type":"object","properties":{"creditsPerAnswer":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"creditsTotal":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"payPerAnswer":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"etaMinutes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"traits":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"breakdown":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"}},"required":["label","value"],"additionalProperties":false}},"breakdownLine":{"type":"string"},"validation":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"required":["field","code","message"],"additionalProperties":false}},"poolSize":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["creditsPerAnswer","creditsTotal","payPerAnswer","etaMinutes","traits","breakdown","breakdownLine","validation","poolSize"],"additionalProperties":false},"TemplatesResponse":{"type":"object","properties":{"templates":{"type":"array","items":{"$ref":"#/components/schemas/Template"}}},"required":["templates"],"additionalProperties":false},"CountriesResponse":{"type":"object","properties":{"countries":{"type":"array","items":{"$ref":"#/components/schemas/CountryAvailability"}},"updatedAt":{"type":"string"}},"required":["countries","updatedAt"],"additionalProperties":false},"AskResponse":{"type":"object","properties":{"question":{"$ref":"#/components/schemas/QuestionV2"}},"required":["question"],"additionalProperties":false},"ListResponse":{"type":"object","properties":{"questions":{"type":"array","items":{"$ref":"#/components/schemas/QuestionV2"}},"nextCursor":{"type":["string","null"]}},"required":["questions","nextCursor"],"additionalProperties":false},"LabelsResponse":{"type":"object","properties":{"labels":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["label","count"],"additionalProperties":false}}},"required":["labels"],"additionalProperties":false},"ProjectsListResponse":{"type":"object","properties":{"projects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"goal":{"type":["string","null"]},"bookmarked":{"type":"boolean"},"archived":{"type":"boolean"},"questionCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","description","goal","bookmarked","archived","questionCount","createdAt","updatedAt"],"additionalProperties":false}}},"required":["projects"],"additionalProperties":false},"ProjectsCreateResponse":{"type":"object","properties":{"project":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"goal":{"type":["string","null"]},"bookmarked":{"type":"boolean"},"archived":{"type":"boolean"},"questionCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","description","goal","bookmarked","archived","questionCount","createdAt","updatedAt"],"additionalProperties":false}},"required":["project"],"additionalProperties":false},"ProjectsUpdateResponse":{"type":"object","properties":{"project":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"goal":{"type":["string","null"]},"bookmarked":{"type":"boolean"},"archived":{"type":"boolean"},"questionCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","description","goal","bookmarked","archived","questionCount","createdAt","updatedAt"],"additionalProperties":false}},"required":["project"],"additionalProperties":false},"ProjectsDeleteResponse":{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false},"ResultResponse":{"type":"object","properties":{"result":{"$ref":"#/components/schemas/ResultV2"}},"required":["result"],"additionalProperties":false},"AnswersResponse":{"type":"object","properties":{"questionId":{"type":"string"},"filter":{"type":"object","properties":{"option":{"type":"integer","minimum":0,"maximum":8},"tier":{"type":"integer","minimum":1,"maximum":3},"country":{},"ageBand":{"type":"string","pattern":"^[0-9]{2}(-[0-9]{2}|\\+)$"},"gender":{"type":"string","enum":["woman","man","non_binary"]},"q":{"type":"string","minLength":1,"maxLength":100}},"additionalProperties":false},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"nUnfiltered":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"suppressed":{"type":"boolean"},"answers":{"type":"array","items":{"type":"object","properties":{"option":{"type":["string","null"]},"text":{"type":["string","null"]},"translatedText":{"type":["string","null"]},"reason":{"type":["string","null"]},"translatedReason":{"type":["string","null"]},"tier":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"attestationRef":{"type":"string"},"answeredAt":{"type":"string"},"pinned":{"type":"boolean"},"flag":{"anyOf":[{"type":"object","properties":{"reason":{"type":"string","enum":["off_topic","low_effort","abusive","automated"]},"status":{"type":"string","enum":["open","upheld","dismissed"]},"refundCredits":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"},"decidedAt":{"type":["string","null"]}},"required":["reason","status","refundCredits","createdAt","decidedAt"],"additionalProperties":false},{"type":"null"}]},"taps":{"type":"array","items":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["x","y"],"additionalProperties":false}}},"required":["option","text","tier","attestationRef","answeredAt"],"additionalProperties":false}},"translationLanguage":{"type":["string","null"]},"nextCursor":{"type":["string","null"]}},"required":["questionId","filter","total","nUnfiltered","suppressed","answers","translationLanguage","nextCursor"],"additionalProperties":false},"InsightsResponse":{"type":"object","properties":{"insights":{"anyOf":[{"type":"object","properties":{"questionId":{"type":"string"},"language":{"type":"string"},"sourceLanguage":{"type":"string"},"takeaway":{"type":"string"},"themes":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"share":{"type":"number"},"sentiment":{"type":"string","enum":["positive","neutral","negative"]},"option":{"type":["string","null"]},"quotes":{"maxItems":3,"type":"array","items":{"type":"string"}}},"required":["label","count","share","sentiment","option","quotes"],"additionalProperties":false}},"sentiment":{"type":"object","properties":{"positive":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"neutral":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"negative":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["positive","neutral","negative"],"additionalProperties":false},"basedOn":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"answersAtTime":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"original":{"anyOf":[{"type":"object","properties":{"takeaway":{"type":"string"},"themes":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"quotes":{"type":"array","items":{"type":"string"}}},"required":["label","quotes"],"additionalProperties":false}}},"required":["takeaway","themes"],"additionalProperties":false},{"type":"null"}]},"kind":{"type":"string","enum":["interim","final"]},"generatedAt":{"type":"string"},"refreshAfter":{"type":["string","null"]},"engine":{"type":"string"}},"required":["questionId","language","sourceLanguage","takeaway","themes","sentiment","basedOn","answersAtTime","original","kind","generatedAt","refreshAfter","engine"],"additionalProperties":false},{"type":"null"}]}},"required":["insights"],"additionalProperties":false},"SummariseResponse":{"type":"object","properties":{"insights":{"anyOf":[{"type":"object","properties":{"questionId":{"type":"string"},"language":{"type":"string"},"sourceLanguage":{"type":"string"},"takeaway":{"type":"string"},"themes":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"share":{"type":"number"},"sentiment":{"type":"string","enum":["positive","neutral","negative"]},"option":{"type":["string","null"]},"quotes":{"maxItems":3,"type":"array","items":{"type":"string"}}},"required":["label","count","share","sentiment","option","quotes"],"additionalProperties":false}},"sentiment":{"type":"object","properties":{"positive":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"neutral":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"negative":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["positive","neutral","negative"],"additionalProperties":false},"basedOn":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"answersAtTime":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"original":{"anyOf":[{"type":"object","properties":{"takeaway":{"type":"string"},"themes":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"quotes":{"type":"array","items":{"type":"string"}}},"required":["label","quotes"],"additionalProperties":false}}},"required":["takeaway","themes"],"additionalProperties":false},{"type":"null"}]},"kind":{"type":"string","enum":["interim","final"]},"generatedAt":{"type":"string"},"refreshAfter":{"type":["string","null"]},"engine":{"type":"string"}},"required":["questionId","language","sourceLanguage","takeaway","themes","sentiment","basedOn","answersAtTime","original","kind","generatedAt","refreshAfter","engine"],"additionalProperties":false},{"type":"null"}]}},"required":["insights"],"additionalProperties":false},"WaitResponse":{"type":"object","properties":{"result":{"$ref":"#/components/schemas/ResultV2"},"done":{"type":"boolean"}},"required":["result","done"],"additionalProperties":false},"CancelResponse":{"type":"object","properties":{"question":{"$ref":"#/components/schemas/QuestionV2"},"refundCredits":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["question","refundCredits"],"additionalProperties":false},"ShareResponse":{"type":"object","properties":{"publicCode":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["publicCode","url"],"additionalProperties":false},"ExportLinkResponse":{"type":"object","properties":{"export":{"type":"object","properties":{"format":{"type":"string","enum":["pdf","png"]},"size":{"anyOf":[{"type":"string","enum":["square","wide","story"]},{"type":"null"}]},"url":{"type":"string"},"filename":{"type":"string"},"expiresAt":{"type":"string"}},"required":["format","size","url","filename","expiresAt"],"additionalProperties":false}},"required":["export"],"additionalProperties":false},"AddHeadsResponse":{"type":"object","properties":{"question":{"$ref":"#/components/schemas/QuestionV2"},"quote":{"type":"object","properties":{"n":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"creditsPerAnswer":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"creditsTotal":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"etaMinutes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"newTarget":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"line":{"type":"string"}},"required":["n","creditsPerAnswer","creditsTotal","etaMinutes","newTarget","line"],"additionalProperties":false},"creditsReserved":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["quote"],"additionalProperties":false},"FlagAnswerResponse":{"type":"object","properties":{"flag":{"type":"object","properties":{"reason":{"type":"string","enum":["off_topic","low_effort","abusive","automated"]},"status":{"type":"string","enum":["open","upheld","dismissed"]},"refundCredits":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"},"decidedAt":{"type":["string","null"]},"id":{"type":"string"},"attestationRef":{"type":"string"}},"required":["reason","status","refundCredits","createdAt","decidedAt","id","attestationRef"],"additionalProperties":false}},"required":["flag"],"additionalProperties":false},"PinAnswerResponse":{"type":"object","properties":{"pinned":{"type":"boolean"}},"required":["pinned"],"additionalProperties":false},"ShareLinksResponse":{"type":"object","properties":{"links":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":["string","null"]},"createdAt":{"type":"string"},"expiresAt":{"type":"string"},"revokedAt":{"type":["string","null"]},"views":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"lastViewedAt":{"type":["string","null"]}},"required":["id","url","createdAt","expiresAt","revokedAt","views","lastViewedAt"],"additionalProperties":false}}},"required":["links"],"additionalProperties":false},"CreateShareLinkResponse":{"type":"object","properties":{"link":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":["string","null"]},"createdAt":{"type":"string"},"expiresAt":{"type":"string"},"revokedAt":{"type":["string","null"]},"views":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"lastViewedAt":{"type":["string","null"]}},"required":["id","url","createdAt","expiresAt","revokedAt","views","lastViewedAt"],"additionalProperties":false}},"required":["link"],"additionalProperties":false},"RevokeShareLinkResponse":{"type":"object","properties":{"link":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":["string","null"]},"createdAt":{"type":"string"},"expiresAt":{"type":"string"},"revokedAt":{"type":["string","null"]},"views":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"lastViewedAt":{"type":["string","null"]}},"required":["id","url","createdAt","expiresAt","revokedAt","views","lastViewedAt"],"additionalProperties":false}},"required":["link"],"additionalProperties":false},"SharedResultResponse":{"type":"object","properties":{"question":{"$ref":"#/components/schemas/QuestionV2"},"result":{"$ref":"#/components/schemas/ResultV2"},"expiresAt":{"type":"string"}},"required":["question","result","expiresAt"],"additionalProperties":false},"PublicResultResponse":{"type":"object","properties":{"question":{"$ref":"#/components/schemas/QuestionV2"},"result":{"$ref":"#/components/schemas/ResultV2"}},"required":["question","result"],"additionalProperties":false},"DraftsListResponse":{"type":"object","properties":{"drafts":{"type":"array","items":{"$ref":"#/components/schemas/Draft"}}},"required":["drafts"],"additionalProperties":false},"UploadsResponse":{"type":"object","properties":{"uploadUrl":{"type":"string"},"publicUrl":{"type":"string"},"headers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["uploadUrl","publicUrl","headers"],"additionalProperties":false},"UploadsImportResponse":{"type":"object","properties":{"publicUrl":{"type":"string"},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["publicUrl","width","height"],"additionalProperties":false},"LedgerResponse":{"type":"object","properties":{"rows":{"type":"array","items":{"$ref":"#/components/schemas/LedgerRow"}},"nextCursor":{"type":["string","null"]}},"required":["rows","nextCursor"],"additionalProperties":false},"SupportTicketResponse":{"type":"object","properties":{"ticketId":{"type":"string"}},"required":["ticketId"],"additionalProperties":false},"WebhooksListResponse":{"type":"object","properties":{"endpoints":{"type":"array","items":{"$ref":"#/components/schemas/WebhookEndpoint"}}},"required":["endpoints"],"additionalProperties":false},"WebhooksCreateResponse":{"type":"object","properties":{"endpoint":{"$ref":"#/components/schemas/WebhookEndpoint"}},"required":["endpoint"],"additionalProperties":false},"QuestionDraft":{"type":"object","properties":{"type":{"type":"string","enum":["single_choice","multi_choice","ab_image","pairwise","scale_1_5","ranking","yes_mostly_no","free_text","click_test","reaction"]},"text":{"type":"string","maxLength":600},"context":{"type":"string","maxLength":120},"language":{"default":"en","type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$"},"options":{"default":[],"maxItems":8,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","maxLength":40},"imageUrl":{"type":"string","format":"uri"}},"required":["label"]}},"neither":{"default":false,"type":"boolean"},"stimulus":{"type":"object","properties":{"imageUrl":{"type":"string","format":"uri"},"audioUrl":{"type":"string","format":"uri"},"text":{"type":"string","maxLength":120},"exposureMs":{"type":"integer","minimum":2000,"maximum":10000}}},"n":{"default":50,"type":"integer","minimum":10,"maximum":5000},"tier":{"default":1,"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3}]},"rush":{"default":false,"type":"boolean"},"targeting":{"type":"object","properties":{"countries":{"default":[],"maxItems":50,"type":"array","items":{"type":"string","minLength":2,"maxLength":2}},"tags":{"default":[],"maxItems":20,"type":"array","items":{"type":"string"}},"ageBands":{"maxItems":6,"type":"array","items":{"type":"string","enum":["18-24","25-34","35-44","45-54","55-64","65+"]}},"genders":{"maxItems":3,"type":"array","items":{"type":"string","enum":["woman","man","non_binary"]}},"verifiedAge":{"type":"boolean"}}},"clickTest":{"type":"object","properties":{"maxTaps":{"default":1,"type":"integer","minimum":1,"maximum":5}}},"scheduledFor":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"publicResults":{"default":false,"type":"boolean"},"reason":{"default":"off","type":"string","enum":["off","optional","required"]},"contentFlag":{"type":"string","enum":["none","medical","violence","distressing","alcohol_gambling","political"]}},"required":["type","text"]},"QuestionUpdate":{"type":"object","properties":{"minAnswers":{"type":"integer","minimum":1,"maximum":5000},"projectId":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}]},"labels":{"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":40,"pattern":"^[^,]+$"}},"archived":{"type":"boolean"},"bookmarked":{"type":"boolean"},"externalRef":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[\\w.:\\-/#@+]+$"}}},"CheckoutInput":{"type":"object","properties":{"pack":{"type":"string"},"currency":{"type":"string","enum":["GBP","USD","EUR","CAD"]},"method":{"type":"string","enum":["card","bank_transfer"]},"returnPath":{"type":"string","pattern":"^\\/app(\\/[\\w\\-/]*)?$"}},"required":["pack","currency","method"]},"SupportTicketInput":{"type":"object","properties":{"subject":{"type":"string","minLength":3,"maxLength":140},"body":{"type":"string","minLength":10,"maxLength":5000},"appVersion":{"type":"string","maxLength":40},"category":{"type":"string","enum":["payout","payout_failed","account","account_frozen","verification","question","billing","api","security","privacy","other"]},"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"locale":{"type":"string","maxLength":10}},"required":["subject","body"]},"EstimateRequest":{"type":"object","properties":{"draft":{"$ref":"#/components/schemas/QuestionDraft"},"surface":{"type":"string","enum":["app","web"]}},"required":["draft"]},"AskRequest":{"type":"object","properties":{"draft":{"$ref":"#/components/schemas/QuestionDraft"},"fromDraftId":{"type":"string"},"then":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"type":{"default":"free_text","type":"string","enum":["single_choice","multi_choice","ab_image","pairwise","scale_1_5","ranking","yes_mostly_no","free_text","click_test","reaction"]},"text":{"type":"string","minLength":8,"maxLength":600},"options":{"default":[],"maxItems":8,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","maxLength":40},"imageUrl":{"type":"string","format":"uri"}},"required":["label"]}},"n":{"default":20,"type":"integer","minimum":10,"maximum":5000},"tier":{"default":2,"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3}]},"minConfidence":{"type":"string","enum":["low","medium","high"]},"reason":{"type":"string","enum":["off","optional","required"]}},"required":["text"]}},"variantOf":{"type":"string"},"templateId":{"type":"string"},"projectId":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}]},"labels":{"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":40,"pattern":"^[^,]+$"}},"externalRef":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[\\w.:\\-/#@+]+$"}},"required":["draft"]},"ProjectsCreateRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"goal":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}]}},"required":["name"]},"ProjectsUpdateRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"goal":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}]},"bookmarked":{"type":"boolean"},"archived":{"type":"boolean"}}},"ShareRequest":{"type":"object","properties":{"public":{"type":"boolean"}},"required":["public"]},"ExportLinkRequest":{"type":"object","properties":{"format":{"type":"string","enum":["pdf","png"]},"size":{"type":"string","enum":["square","wide","story"]}},"required":["format"]},"AddHeadsRequest":{"type":"object","properties":{"n":{"type":"integer","minimum":1,"maximum":5000},"dryRun":{"type":"boolean"}},"required":["n"]},"FlagAnswerRequest":{"type":"object","properties":{"reason":{"type":"string","enum":["off_topic","low_effort","abusive","automated"]},"note":{"type":"string","maxLength":500}},"required":["reason"]},"PinAnswerRequest":{"type":"object","properties":{"pinned":{"type":"boolean"}},"required":["pinned"]},"CreateShareLinkRequest":{"type":"object","properties":{"expiresInDays":{"default":30,"type":"integer","minimum":1,"maximum":90}}},"DisputeRequest":{"type":"object","properties":{"reason":{"type":"string","minLength":10,"maxLength":2000}},"required":["reason"]},"DraftsSaveRequest":{"type":"object","properties":{"type":{"type":"string","enum":["single_choice","multi_choice","ab_image","pairwise","scale_1_5","ranking","yes_mostly_no","free_text","click_test","reaction"]},"text":{"type":"string","maxLength":600},"context":{"type":"string","maxLength":120},"language":{"default":"en","type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$"},"options":{"default":[],"maxItems":8,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","maxLength":40},"imageUrl":{"type":"string","format":"uri"}},"required":["label"]}},"neither":{"default":false,"type":"boolean"},"stimulus":{"type":"object","properties":{"imageUrl":{"type":"string","format":"uri"},"audioUrl":{"type":"string","format":"uri"},"text":{"type":"string","maxLength":120},"exposureMs":{"type":"integer","minimum":2000,"maximum":10000}}},"n":{"default":50,"type":"integer","minimum":10,"maximum":5000},"tier":{"default":1,"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3}]},"rush":{"default":false,"type":"boolean"},"targeting":{"type":"object","properties":{"countries":{"default":[],"maxItems":50,"type":"array","items":{"type":"string","minLength":2,"maxLength":2}},"tags":{"default":[],"maxItems":20,"type":"array","items":{"type":"string"}},"ageBands":{"maxItems":6,"type":"array","items":{"type":"string","enum":["18-24","25-34","35-44","45-54","55-64","65+"]}},"genders":{"maxItems":3,"type":"array","items":{"type":"string","enum":["woman","man","non_binary"]}},"verifiedAge":{"type":"boolean"}}},"clickTest":{"type":"object","properties":{"maxTaps":{"default":1,"type":"integer","minimum":1,"maximum":5}}},"scheduledFor":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"publicResults":{"default":false,"type":"boolean"},"reason":{"default":"off","type":"string","enum":["off","optional","required"]},"contentFlag":{"type":"string","enum":["none","medical","violence","distressing","alcohol_gambling","political"]}},"required":["type"]},"UploadsRequest":{"type":"object","properties":{"kind":{"type":"string","enum":["image","audio"]},"contentType":{"type":"string"},"bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["kind","contentType","bytes"]},"UploadsImportRequest":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"]},"WebhooksCreateRequest":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"events":{"type":"array","items":{"type":"string","enum":["question.reserved","question.completed","question.underfilled","question.cancelled","question.refused","credits.purchased","credits.low","credits.expiring","dispute.resolved","connection.cap_warning"]}}},"required":["url","events"]}}}}