PureSpectrum
PureSpectrum websiteHelp center
PureSpectrum websiteHelp center
  1. Surveys
  • Back to home
  • API Reference
  • Feasibility
    • Feasibility & Pricing
  • Attributes
    • Get attribute (V3)
    • Get attributes (V3)
  • Surveys
    • Create survey
      POST
    • Get similar surveys
      POST
    • Create group multi-country surveys
      POST
    • Update survey
      PATCH
    • Update survey
      PUT
    • Update survey status
      PUT
    • Update offer price
      PUT
    • Update group multi-country surveys
      PUT
    • Get survey information
      GET
    • Get survey status
      GET
    • Get survey performance
      GET
    • Get list of all surveys
      GET
    • Surveys health status
      GET
    • Pacing details
      GET
    • Delete survey
      DELETE
  • Qualifications
    • Add qualification
    • Update qualification
    • Get qualification information
    • Get all qualifications
    • Delete qualification
  • Quotas
    • Add quota
    • Update quota
    • Update quota
    • Get quota information
    • Get quota performance
    • Delete quota
  • Survey group exclusions
    • Create exclusion group
    • Update exclusion group
    • Get exclusion group information
    • Delete exclusion group
  • Respondent inclusion / exclusion
    • Add a PSIDref list to a survey
    • Update a PSIDref for survey
    • Get PSIDref list for survey
  • Supplier management
    • Create supplier blend
    • Update the list of suppliers for a survey
    • Get list of available suppliers in a locale
    • Get list of available suppliers for a survey
    • Get list of supplier blends
  • Traffic Channels
    • Create traffic channel
    • Get a list of traffic channels
  • Transactions
    • Update status of transaction (V2)
    • Update status of transaction (V3)
    • Register transaction as complete
    • Get transaction status (V3)
    • Get transaction info (V3)
    • Get transactions info for a survey ID (V3)
  • Reconciliation
    • Survey reconciliation
    • Multi survey reconciliation
    • Get status of a reconciliation request
    • Get reconciliation status for an adjustment ID
  • PureText
    • PureText Open-ended (OE) check (V3)
  • Activity logs
    • Get activity logs
    • Get events
  • Templates
    • Get survey templates
  1. Surveys

Update survey

PATCH
/surveys/{SURVEY_ID}
Last modified:2025-10-05 16:48:34

Description#

In order to update one or more survey attributes or properties you can use this endpoint to target them individualy.

Request

Authorization
Add parameter in header
access-token
Example:
access-token: ********************
Path Params

Body Params application/json

Examples
[
    {
        "op": "replace",
        "path": "/completes_required",
        "value": 2000
    }
]

Request Code Samples

Shell
JavaScript
Java
Go
PHP
Python
C#
Ruby
Request Request Example
Shell
JavaScript
Java
Go
cURL
curl --location --globoff --request PATCH 'https://staging.spectrumsurveys.com/buyers/v2/surveys/{{SURVEY_ID}}' \
--header 'access-token: <api-key>' \
--header 'Content-Type: application/json' \
--data '[
    {
        "op": "replace",
        "path": "/completes_required",
        "value": 2000
    }
]'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "click_balancing": 0,
    "estimated_clicks": 0,
    "ps_survey_status": 11,
    "offer_price": 4.5,
    "incl_excl": 0,
    "live_url": "https://example.com/survey",
    "test_url": "https://example.com/survey-test",
    "survey_title": "Flo Test Survey",
    "survey_category_code": 231,
    "completes_required": 2000,
    "field_time": 10,
    "billing_id": "PS_123456",
    "buyer_message": null,
    "expected_loi": 60,
    "expected_ir": 60,
    "ps_survey_id": 1208502,
    "buyer_surveygroup_ref": null,
    "subscriber_emails": [],
    "survey_external_id": "",
    "qlc": {
        "enable": false,
        "multiple_quotas": {
            "enable": false,
            "count_by_quota": false,
            "compensate_by_quota": false
        }
    },
    "quota_throttling": false,
    "url_transform": false,
    "basic_token": {
        "enable": false,
        "value": null
    },
    "is_dq_enable": false,
    "blend_id": null,
    "supplier_allocation_throttle": true,
    "test_ps_survey_entry_link": "https://staging.spectrumsurveys.com/startsurvey?survey_id=1208502&ps_redirect_test=1&bsec=a70mx8&supplier_id=23",
    "survey_localization": "en_UK",
    "uniqueLinks": false,
    "qualifications": [
        {
            "condition_codes": [
                "111",
                "112"
            ],
            "qualification_code": 211
        },
        {
            "qualification_code": 212,
            "range_sets": [
                {
                    "from": 18,
                    "to": 55,
                    "units": 311
                }
            ]
        }
    ],
    "quotas": [
        {
            "buyer_quota_id": "QMales",
            "quota_title": "",
            "ps_quota_id": "2f00135f-193f-4b2d-9012-f49b87544c65",
            "required_count": 500,
            "criteria": [
                {
                    "qualification_code": 211,
                    "condition_codes": [
                        "111"
                    ]
                }
            ]
        },
        {
            "buyer_quota_id": "QFemales",
            "quota_title": "",
            "ps_quota_id": "c842edeb-9041-4c58-908e-002d6e43d26e",
            "required_count": 500,
            "criteria": [
                {
                    "qualification_code": 211,
                    "condition_codes": [
                        "112"
                    ]
                }
            ]
        },
        {
            "buyer_quota_id": "Q18to35",
            "quota_title": "",
            "ps_quota_id": "47c4ba91-8e56-41ca-afd4-a7dae37c6ce1",
            "required_count": 500,
            "criteria": [
                {
                    "qualification_code": 212,
                    "range_sets": [
                        {
                            "units": 311,
                            "to": 35,
                            "from": 18
                        }
                    ]
                }
            ]
        },
        {
            "buyer_quota_id": "Q36to55",
            "quota_title": "",
            "ps_quota_id": "9cf878d3-1ecf-40c0-9f07-b13b534ac889",
            "required_count": 500,
            "criteria": [
                {
                    "qualification_code": 212,
                    "range_sets": [
                        {
                            "units": 311,
                            "to": 55,
                            "from": 36
                        }
                    ]
                }
            ]
        }
    ],
    "mcqb": []
}
🟠400Bad Request
🟠401Unauthorized
Modified at 2025-10-05 16:48:34
Previous
Create group multi-country surveys
Next
Update survey