config/edit

POST/config/edit

Apply typed app, ad unit, ad unit group, account bidder, network mapping, list, tag, test-device, line-item, and A/B test config edits. Requires the configuration:write permission. Ordinary config edit actions apply to a draft: if config_id points to a draft, that draft is edited in place; otherwise a new draft is created. A/B test create also creates a draft. A/B test update, start, end, promote, and delete actions publish the resulting configuration as live and must be submitted as the only operation in the request. Ad-unit and line-item bidfloor values are decimal USD CPM; for example, 1.5 means $1.50 CPM.

Request

cURL
curl -X POST "https://provisioning.cloudx.io/api/v1/config/edit" \
  -H "Authorization: Bearer $CLOUDX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"config_id":"<string>","summary":"<string>","operations":["<string>"]}'

Body

FieldTypeDescription
config_idstringConfig row ID to edit. Defaults to the current live config. Draft configs are edited in place; published configs are copied into a new draft.
summarystringDraft name or edit summary. Required for ordinary draft edits. Optional for A/B test operations; when provided, it is used as the draft or published version label.
operationsrequiredarray of object

Responses

Result of the applied config edit. Ordinary edits and A/B test create return a draft result; A/B test update, start, end, promote, and delete return a published config result.
"<string>"

200 Result of the applied config edit. Ordinary edits and A/B test create return a draft result; A/B test update, start, end, promote, and delete return a published config result.

400 Invalid request or config edit.

FieldTypeDescription
errorrequiredstring

401 Unauthorized.

FieldTypeDescription
errorrequiredstring

403 Forbidden.

FieldTypeDescription
errorrequiredstring

404 Config not found.

FieldTypeDescription
errorrequiredstring

500 Internal server error.

FieldTypeDescription
errorrequiredstring