Update quota

Description

This endpoint allows you to adjust the parameters of an existing quota for a survey:

required count

criteria

There are various scenarios where you might need to update a quota quantity. Adjusting this value allows you to:

Decrease the number of completes requested for a specific quota

Increase the number of completes requested for a specific a quota

Close the quota by setting the required count to zero or the current number of completes

The required count per quota can be set to any value greater than or equal to 0.
If the new required count is less than or equal to the current number of completes for that specific quota, the quota will effectively receive no additional traffic.

Our system uses two parameters to manage and control traffic to a quota:

required_count: the maximum number of completes allowed for the quota (this is defined either at survey creation or updated via this endpoint)

current_target: the current number of completes being targeted. This is monitored internally and must always satisfy the following condition current_target ≤ required_count.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

Example

{
    "buyer_quota_id": "Q1",
    "ps_quota_id": "84ef3125-d69e-4a00-bec5-d53d03405bb2",
    "required_count": 400,
    "criteria": [
        {
            "qualification_code": 214,
            "condition_codes": [
                "112"
            ]
        }
    ]
}

🟠400Bad Request

🟠404Record Not Found

Description#

Request

Request Code Samples

Responses

Description