# setSitePageNudge Source: Locale: ru releaseGitSha: 45cdd4e19c6d3956d1bfa48c79fcb8dfec11fa9e sourceContentDigest: 372d715470027fe80e4cfa44b089cc9cdd489a7030ce12b012ad1867afcdabf5 Version: 1 # setSitePageNudge `PUT /api/v1/tools/site/pages/{seqNum}/nudge` Replace the nudge setting of one site page ## Авторизация и права Scopes: ALL. Auth alternatives: OR; scopes внутри альтернативы: ALL. | Поле | Значение | | - | - | | security.0.hubApiKey | \[] | | security.1.hubBearer | \[] | | securitySchemes.hubApiKey.in | "header" | | securitySchemes.hubApiKey.name | "X-Api-Key" | | securitySchemes.hubApiKey.type | "apiKey" | | securitySchemes.hubBearer.scheme | "bearer" | | securitySchemes.hubBearer.type | "http" | | x-required-scopes | \["site:write"] | ## Параметры запроса | Поле | Значение | | - | - | | 0.description | "Tenant, credential and handler-bound byte-shape replay key" | | 0.in | "header" | | 0.name | "Idempotency-Key" | | 0.required | false | | 0.schema | [0.schema](https://telegafirst.com/docs/schema-9ac136edb99a2063b3091602181c8d2022fdccb5b514991319d58544c2e57e95) | | 1.in | "path" | | 1.name | "seqNum" | | 1.required | true | | 1.schema | [1.schema](https://telegafirst.com/docs/schema-1530eae3d9b69eb0d4bf2268a4cc47372fcec06f1cf1736785dd6f16848382fc) | ## Тело запроса | Поле | Значение | | - | - | | content.application/json.schema | [SiteNudgeSettingsRequest](https://telegafirst.com/docs/schema-40db2c0fb74f0852fc98ca079a89d04a44a48ce131e344ff6969ba8135963f83) | | required | true | ## Ответы | Поле | Значение | | - | - | | 200.content.application/json.schema | [SiteNudgeSettings](https://telegafirst.com/docs/schema-16d044b1d24f55847ccd3c1e8a2db6481175148f6c0d16f8d5885139b24b0c41) | | 200.description | "Tenant site control-plane result" | | 200.headers.X-Bot-Username.description | "Active bot username, when resolved" | | 200.headers.X-Bot-Username.schema | [200.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 200.headers.X-Client-Slug.description | "Active tenant slug, when resolved" | | 200.headers.X-Client-Slug.schema | [200.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 200.headers.X-RateLimit-Limit.description | "Effective request budget" | | 200.headers.X-RateLimit-Limit.schema | [200.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 200.headers.X-RateLimit-Remaining.description | "Remaining request budget" | | 200.headers.X-RateLimit-Remaining.schema | [200.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 200.headers.X-RateLimit-Reset.description | "Unix window reset in seconds" | | 200.headers.X-RateLimit-Reset.schema | [200.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | ## Ошибки | Поле | Значение | | - | - | | 400.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 400.description | "Invalid strict body or page seq\_num" | | 400.x-error-codes | \["VALIDATION\_ERROR"] | | 401.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 401.description | "Missing, invalid, revoked or conflicting credential; surface JWT is refused" | | 401.x-error-codes | \["INVALID\_API\_KEY"] | | 403.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 403.description | "Missing scope, prohibited publishable credential or absent active bot" | | 403.x-error-codes | \["INSUFFICIENT\_SCOPE","PUBLISHABLE\_KEY\_NOT\_ALLOWED","NO\_ACTIVE\_BOT"] | | 409.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 409.description | "Typed domain conflict or request in flight" | | 409.x-error-codes | \["CONFLICT"] | | 413.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 413.description | "Resource policy size or item-count limit exceeded" | | 413.x-error-codes | \["PAYLOAD\_TOO\_LARGE","ITEM\_COUNT\_EXCEEDED"] | | 422.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 422.description | "Replay key reused for different input; the page is not published or is hidden; delayMinutes outside 5..10080; no such chain step; a goal link code of no link of the business; AI enabled on a plan without the AI Manager; AI enabled without an aiPrompt" | | 422.x-error-codes | \["IDEMPOTENCY\_KEY\_MISMATCH","SITE\_NUDGE\_PAGE\_NOT\_ELIGIBLE","SITE\_NUDGE\_DELAY\_OUT\_OF\_RANGE","SITE\_NUDGE\_STEP\_NOT\_FOUND","SITE\_NUDGE\_GOAL\_LINK\_NOT\_FOUND","SITE\_NUDGE\_AI\_NOT\_ON\_PLAN","SITE\_NUDGE\_AI\_PROMPT\_REQUIRED"] | | 429.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 429.description | "Resource rate budget exceeded or unavailable" | | 429.headers.Retry-After.description | "Retry delay in seconds, when supplied by the limiter" | | 429.headers.Retry-After.schema | [429.headers.Retry-After.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) | | 429.x-error-codes | \["RATE\_LIMIT\_EXCEEDED","RATE\_LIMIT\_UNAVAILABLE"] | | 500.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) | | 500.description | "Unexpected internal failure" | | 500.x-error-codes | \["INTERNAL\_ERROR"] | ## Дополнительные условия | Поле | Значение | | - | - | | description | "Owner-only site:write. The whole setting, not a patch: all six body fields are required. delayMinutes is 5 to 10080 (seven days); one wait per person at a time: reopening the page restarts the timer, another page replaces the wait only when its nudge is on with a step or AI and the person is not in its 30-day cooldown, and the same person is not nudged again on the same page for 30 days after a nudge. A running wait uses the setting as it was when it started; if the nudge is off or the page hidden or unpublished when the timer fires, the wait is cancelled (superseded, nothing sent), which is also what isEnabled false does to pending waits. A tap on a goal link set on any page of the business ends the wait. stepSeq is the tenant seq\_num of a chain step or null; aiEnabled with aiPrompt (1 to 2000 characters; aiEnabled true without one is refused) runs the AI Manager after the step and needs a plan that includes it; goalLinkCodes (at most 50) are codes of links the business owns, bare or with the dl\_ prefix. Refusals carry their own code and recipe. No secret approval gate. Idempotency-Key is optional for PUT." | | operationId | "setSitePageNudge" | | summary | "Replace the nudge setting of one site page" | | tags | \["site"] | | x-idempotency.conflictStatus | 422 | | x-idempotency.implementation | "global-cache" | | x-idempotency.replayStatus | 200 | | x-idempotency.required | false | | x-idempotency.scope | \["client","credential","controller-handler","key"] | | x-idempotency.ttlSeconds | 86400 | | x-pagination.queryParameters | \[] | | x-pagination.supported | false | | x-scope-semantics | "ALL" |