Note
If there are no deals, or all deals are filtered out by query criteria, status code 200 is returned with an empty deal list in the response.
| Code | Meaning | Description |
|---|---|---|
| 200 | OK | Upon a successful GET, PUT, or DELETE request. |
| 201 | Created | Upon a successful POST request. |
| 401 | Unauthorized | Incorrect, missing, or invalid access credentials. |
| 404 | Not Found | The resource you requested is not available. |
| 405 | Method Not Allowed | A request was made of a resource using a request method not supported by that resource; for example, using GET on a method which requires data to be sent by POST, or using PUT on a readonly resource. |
| 408 | Request Timeout | Timeout when processing this request, usually caused by concurrent requests of exclusive access to certain resources. We recommend retrying the request when you receive this status. |
| 422 | Unprocessable Entity | Invalid resource. This error happens when the request body is invalid, or the created/updated resource is invalid. |
| 500 | Internal Server Error | API system error. Contact your FreeWheel account team. |
Error Handling
PATCH /deals/{id} Update Buyer Status
| Code | Error Message | Scenario |
|---|---|---|
| 404 | FreeWheel SSP (SFX) deals are not supported. | Buyers try to update the status of an SFX deal. |
| 404 | The Deal ID doesn’t exist in the seller network or the Deal is part of a Shared External Deal ID, please contact with your seller to use the correct Deal ID for this deal. | Buyers try to update the status of a deal with Shared External Deal ID enabled, but instead submit the External Deal ID in the update request. |
| 422 | Deal has been archived and is no longer relevant. | If the seller status is ARCHIVE, buyers cannot update a particular deal with the buyerstatus. |