Edit a deal request

patch

https://api.sovrn.com/sovrnos/v1/deal-requests/{id}

RFC 7396 JSON Merge Patch; the update propagates in real time. On a deal with a dv360 buyer the DV360 field requirements apply to the merged result, and adFormat and environments cannot be changed (DV360 fixes them at creation).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

^dreq_[a-z0-9]+$

Body Params

name

string

length ≥ 1

description

adFormat

string

enum

Allowed:

environments

array of objects

length ≥ 1

environments

Allowed:

pricing

object

commercial

object

schedule

object

buyers

array of objects

length ≥ 1

buyers

partner

string

enum

required

seatIds

array of strings

required

length ≥ 1

seatIds*

runOfNetwork

const

enum

Allowed:

targeting

array of objects

length between 1 and 25

targeting

name

string

required

length ≥ 1

rules

array of objects

required

length ≥ 1

rules*

attribute

string

enum

required

Allowed:

values

array

required

length ≥ 1

values*

match

string

enum

Defaults to include

Allowed:

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Header

Loading…

Response

Choose an example:

application/json

text/plain

200The updated deal request.

400The request failed validation; message names the problem — e.g. takeRate is a decimal fraction; expected 0 ≤ x ≤ 0.85. See the Errors guide.

401The API key was missing or not accepted. Not JSON — a bare text/plain string: api key not provided, invalid api key, or invalid api key syntax.

403The key is valid but not permitted: {"message": "Partner not authorized for this API"} or {"message": "Insufficient scope"}. Checked before body validation — even with ?dryRun=true.

404No deal request with that id exists for your account: {"message": "Deal request not found"}.

502Sovrn could not reach the downstream deal system; nothing was persisted — safe to retry with a unique name. Carries a required upstream field.