Rate limit: 10 requests/secondNote: The GET method returns a list of objects, POST and PATCH accept and return a single object
Query String Parameters (GET)
Name
Description
Required
Example
ids
Comma delimited value of the Survey IDs being retrieved.
No
?ids=1,2,3
project_ids
Comma delimited value of the Project IDs associated with the Surveys being retrieved.
No
?project_ids=1,2,3
statuses
Comma delimited value of the statuses associated with the Surveys being retrieved.
No
?statuses=live,complete
fields
Dictates structure of the response.
No
?fields=id,project_id,status
page
Integer value of the page being retrieved
No; if omitted, the value defaults to 1.
?page=2
page_size
Integer value dictating the number of objects returned per page.
No; if omitted, the value defaults to 50.
?page_size=100
Survey Object Definition
Parameter
Required for POST
Required for PATCH
Description
id
System Assigned
Yes
The ID of the Survey object.
project_id
Yes
No
The ID of the associated Project object.
name
Yes
No
The name of the Survey; there is no uniqueness constraint.
status
No
No
The status of the Survey. Allowable values: - Draft - Scheduled - Live - Paused - Auto-Paused - Complete - Cancelled
respondents
Yes
No
Target (N) of respondents desired for the Survey.
This number can represent Completes or Survey Starts depending on value used in the “calculation_type” field.
country_code
Yes
No
The country in which respondents are being fielded.
language_code
Yes
No
The language of the survey.
length_of_interview
Yes
No
The estimated time, in minutes, required to complete the survey.
incidence_rate
Yes
No
The estimated rate of which respondents will qualify for the survey, based on termination points in the survey.
collects_pii
Yes
No
Boolean indicating if the survey collects personally-identifiable information.
hashing_enabled
Yes
No
Boolean indicating if hashing validation on the complete redirection is enabled. Research Desk supports SHA-256 and SHA-512 hashing algorithms. Supporting documentation here.
completes_check_enabled
No
No
Boolean indicating if COMPLETE API server-side validation of completes is enabled. When omitted on create, defaults to the account-level setting. Availability varies by account.
out_of_field_date
Yes
No
Target out of field date for the Survey.
out_of_field_timezone
Yes
No
User’s timezone. List of values can be found in /definitions/ lookup.
device_compatibilities
Yes
No
List containing respondent device types allowed to engage with Survey. Allowed values: - desktop - mobile - tablet
calculation_type
Yes
No
Defines the calculation method for counting respondents. Allowed values: - Completes (quotas are evaluated based on number of respondents who successfully completed client survey) - Survey Starts (quotas are evaluated based on number of respondent who entered client survey)
traffic_control_limit_type
Yes
No
Traffic control setting which controls the pace at which data collection is paced out on an hourly cadence.
Allowable values: - None: No restriction to traffic generation. - Even Pacing: Max Responses across fielding timeline is near-linear with 1.1x Responses allowed per hourly increment. - Accelerated Pacing: Max Responses across fielding timeline is somewhat linear with 1.4x Responses allowed per hourly increment.
Note that this setting simply limits the max number of Responses that can be collected per hour from the moment the Survey goes live through to the designated out_of_field_date. This setting does not guarantee that a min number of completes is collected per hour.
entry_link
Yes
No
The survey entry link to which respondents will be redirected.
quota_id
System Assigned
Yes, only if, respondent_attributes is present.
Note: If respondent_attributes is present, any quota object that is missing from the list will be removed from the survey.
ID assigned to a quota.
quota_name
Yes
No
Name used to represent a quota.
quota
Yes
No
The number of respondents, meeting the associated qualification criteria, required to complete the survey.
survey_starts
System Assigned
No
The number of respondents that qualified for this quota that have started the survey.
survey_completes
System Assigned
No
The number of respondents that qualified for this quota that have completed the survey.
qualifications
Yes
No
The questions which will be asked of the respondent prior to being redirected to the survey, and the associated allowed answer options. Qualifications are used for targeting and screening respondents.
question_id
Yes
No
Question ID being used to target/screen the respondent.
allowed_option_ids
Yes
No
Array of question IDs that qualify the respondent and make up a desired quota.
redirects
System Assigned
No
The URLs to which respondents must be redirected upon the survey session ending.
desk_test_link
System Assigned
No
Research Desk test entry link for qualification preview (Test Link type). Includes the [%RDUD%] placeholder.
desk_rx_test_link
System Assigned
No
Research Desk live/RX test entry link (Live Link type). Includes the [%RDUD%] placeholder.
minimum_price_per_complete
System Assigned
No
The recommended price floor for the survey, based on the stated length of interview and incidence rate.
offered_price_per_complete
No
No
The price charged per completed survey session, based on the length of interview and incidence rate.
This offer price can be increased using the PATCH /surveys/ endpoint to incentivise respondents and drive more traffic. A price increase may be required for more complex studies with advanced targeting applied.
field_details
System Assigned
No
High-level survey fielding statistics. Returned on GET /surveys. Nested fields are documented on GET Surveys.
JWT access token sent directly in the Authorization header (no Bearer prefix). Accepted tokens: (1) Cognito JWT from POST /tokens, or (2) WorkOS AuthKit access token issued for your Research Desk organization. POST /tokens still issues Cognito tokens only.
Body
application/json
Update survey fields. Supply any fields you wish to update.
{"docsConfig":{"theme":"sequoia","$schema":"https://mintlify.com/docs.json","name":"Rep Data Documentation","colors":{"primary":"#9B31CF","light":"#9B31CF","dark":"#9B31CF"},"logo":{"light":"https://mintcdn.com/repdata/oPuIFCbtr5tUZERq/public/rep-data-logo-inline-light.png?fit=max\u0026auto=format\u0026n=oPuIFCbtr5tUZERq\u0026q=85\u0026s=82f5eeb30e8795397f8c2368e92e9bc1","dark":"https://mintcdn.com/repdata/M70fS1kJzi8uECBc/public/logo.svg?fit=max\u0026auto=format\u0026n=M70fS1kJzi8uECBc\u0026q=85\u0026s=17c7f815fad9b0adde887ba0f9f6c87a"},"favicon":"https://mintcdn.com/repdata/pylBvYgIEi2ZHBns/public/favicon.png?fit=max\u0026auto=format\u0026n=pylBvYgIEi2ZHBns\u0026q=85\u0026s=3d54ba9b8677d7b231163af74f4621ca","styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"repdata","hasAudioNarration":false,"actualSubdomain":"repdata","customDomains":["docs.repdata.com"],"gitSource":{"type":"github","owner":"repdata-team","repo":"product-documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae5025fbbaf7eb08d12765b","collectionId":"fa006f35-77e5-418c-b51d-856ed5314bfa","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae5025fbbaf7eb08d12765b"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae5025fbbaf7eb08d12765b","clientVersion":"0.0.4071","searchFilterCounts":[{"language":"default","tag":"Research Desk","count":38},{"language":"default","tag":"Research Defender","count":34},{"language":"default","tag":"Research Desk Supply API","count":30},{"language":"default","tag":"Integration Guide","count":29},{"language":"default","tag":"Research Desk Demand API","count":27},{"language":"default","tag":"Overview","count":17},{"language":"default","tag":"API Reference (v2)","count":16},{"language":"default","tag":"API Reference","count":15},{"language":"default","tag":"API Reference (v1)","count":14},{"language":"default","tag":"Sources and Fieldwork","count":9}]},"assistantConfig":{"enableStarterQuestions":false},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"accordion#us-genpop-survey-request code-block{display:block;max-height:28rem;overflow-y:auto}:root{--rd-border-light: #64748b;--rd-border-strong: #475569}.dark{--rd-border-light: #94a3b8;--rd-border-strong: #cbd5e1}a.card{border-color:var(--rd-border-light)!important;border-width:1.5px!important;transition:border-color 0.2s ease, box-shadow 0.2s ease, transform 0.2s ease}a.card:hover{border-color:#16a34a!important;box-shadow:0 8px 24px -12px rgba(22, 163, 74, 0.35);transform:translateY(-2px)}div[class*=\"card-group\"],div[class*=\"CardGroup\"],.card-group,#card-group{border-color:transparent!important;background-color:transparent!important;box-shadow:none!important}div[class*=\"callout\"]{border-width:1.5px!important}table{border-color:var(--rd-border-strong)!important}table th,table td{border-color:var(--rd-border-light)!important}pre,code{border-color:var(--rd-border-light)!important}hr{border-color:var(--rd-border-strong)!important;border-top-width:1.5px!important}details,[class*=\"accordion\"]{border-color:var(--rd-border-light)!important}"}],"page":{"pagePath":"demand/endpoints/12-patch-surveys","slug":"/demand/endpoints/12-patch-surveys","pageMetadata":{"title":"Update Survey","openapi":"PATCH /surveys","description":"","href":"/demand/endpoints/12-patch-surveys"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,h5:`h5`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Table}=_components;if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Rate limit: 10 requests/second`}),`\n`,_jsxs(_components.p,{children:[`Note: The `,_jsx(_components.code,{children:`GET`}),` method returns a list of objects, `,_jsx(_components.code,{children:`POST`}),` and `,_jsx(_components.code,{children:`PATCH`}),` accept and return a single object`]}),`\n`,_jsx(_components.h5,{children:`Query String Parameters (GET)`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Name`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Example`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ids`})}),_jsx(_components.td,{children:`Comma delimited value of the Survey IDs being retrieved.`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`?ids=1,2,3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`project_ids`})}),_jsx(_components.td,{children:`Comma delimited value of the Project IDs associated with the Surveys being retrieved.`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`?project_ids=1,2,3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`statuses`})}),_jsx(_components.td,{children:`Comma delimited value of the statuses associated with the Surveys being retrieved.`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`?statuses=live,complete`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`fields`})}),_jsx(_components.td,{children:`Dictates structure of the response.`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`?fields=id,project_id,status`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`page`})}),_jsx(_components.td,{children:`Integer value of the page being retrieved`}),_jsxs(_components.td,{children:[`No; if omitted, the value defaults to `,_jsx(_components.code,{children:`1`}),`.`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`?page=2`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`page_size`})}),_jsx(_components.td,{children:`Integer value dictating the number of objects returned per page.`}),_jsxs(_components.td,{children:[`No; if omitted, the value defaults to `,_jsx(_components.code,{children:`50`}),`.`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`?page_size=100`})})]})]})]}),`\n`,_jsx(_components.h5,{children:`Survey Object Definition`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsxs(_components.th,{children:[`Required for `,_jsx(_components.code,{children:`POST`})]}),_jsxs(_components.th,{children:[`Required for `,_jsx(_components.code,{children:`PATCH`})]}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`id`})}),_jsx(_components.td,{children:`System Assigned`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`The ID of the Survey object.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`project_id`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`The ID of the associated Project object.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`name`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`The name of the Survey; there is no uniqueness constraint.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`The status of the Survey. Allowable values: `,_jsx(`br`,{}),`- Draft `,_jsx(`br`,{}),`- Scheduled `,_jsx(`br`,{}),`- Live `,_jsx(`br`,{}),`- Paused `,_jsx(`br`,{}),`- Auto-Paused `,_jsx(`br`,{}),`- Complete `,_jsx(`br`,{}),`- Cancelled`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`respondents`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Target (N) of respondents desired for the Survey. `,_jsx(`br`,{}),_jsx(`br`,{}),`This number can represent Completes or Survey Starts depending on value used in the “calculation_type” field.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`country_code`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`The country in which respondents are being fielded.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`language_code`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`The language of the survey.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`length_of_interview`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`The estimated time, in minutes, required to complete the survey.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`incidence_rate`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`The estimated rate of which respondents will qualify for the survey, based on termination points in the survey.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`collects_pii`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Boolean indicating if the survey collects personally-identifiable information.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`hashing_enabled`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Boolean indicating if hashing validation on the complete redirection is enabled. Research Desk supports SHA-256 and SHA-512 hashing algorithms. `,_jsx(_components.a,{href:`https://www.notion.so/repdata/Redirect-Hashing-Guide-4cfedc2b08fb4f82b912ef9606d6924e`,children:`Supporting documentation here`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`completes_check_enabled`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Boolean indicating if COMPLETE API server-side validation of completes is enabled. When omitted on create, defaults to the account-level setting. Availability varies by account.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`out_of_field_date`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Target out of field date for the Survey.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`out_of_field_timezone`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`User’s timezone. List of values can be found in /definitions/ lookup.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`device_compatibilities`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`List containing respondent device types allowed to engage with Survey. `,_jsx(`br`,{}),`Allowed values: `,_jsx(`br`,{}),`- desktop `,_jsx(`br`,{}),`- mobile `,_jsx(`br`,{}),`- tablet`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`calculation_type`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Defines the calculation method for counting respondents. Allowed values: `,_jsx(`br`,{}),`- Completes (quotas are evaluated based on number of respondents who successfully completed client survey) `,_jsx(`br`,{}),`- Survey Starts (quotas are evaluated based on number of respondent who entered client survey)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`traffic_control_limit_type`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Traffic control setting which controls the pace at which data collection is paced out on an hourly cadence. `,_jsx(`br`,{}),_jsx(`br`,{}),`Allowable values: `,_jsx(`br`,{}),`- None: No restriction to traffic generation. `,_jsx(`br`,{}),`- Even Pacing: Max Responses across fielding timeline is near-linear with 1.1x Responses allowed per hourly increment. `,_jsx(`br`,{}),`- Accelerated Pacing: Max Responses across fielding timeline is somewhat linear with 1.4x Responses allowed per hourly increment. `,_jsx(`br`,{}),_jsx(`br`,{}),`Note that this setting simply limits the max number of Responses that can be collected per hour from the moment the Survey goes live through to the designated out_of_field_date. This setting does not guarantee that a min number of completes is collected per hour.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`entry_link`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`The survey entry link to which respondents will be redirected.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`quota_id`})}),_jsx(_components.td,{children:`System Assigned`}),_jsxs(_components.td,{children:[`Yes, only if, `,_jsx(_components.code,{children:`respondent_attributes`}),` is present. `,_jsx(`br`,{}),_jsx(`br`,{}),`Note: If `,_jsx(_components.code,{children:`respondent_attributes`}),` is present, any quota object that is missing from the list will be removed from the survey.`]}),_jsx(_components.td,{children:`ID assigned to a quota.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`quota_name`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Name used to represent a quota.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`quota`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`The number of respondents, meeting the associated qualification criteria, required to complete the survey.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`survey_starts`})}),_jsx(_components.td,{children:`System Assigned`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`The number of respondents that qualified for this quota that have started the survey.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`survey_completes`})}),_jsx(_components.td,{children:`System Assigned`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`The number of respondents that qualified for this quota that have completed the survey.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`qualifications`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`The questions which will be asked of the respondent prior to being redirected to the survey, and the associated allowed answer options. Qualifications are used for targeting and screening respondents.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`question_id`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Question ID being used to target/screen the respondent.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`allowed_option_ids`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Array of question IDs that qualify the respondent and make up a desired quota.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`redirects`})}),_jsx(_components.td,{children:`System Assigned`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`The URLs to which respondents must be redirected upon the survey session ending.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`desk_test_link`})}),_jsx(_components.td,{children:`System Assigned`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Research Desk test entry link for qualification preview (Test Link type). Includes the `,_jsx(_components.code,{children:`[%RDUD%]`}),` placeholder.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`desk_rx_test_link`})}),_jsx(_components.td,{children:`System Assigned`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Research Desk live/RX test entry link (Live Link type). Includes the `,_jsx(_components.code,{children:`[%RDUD%]`}),` placeholder.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`minimum_price_per_complete`})}),_jsx(_components.td,{children:`System Assigned`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`The recommended price floor for the survey, based on the stated length of interview and incidence rate.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`offered_price_per_complete`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`The price charged per completed survey session, based on the length of interview and incidence rate. `,_jsx(`br`,{}),_jsx(`br`,{}),`This offer price can be increased using the PATCH /surveys/ endpoint to incentivise respondents and drive more traffic. A price increase may be required for more complex studies with advanced targeting applied.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`field_details`})}),_jsx(_components.td,{children:`System Assigned`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`High-level survey fielding statistics. Returned on `,_jsx(_components.code,{children:`GET /surveys`}),`. Nested fields are documented on `,_jsx(_components.a,{href:`/demand/endpoints/10-get-surveys`,children:`GET Surveys`}),`.`]})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Update Survey","openapi":"PATCH /surveys","description":"","href":"/demand/endpoints/12-patch-surveys"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"Surveys_Surveys","summary":"Surveys","description":"","parameters":[],"responses":{"200":"b68f8fde-88a6-446b-871c-232aac4da67d"},"requestBody":"21d18120-e8ca-42bc-b191-979e386e8c3e","method":"patch","type":"path","servers":["6e3d76ae-3538-467f-83f6-adb8f69f45c3","e07658bc-5190-4296-93b8-f9acbac86136"],"security":["9ea2b5e0-d103-4f36-81e9-f373e995053e"],"path":"/surveys","baseUrlOptions":["https://demand.researchdesk.com","https://stage-demand.researchdesk.com"],"title":"Surveys","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Update survey fields. Supply any fields you wish to update.","properties":{"id":{"type":"string","uniqueKey":"id","typeLabel":"string"},"name":{"type":"string","uniqueKey":"name","typeLabel":"string"},"status":{"type":"string","uniqueKey":"status","typeLabel":"string"},"completes_wanted":{"type":"integer","uniqueKey":"completes_wanted","typeLabel":"integer"},"length_of_interview":{"type":"integer","uniqueKey":"length_of_interview","typeLabel":"integer"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","name":"\u003cstring>","status":"\u003cstring>","completes_wanted":123,"length_of_interview":123}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"b68f8fde-88a6-446b-871c-232aac4da67d":{"description":"Surveys","content":{"application/json":{"schema":{"type":"object","properties":{"survey":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"survey.id","typeLabel":"string"},"project_id":{"type":"string","uniqueKey":"survey.project_id","typeLabel":"string"},"name":{"type":"string","uniqueKey":"survey.name","typeLabel":"string"},"status":{"type":"string","uniqueKey":"survey.status","typeLabel":"string"},"survey_attributes":{"type":"object","properties":{"respondents":{"type":"integer","uniqueKey":"survey.survey_attributes.respondents","typeLabel":"integer"},"country_code":{"type":"string","uniqueKey":"survey.survey_attributes.country_code","typeLabel":"string"},"language_code":{"type":"string","uniqueKey":"survey.survey_attributes.language_code","typeLabel":"string"},"length_of_interview":{"type":"integer","uniqueKey":"survey.survey_attributes.length_of_interview","typeLabel":"integer"},"incidence_rate":{"type":"integer","uniqueKey":"survey.survey_attributes.incidence_rate","typeLabel":"integer"},"minimum_price_per_complete":{"type":"number","uniqueKey":"survey.survey_attributes.minimum_price_per_complete","typeLabel":"number"},"offered_price_per_complete":{"type":"number","uniqueKey":"survey.survey_attributes.offered_price_per_complete","typeLabel":"number"},"device_compatibilities":{"type":"array","items":{"type":"string","uniqueKey":"survey.survey_attributes.device_compatibilities.items.[INDEX]","typeLabel":"string"},"uniqueKey":"survey.survey_attributes.device_compatibilities","typeLabel":"string[]"},"collects_pii":{"type":"boolean","uniqueKey":"survey.survey_attributes.collects_pii","typeLabel":"boolean"},"hashing_enabled":{"type":"boolean","uniqueKey":"survey.survey_attributes.hashing_enabled","typeLabel":"boolean"},"completes_check_enabled":{"type":"boolean","description":"Whether COMPLETE API server-side validation of completes is enabled. Optional on create; defaults to the account-level setting.","uniqueKey":"survey.survey_attributes.completes_check_enabled","typeLabel":"boolean"},"calculation_type":{"type":"string","uniqueKey":"survey.survey_attributes.calculation_type","typeLabel":"string"},"traffic_control_limit_type":{"type":"string","uniqueKey":"survey.survey_attributes.traffic_control_limit_type","typeLabel":"string"},"out_of_field_date":{"type":"string","uniqueKey":"survey.survey_attributes.out_of_field_date","typeLabel":"string"},"out_of_field_timezone":{"type":"string","uniqueKey":"survey.survey_attributes.out_of_field_timezone","typeLabel":"string"},"entry_link":{"type":"string","uniqueKey":"survey.survey_attributes.entry_link","typeLabel":"string"},"redirects":{"type":"object","properties":{"complete":{"type":"string","uniqueKey":"survey.survey_attributes.redirects.complete","typeLabel":"string"},"standard_termination":{"type":"string","uniqueKey":"survey.survey_attributes.redirects.standard_termination","typeLabel":"string"},"quality_termination":{"type":"string","uniqueKey":"survey.survey_attributes.redirects.quality_termination","typeLabel":"string"},"security_termination":{"type":"string","uniqueKey":"survey.survey_attributes.redirects.security_termination","typeLabel":"string"},"overquota_termination_term":{"type":"string","uniqueKey":"survey.survey_attributes.redirects.overquota_termination_term","typeLabel":"string"}},"uniqueKey":"survey.survey_attributes.redirects","typeLabel":"object"},"desk_test_link":{"oneOf":[{"type":"string","readOnly":true,"description":"System-assigned Research Desk test entry link for qualification preview (Test Link type). Includes [%RDUD%] placeholder.","uniqueKey":"survey.survey_attributes.desk_test_link.oneOf.0","typeLabel":"string"},{"type":"null","readOnly":true,"description":"System-assigned Research Desk test entry link for qualification preview (Test Link type). Includes [%RDUD%] placeholder.","uniqueKey":"survey.survey_attributes.desk_test_link.oneOf.1","typeLabel":"null"}],"uniqueKey":"survey.survey_attributes.desk_test_link","typeLabel":"string | null"},"desk_rx_test_link":{"oneOf":[{"type":"string","readOnly":true,"description":"System-assigned Research Desk live/RX test entry link (Live Link type). Includes [%RDUD%] placeholder.","uniqueKey":"survey.survey_attributes.desk_rx_test_link.oneOf.0","typeLabel":"string"},{"type":"null","readOnly":true,"description":"System-assigned Research Desk live/RX test entry link (Live Link type). Includes [%RDUD%] placeholder.","uniqueKey":"survey.survey_attributes.desk_rx_test_link.oneOf.1","typeLabel":"null"}],"uniqueKey":"survey.survey_attributes.desk_rx_test_link","typeLabel":"string | null"}},"uniqueKey":"survey.survey_attributes","typeLabel":"object"},"respondent_attributes":{"type":"array","items":{"type":"object","properties":{"quota_id":{"type":"string","uniqueKey":"survey.respondent_attributes.items.[INDEX].quota_id","typeLabel":"string"},"quota_name":{"type":"string","uniqueKey":"survey.respondent_attributes.items.[INDEX].quota_name","typeLabel":"string"},"quota":{"type":"integer","uniqueKey":"survey.respondent_attributes.items.[INDEX].quota","typeLabel":"integer"},"survey_starts":{"type":"integer","uniqueKey":"survey.respondent_attributes.items.[INDEX].survey_starts","typeLabel":"integer"},"survey_completes":{"type":"integer","uniqueKey":"survey.respondent_attributes.items.[INDEX].survey_completes","typeLabel":"integer"},"qualifications":{"type":"array","items":{"type":"object","properties":{"question_id":{"type":"integer","uniqueKey":"survey.respondent_attributes.items.[INDEX].qualifications.items.[INDEX].question_id","typeLabel":"integer"},"allowed_option_ids":{"type":"array","items":{"type":"string","uniqueKey":"survey.respondent_attributes.items.[INDEX].qualifications.items.[INDEX].allowed_option_ids.items.[INDEX]","typeLabel":"string"},"uniqueKey":"survey.respondent_attributes.items.[INDEX].qualifications.items.[INDEX].allowed_option_ids","typeLabel":"string[]"}},"uniqueKey":"survey.respondent_attributes.items.[INDEX].qualifications.items.[INDEX]","typeLabel":"object"},"uniqueKey":"survey.respondent_attributes.items.[INDEX].qualifications","typeLabel":"object[]"}},"uniqueKey":"survey.respondent_attributes.items.[INDEX]","typeLabel":"object"},"uniqueKey":"survey.respondent_attributes","typeLabel":"object[]"}},"uniqueKey":"survey","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"survey":{"id":"a038a197-c849-47c8-9c6d-9fe7b497601f","project_id":"78f7fc48-3e66-4b10-ae8f-e6566aa62642","name":"5G Network Adoption and Purchasing Decisions v2","status":"Draft","survey_attributes":{"respondents":2000,"country_code":"US","language_code":"EN","length_of_interview":5,"incidence_rate":90,"out_of_field_date":"2026-05-20 06:00:00","out_of_field_timezone":"(UTC-06:00) Easter Island","minimum_price_per_complete":1.55,"offered_price_per_complete":1.55,"collects_pii":true,"hashing_enabled":false,"completes_check_enabled":false,"device_compatibilities":["Desktop"],"calculation_type":"Completes","traffic_control_limit_type":"None","entry_link":"https://repdata.decipherinc.com/survey/selfserve/53b/220106?list=2\u0026rid=[%RDUD%]","redirects":{"complete":"https://www-staging.rdsecured.com/return?inbound_code=1000\u0026rdud=[%RDUD%]","standard_termination":"https://www-staging.rdsecured.com/return?inbound_code=2000\u0026rdud=[%RDUD%]","quality_termination":"https://www-staging.rdsecured.com/return?inbound_code=1\u0026rdud=[%RDUD%]","security_termination":"https://www-staging.rdsecured.com/return?inbound_code=3000\u0026rdud=[%RDUD%]","overquota_termination_term":"https://www-staging.rdsecured.com/return?inbound_code=4000\u0026rdud=[%RDUD%]"},"desk_test_link":"https://www.rdsecured.com/v2#/qualifications/survey?fttsn=998877\u0026rid=[%RDUD%]","desk_rx_test_link":"https://www.rdsecured.com/v2#/qualifications/survey?fttsn=998878\u0026rid=[%RDUD%]"},"respondent_attributes":[{"quota_id":"8f0cb8ab-c87b-4fd1-9b02-9c61f0c8a26d","quota_name":"30-35","quota":200,"survey_starts":0,"survey_completes":0,"qualifications":[{"question_id":1,"allowed_option_ids":["30","31","32","33","34","35"]}]}]}},"examples":{"Example":{"title":"Example","value":{"survey":{"id":"a038a197-c849-47c8-9c6d-9fe7b497601f","project_id":"78f7fc48-3e66-4b10-ae8f-e6566aa62642","name":"5G Network Adoption and Purchasing Decisions v2","status":"Draft","survey_attributes":{"respondents":2000,"country_code":"US","language_code":"EN","length_of_interview":5,"incidence_rate":90,"out_of_field_date":"2026-05-20 06:00:00","out_of_field_timezone":"(UTC-06:00) Easter Island","minimum_price_per_complete":1.55,"offered_price_per_complete":1.55,"collects_pii":true,"hashing_enabled":false,"completes_check_enabled":false,"device_compatibilities":["Desktop"],"calculation_type":"Completes","traffic_control_limit_type":"None","entry_link":"https://repdata.decipherinc.com/survey/selfserve/53b/220106?list=2\u0026rid=[%RDUD%]","redirects":{"complete":"https://www-staging.rdsecured.com/return?inbound_code=1000\u0026rdud=[%RDUD%]","standard_termination":"https://www-staging.rdsecured.com/return?inbound_code=2000\u0026rdud=[%RDUD%]","quality_termination":"https://www-staging.rdsecured.com/return?inbound_code=1\u0026rdud=[%RDUD%]","security_termination":"https://www-staging.rdsecured.com/return?inbound_code=3000\u0026rdud=[%RDUD%]","overquota_termination_term":"https://www-staging.rdsecured.com/return?inbound_code=4000\u0026rdud=[%RDUD%]"},"desk_test_link":"https://www.rdsecured.com/v2#/qualifications/survey?fttsn=998877\u0026rid=[%RDUD%]","desk_rx_test_link":"https://www.rdsecured.com/v2#/qualifications/survey?fttsn=998878\u0026rid=[%RDUD%]"},"respondent_attributes":[{"quota_id":"8f0cb8ab-c87b-4fd1-9b02-9c61f0c8a26d","quota_name":"30-35","quota":200,"survey_starts":0,"survey_completes":0,"qualifications":[{"question_id":1,"allowed_option_ids":["30","31","32","33","34","35"]}]}]}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"9ea2b5e0-d103-4f36-81e9-f373e995053e":{"AuthToken":{"type":"apiKey","in":"header","name":"Authorization","description":"JWT access token sent directly in the Authorization header (no Bearer prefix). Accepted tokens: (1) Cognito JWT from POST /tokens, or (2) WorkOS AuthKit access token issued for your Research Desk organization. POST /tokens still issues Cognito tokens only.","scopes":[],"schemeName":"AuthToken"}}},"servers":{"6e3d76ae-3538-467f-83f6-adb8f69f45c3":{"url":"https://demand.researchdesk.com","description":"Production"},"e07658bc-5190-4296-93b8-f9acbac86136":{"url":"https://stage-demand.researchdesk.com","description":"Staging"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"JWT access token sent directly in the Authorization header (no Bearer prefix). Accepted tokens: (1) Cognito JWT from POST /tokens, or (2) WorkOS AuthKit access token issued for your Research Desk organization. POST /tokens still issues Cognito tokens only.","scopes":[],"schemeName":"AuthToken"},"schema":{"title":"Authorization","type":"string","description":"JWT access token sent directly in the Authorization header (no Bearer prefix). Accepted tokens: (1) Cognito JWT from POST /tokens, or (2) WorkOS AuthKit access token issued for your Research Desk organization. POST /tokens still issues Cognito tokens only.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AuthToken","name":"Authorization"}],"title":"AuthToken"}]},"originalFileLocation":"demand/openapi.json"},"subdomain":"repdata","siteName":"Rep Data Documentation","title":"Update Survey - Rep Data Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-21T18:43:11.197Z","originalFileLocation":"demand/endpoints/12-patch-surveys.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Rep Data Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/repdata/awZMcsoe6C3Qodff/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/repdata/awZMcsoe6C3Qodff/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/repdata/awZMcsoe6C3Qodff/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/repdata/awZMcsoe6C3Qodff/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/repdata/awZMcsoe6C3Qodff/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/repdata/awZMcsoe6C3Qodff/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/repdata/awZMcsoe6C3Qodff/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/repdata/awZMcsoe6C3Qodff/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/repdata/awZMcsoe6C3Qodff/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update Survey - Rep Data Documentation\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Rep Data Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.repdata.com/demand/endpoints/12-patch-surveys\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://repdata.mintlify.app/_mintlify/api/og/v2?division=Surveys\u0026amp;title=Update+Survey\u0026amp;theme=e1edafaca105ec59c4661525\u0026amp;signature=2dd5ee55501fa081131d997114a179b0e4b4b0228de1db156b6f6af5e4d05e4b\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Update Survey - Rep Data Documentation\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://repdata.mintlify.app/_mintlify/api/og/v2?division=Surveys\u0026amp;title=Update+Survey\u0026amp;theme=e1edafaca105ec59c4661525\u0026amp;signature=2dd5ee55501fa081131d997114a179b0e4b4b0228de1db156b6f6af5e4d05e4b\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/repdata/awZMcsoe6C3Qodff/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Rep Data Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#9B31CF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.repdata.com/demand/endpoints/12-patch-surveys\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/demand/endpoints/12-patch-surveys.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.repdata.com/#organization\",\"name\":\"Rep Data Documentation\",\"url\":\"https://docs.repdata.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/repdata/oPuIFCbtr5tUZERq/public/rep-data-logo-inline-light.png?fit=max\u0026auto=format\u0026n=oPuIFCbtr5tUZERq\u0026q=85\u0026s=82f5eeb30e8795397f8c2368e92e9bc1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.repdata.com#website\",\"name\":\"Rep Data Documentation\",\"url\":\"https://docs.repdata.com\",\"publisher\":{\"@id\":\"https://docs.repdata.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.repdata.com/demand/endpoints/12-patch-surveys#webpage\",\"url\":\"https://docs.repdata.com/demand/endpoints/12-patch-surveys\",\"name\":\"Update Survey\",\"dateModified\":\"2026-10-21T18:43:11.197Z\",\"isPartOf\":{\"@id\":\"https://docs.repdata.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.repdata.com/demand/endpoints/12-patch-surveys#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.repdata.com/demand/endpoints/12-patch-surveys#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference (v1)\",\"item\":\"https://docs.repdata.com/demand/endpoints/01-post-tokens\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Surveys\",\"item\":\"https://docs.repdata.com/demand/endpoints/10-get-surveys\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Update Survey\",\"item\":\"https://docs.repdata.com/demand/endpoints/12-patch-surveys\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.repdata.com/demand/endpoints/12-patch-surveys#apireference\",\"headline\":\"Update Survey\",\"name\":\"Update Survey\",\"url\":\"https://docs.repdata.com/demand/endpoints/12-patch-surveys\",\"mainEntityOfPage\":{\"@id\":\"https://docs.repdata.com/demand/endpoints/12-patch-surveys#webpage\"},\"dateModified\":\"2026-10-21T18:43:11.197Z\",\"publisher\":{\"@id\":\"https://docs.repdata.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.repdata.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Rep Data Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Rep Data Documentation","nav":{"global":null,"products":[{"product":"Home","icon":"house","description":"Rep Data documentation hub","pages":[{"title":"Home","href":""}]},{"product":"Research Desk","icon":"desktop","description":"Self-serve sampling platform","pages":[{"title":"Research Desk","href":"/research-desk"}]},{"product":"Research Desk Demand API","icon":"code","description":"Create projects, surveys, and manage respondents","groups":[{"group":"Overview","pages":[{"title":"Research Desk Demand API","icon":"rocket","iconType":"regular","href":"/demand"},{"title":"Demand API Overview","icon":"book-open","iconType":"regular","href":"/demand/overview/00-getting-started"},{"title":"Environments \u0026 Status Codes","icon":"server","iconType":"regular","href":"/demand/overview/01-environments-and-status-codes"},{"title":"Respondent Status Codes","icon":"list-ol","iconType":"regular","href":"/demand/overview/04-respondent-status-codes"},{"title":"Rate Limits","icon":"gauge","iconType":"regular","href":"/demand/overview/02-rate-limits"},{"title":"Response Structure","icon":"brackets-curly","iconType":"regular","href":"/demand/overview/03-response-structure"},{"title":"OpenAPI Specification","icon":"file-code","iconType":"regular","href":"/demand/overview/01-openapi-spec"}]},{"group":"Integration Guide","pages":[{"title":"Step 1: Authentication Workflow","icon":"lock","iconType":"regular","href":"/demand/guides/01-authentication-flow"},{"title":"Step 2: Mapping Attributes","icon":"arrows-turn-to-dots","iconType":"regular","href":"/demand/guides/02-mapping-attributes"},{"title":"Step 3: Creating Projects","icon":"folder-open","iconType":"regular","href":"/demand/guides/03-managing-projects"},{"title":"Step 4: Creating Surveys","icon":"clipboard-list","iconType":"regular","href":"/demand/guides/04-managing-surveys"},{"title":"Step 5: Managing Surveys In-Field","icon":"chart-line","iconType":"regular","href":"/demand/guides/05-managing-surveys-in-field"},{"title":"Step 6: Managing Respondents","icon":"users","iconType":"regular","href":"/demand/guides/05-managing-respondents"}]},{"group":"API Reference (v1)","expanded":true,"pages":[{"group":"Authentication","expanded":true,"pages":[{"title":"Create Token","openapi":"POST /tokens","href":"/demand/endpoints/01-post-tokens"}]},{"group":"Account Management","expanded":true,"pages":[{"title":"Users","openapi":"GET /users","href":"/demand/endpoints/02-get-users"},{"title":"Accounts","openapi":"GET /accounts","href":"/demand/endpoints/04-get-accounts"}]},{"group":"Lookups","expanded":true,"pages":[{"title":"Definitions","openapi":"GET /definitions","href":"/demand/endpoints/05-get-definitions"},{"title":"Qualifications","openapi":"GET /qualifications","href":"/demand/endpoints/06-get-qualifications"}]},{"group":"Projects","expanded":true,"pages":[{"title":"Projects","openapi":"GET /projects","href":"/demand/endpoints/07-get-projects"},{"title":"Create Project","openapi":"POST /projects","href":"/demand/endpoints/08-post-projects"},{"title":"Update Project","openapi":"PATCH /projects","href":"/demand/endpoints/09-patch-projects"}]},{"group":"Surveys","expanded":true,"pages":[{"title":"Surveys","openapi":"GET /surveys","href":"/demand/endpoints/10-get-surveys"},{"title":"Create Survey","openapi":"POST /surveys","description":"","href":"/demand/endpoints/11-post-surveys"},{"title":"Update Survey","openapi":"PATCH /surveys","href":"/demand/endpoints/12-patch-surveys"}]},{"group":"Responses","expanded":true,"pages":[{"title":"Responses","openapi":"GET /responses","description":"","href":"/demand/endpoints/13-get-responses"},{"title":"Update Response","openapi":"PATCH /responses","href":"/demand/endpoints/14-patch-responses"}]},{"group":"Changelog","expanded":true,"pages":[{"title":"API Changelog","href":"/demand/changelog/api-changelog"}]}]}]},{"product":"Research Desk MCP","icon":"plug","description":"Connect an AI assistant to Research Desk","pages":[{"title":"Research Desk MCP","href":"/mcp/getting-started"}]},{"product":"Research Desk Supply API","icon":"server","description":"Survey streams, redirects, and reconciliation","pages":[{"title":"Research Desk Supply API","href":"/supply"}]},{"product":"SightX","icon":"chart-pie","description":"Watch this space for new documentation","pages":[{"title":"SightX","href":"/coming-soon/sightx"}]},{"product":"SightX API","icon":"chart-mixed","description":"Watch this space for new documentation","pages":[{"title":"SightX API","href":"/coming-soon/sightx-api"}]},{"product":"ReDem","icon":"broom-wide","description":"Watch this space for new documentation","pages":[{"title":"ReDem","href":"/coming-soon/redem"}]},{"product":"Research Defender","icon":"shield-halved","description":"Fraud detection and respondent quality scoring","pages":[{"title":"Research Defender","href":"/research-defender"}]},{"product":"ReDem Application \u0026 API","hidden":true,"pages":[{"title":"ReDem Application \u0026 API","href":"/redem/welcome"}]},{"product":"SightX Application \u0026 API","hidden":true,"pages":[{"title":"SightX Application \u0026 API","href":"/sightx"}]},{"product":"SightX Application","hidden":true,"pages":[{"title":"SightX Application","href":"/sightx/knowledge-base"}]}]},"basePath":"","title":"Update Survey - Rep Data Documentation","buildId":"dpl_GZsjphRpnhWkstV12jxWNcMHFyox","deploymentId":"dpl_GZsjphRpnhWkstV12jxWNcMHFyox","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-B5zPa4Vr.js","utils-CVjrr8Yd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DTgURWzl.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DxTHtkdZ.js","snippetPresets-Cx47o5Vx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-CYZot51e.js","ApiExamples-4Fr6y9N_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Dq2ElbEk.js","shallow-BfYl9r69.js","getApiPlaygroundDisplay-Ch3xc7i1.js","CodeSnippet-BsBxuJ1v.js","CodeSnippets-CetzeDL8.js","getPastedJson-BxPKFSJx.js","icon-o0J1Ochb.js","MethodPill-Du3usO5m.js","DuplicateIcon-DJypyMzl.js","createIcon-YMA6N8KJ.js","DynamicMarkdown-CWvhfcZc.js","SectionHeading-BdLVaXCd.js","axios-vUo_bRtp.js","Markdown-C4Ez6OeV.js","clsx-DptzKFCt.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Dt1IougW.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CZ6Wt2Vb.js"]}