Skip to navigation

Update paid recommendations auto-accept settings OAuth Scope: posts:write

Currently in beta

This feature is currently in beta and the API is subject to change.

Create or update the rules that decide which applications to the publication’s paid recommendation offers are accepted automatically. Omitted fields keep their current value, and conditions replaces the whole list. When the saved settings are enabled, applications already waiting on live offers are evaluated against them in the background.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

publicationIdstringRequiredformat: "^(pub_[0-9a-fA-F\-]+)$"
The prefixed ID of the publication object

Request

This endpoint expects an object.
enabledbooleanOptional

Whether applications are accepted automatically. Defaults to false on the first save.

quality_valueintegerOptional
The minimum audience size an applying publication needs, from 0 to 100. Defaults to 50 on the first save.
conditionslist of objectsOptional
Conditions an application must meet. Replaces every existing condition. Defaults to none on the first save.

Response

OK
dataobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error