Change a monitor’s settings or filters, pause or resume checks, change its webhook, or rotate the signing secret. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.
Post engagement monitoring requires a V2 workspace API key. Legacy V1 API keys are not supported by these endpoints. Monitors and their credits belong to the V2 workspace associated with the key.
Update any combination of name, frequency (daily or weekly), action (pause or resume), engagement_types, include_existing_engagers, filters, webhook_url (HTTPS URL or null), and rotate_signing_secret: true. Sources change through Add sources and Remove a source; any other field returns 422 invalid_monitor_update.
Pause stops checks and holds queued webhooks until the monitor is resumed. Resume schedules a check immediately and requires monitoring to be available (503 monitoring_not_enabled) and at least 0.2 credits (402 insufficient_credits).
Changing frequency schedules the next check one period from now.
Changing engagement_types or filters restarts coverage. People already delivered stay delivered and are never charged again. filters replaces the whole filter object; omitted lists become empty.
Turning include_existing_engagers on delivers previously seen engagers on the next pass and charges them.
Change the webhook or recover a lost signing secret
Setting or changing webhook_url, or sending rotate_signing_secret: true, returns a new one-time signing_secret with signing_secret_warning. Store it immediately.
{"webhook_url": null} disables the webhook and clears the secret. Rotating without a webhook returns 422 webhook_not_configured; combining rotation with webhook_url: null returns 422 invalid_monitor_update.
Repeating the same URL without rotation returns no secret.
Queued deliveries made for the old configuration are cancelled (webhook_configuration_changed); use redelivery to send them again. If a delivery is being sent at that moment, the edit returns 409 webhook_delivery_in_progress and changes nothing; retry shortly. Configuration changes never spend credits.
Set or change the webhook (a public HTTPS URL without embedded credentials), or send null to disable it and clear its signing secret. Setting a new URL returns a fresh signing_secret.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Airschool","description":"Airscale product guides, integration workflows, MCP documentation, and public API reference.","colors":{"primary":"#4079FF","light":"#4079FF","dark":"#6F9BFF"},"logo":{"light":"https://mintcdn.com/airscale/T4fnFCkEZYFIfzlE/logo/light.svg?fit=max\u0026auto=format\u0026n=T4fnFCkEZYFIfzlE\u0026q=85\u0026s=77cac19c9833b1b4b3e8cc1a21fe7c04","dark":"https://mintcdn.com/airscale/T4fnFCkEZYFIfzlE/logo/dark.svg?fit=max\u0026auto=format\u0026n=T4fnFCkEZYFIfzlE\u0026q=85\u0026s=3fae4b34efca46e05ac0dcb7d1febe81","href":"/"},"favicon":"https://mintcdn.com/airscale/6bM8EcCHTBu_Tci4/favicon.svg?fit=max\u0026auto=format\u0026n=6bM8EcCHTBu_Tci4\u0026q=85\u0026s=0f5e216ce2f6809f53f85f184935b9d6","api":{"openapi":"openapi.json","playground":{"display":"simple"},"examples":{"defaults":"required","languages":["curl","node","python"],"prefill":true,"autogenerate":true}},"appearance":{"default":"light"},"navbar":{"links":[{"href":"https://airscale.io/","label":"Back to website"}],"primary":{"type":"button","label":"Open Dashboard","href":"https://app.airscale.io/dashboard"}},"search":{"prompt":"Search Airschool..."},"seo":{"metatags":{"robots":"index, follow","canonical":"https://docs.airscale.io"},"indexing":"navigable"},"fonts":{"family":"Poppins"},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"airscale","hasAudioNarration":false,"actualSubdomain":"airscale","customDomains":["docs.airscale.io"],"gitSource":{"type":"github","owner":"vicescale","repo":"airscale-docs","deployBranch":"docs/production-release-20260923","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae8a846e4f1cb0cd68aed46","collectionId":"f4c5d82b-bf97-4f6b-a1be-e3717a2a85a2","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae8a846e4f1cb0cd68aed46"},"entitlements":{},"buildId":"6ae8aa5dca78e468455a17a8","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":68},{"language":"default","tag":"Documentation","count":48},{"language":"default","tag":"Intent signals","count":31},{"language":"default","tag":"Enrichments","count":26},{"language":"default","tag":"Post engagements","count":11},{"language":"default","tag":"Miscellaneous","count":10},{"language":"default","tag":"Job changes","count":10},{"language":"default","tag":"New hires","count":10},{"language":"default","tag":"Build lists","count":10},{"language":"default","tag":"Getting started","count":8}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":"#navbar img.nav-logo:is([alt=\"light logo\"], [alt=\"dark logo\"]){height:38px!important}#navbar a[href=\"https://app.airscale.io/dashboard\"]{background-color:#111827!important;border-color:#111827!important;border-radius:10px!important;color:#fff!important}#navbar a[href=\"https://app.airscale.io/dashboard\"]:hover{background-color:#000!important;border-color:#000!important}#navbar a[href=\"https://app.airscale.io/dashboard\"] :is(span, svg){color:inherit!important}#navbar a[href=\"https://app.airscale.io/dashboard\"]>span.absolute.inset-0{background-color:inherit!important;border-radius:10px!important}html.dark #navbar a[href=\"https://app.airscale.io/dashboard\"]{background-color:#fff!important;border-color:#fff!important;color:#111827!important}html.dark #navbar a[href=\"https://app.airscale.io/dashboard\"]:hover{background-color:#e5e7eb!important;border-color:#e5e7eb!important}#sidebar button.sidebar-group-header[data-airscale-collapsible=true]{appearance:none;background:0 0;border:0;cursor:pointer;text-align:left;width:100%}#sidebar button.sidebar-group-header[data-airscale-collapsible=true]::after{content:\"›\";font-size:1.25rem;line-height:1;margin-left:auto;transition:transform 150ms ease}#sidebar button.sidebar-group-header[data-airscale-collapsible=true][aria-expanded=true]::after{transform:rotate(90deg)}"},{"filePath":"airschool.css","content":".airschool{--school-text:#121419;--school-muted:#697289;--school-border:#e2e7ee;--school-surface:#fff;--school-subtle:#f9fafb;color:var(--school-text);background:var(--school-surface) url(/images/airschool/grid.svg) center top/cover;padding:80px 0;font-family:Poppins,sans-serif}.airschool *{box-sizing:border-box}.airschool :is(h1, h2, h3, p){margin:0}.airschool a{color:inherit;text-decoration:none}.airschool a.link{border-bottom-color:var(--school-border)!important}.airschool a.link:hover{border-bottom-color:#aab6cb!important}.airschool-content{width:100%;max-width:1200px;margin:0 auto;padding:0 32px;display:grid;gap:80px}.airschool-hero{display:grid;justify-items:center;gap:40px;text-align:center}.airschool-intro,.airschool-search-area{max-width:768px;display:grid;justify-items:center;gap:20px}.airschool .airschool-badge{border:1px solid var(--school-border);border-radius:99px;padding:9px 16px;background:var(--school-surface);font-size:12px;line-height:16px;font-weight:500}.airschool h1{font-size:48px;line-height:56px;font-weight:600;letter-spacing:-1.8px}.airschool .airschool-description{max-width:600px;font-size:16px;line-height:28px;color:#333842}.airschool-search-area{width:100%;max-width:680px;gap:24px}.airschool-search{width:100%;max-width:550px;min-height:56px;padding:12px 16px;display:flex;align-items:center;gap:12px;border:1px solid var(--school-border);border-radius:16px;background:var(--school-surface);color:var(--school-muted);text-align:left;font:inherit;font-size:14px;cursor:pointer;box-shadow:0 3px 8px -5px #0003}.airschool-search>svg,.airschool-support-card>.airschool-link{flex:none}.airschool-shortcut-keys{margin-left:auto;display:flex;gap:4px}.airschool kbd,.airschool-shortcuts a{background:var(--school-subtle);border:1px solid var(--school-border);border-radius:8px}.airschool kbd{display:grid;place-items:center;width:28px;height:28px;font:inherit;font-size:12px}.airschool-shortcuts{display:flex;flex-wrap:wrap;gap:8px;align-items:center;justify-content:center;font-size:12px;line-height:18px;color:var(--school-muted)}.airschool-shortcuts a{padding:5px 10px;font-weight:500}.airschool-section{display:grid;gap:32px}.airschool h2,.airschool h3{font-size:20px;line-height:28px;font-weight:400;letter-spacing:-.5px}.airschool-categories{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:20px}.airschool-card{display:flex;flex-direction:column;gap:20px;padding:12px;border:1px solid var(--school-border);border-radius:36px;background:var(--school-surface);transition:border-color 150ms ease,box-shadow 150ms ease}.airschool-card img{display:block;width:100%;height:auto;aspect-ratio:2/1;object-fit:cover;border-radius:24px;margin:0}.airschool-card-content{flex:1;display:flex;flex-direction:column;justify-content:space-between;gap:16px;padding:0 16px 16px}.airschool h3{font-size:16px;line-height:24px;letter-spacing:-.4px}.airschool-card p,.airschool-support-card p{margin-top:6px;font-size:12px;line-height:18px;color:var(--school-muted)}.airschool-link{font-size:14px;line-height:20px;color:var(--school-muted);font-weight:500}.airschool-link>span{display:inline-block;margin-left:3px}.airschool-support-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:20px}.airschool-support-card{display:flex;align-items:center;gap:20px;padding:28px;border:1px solid var(--school-border);border-radius:32px;background:var(--school-surface);transition:border-color 150ms ease,box-shadow 150ms ease}.airschool-support-icon{display:grid;place-items:center;flex:none;width:50px;height:50px;border-radius:50%;background:var(--school-subtle);color:var(--school-muted)}.airschool-support-copy{flex:1}.airschool :is(.airschool-card, .airschool-support-card, .airschool-search, .airschool-shortcuts a):hover{border-color:#aab6cb;box-shadow:0 4px 16px -10px #33415555}.airschool :is(a, button):focus-visible{outline:3px solid #4079ff;outline-offset:4px}html.dark .airschool{--school-text:#f4f5f7;--school-muted:#aeb7c8;--school-border:#303640;--school-surface:#111316;--school-subtle:#1b1e24;background-image:none}html.dark .airschool .airschool-description{color:#c4cbd6}html.dark .airschool-card img{filter:brightness(.88)}@media (max-width:1000px){.airschool-support-card{flex-wrap:wrap;gap:16px;padding:24px}.airschool-support-card>.airschool-link{width:100%;padding-left:66px}}@media (max-width:700px){.airschool{padding:48px 0}.airschool-content{padding:0 20px;gap:48px}.airschool h1{font-size:36px;line-height:44px;letter-spacing:-1.2px}.airschool .airschool-description{font-size:15px;line-height:26px}.airschool-hero{gap:28px}.airschool-categories,.airschool-support-grid{grid-template-columns:minmax(0,1fr)}.airschool-section{gap:24px}.airschool-shortcut-keys{display:none}.airschool-shortcuts>span{width:100%}.airschool-card{border-radius:28px}.airschool-card-content{padding:0 12px 12px}}@media (prefers-reduced-motion:reduce){.airschool :is(.airschool-card, .airschool-support-card){transition:none}}"}],"page":{"pagePath":"api-reference/post-engagement-monitors/update","slug":"/api-reference/post-engagement-monitors/update","pageMetadata":{"title":"Update a post engagement monitor","description":"Change a monitor's settings or filters, pause or resume checks, change its webhook, or rotate the signing secret. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.","canonical":"https://docs.airscale.io/api-reference/post-engagement-monitors/update","openapi":"openapi.json PATCH /v1/post-engagement-monitors/{monitor_id}","href":"/api-reference/post-engagement-monitors/update"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Change a monitor’s settings or filters, pause or resume checks, change its webhook, or rotate the signing secret. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Note}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(Note,{children:_jsxs(_components.p,{children:[`Post engagement monitoring requires a `,_jsx(_components.strong,{children:`V2 workspace API key`}),`. Legacy V1 API keys are not supported by these endpoints. Monitors and their credits belong to the V2 workspace associated with the key.`]})}),`\n`,_jsxs(_components.p,{children:[`Update any combination of `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`frequency`}),` (`,_jsx(_components.code,{children:`daily`}),` or `,_jsx(_components.code,{children:`weekly`}),`), `,_jsx(_components.code,{children:`action`}),` (`,_jsx(_components.code,{children:`pause`}),` or `,_jsx(_components.code,{children:`resume`}),`), `,_jsx(_components.code,{children:`engagement_types`}),`, `,_jsx(_components.code,{children:`include_existing_engagers`}),`, `,_jsx(_components.code,{children:`filters`}),`, `,_jsx(_components.code,{children:`webhook_url`}),` (HTTPS URL or `,_jsx(_components.code,{children:`null`}),`), and `,_jsx(_components.code,{children:`rotate_signing_secret: true`}),`. Sources change through `,_jsx(_components.a,{href:`/api-reference/post-engagement-monitors/sources/add`,children:`Add sources`}),` and `,_jsx(_components.a,{href:`/api-reference/post-engagement-monitors/sources/remove`,children:`Remove a source`}),`; any other field returns `,_jsx(_components.code,{children:`422 invalid_monitor_update`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`pause-and-resume`,children:`Pause and resume`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Pause`}),` stops checks and holds queued webhooks until the monitor is resumed. `,_jsx(_components.strong,{children:`Resume`}),` schedules a check immediately and requires monitoring to be available (`,_jsx(_components.code,{children:`503 monitoring_not_enabled`}),`) and at least 0.2 credits (`,_jsx(_components.code,{children:`402 insufficient_credits`}),`).`]}),`\n`,_jsx(Heading,{level:`2`,id:`settings`,children:`Settings`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Changing `,_jsx(_components.code,{children:`frequency`}),` schedules the next check one period from now.`]}),`\n`,_jsxs(_components.li,{children:[`Changing `,_jsx(_components.code,{children:`engagement_types`}),` or `,_jsx(_components.code,{children:`filters`}),` restarts coverage. People already delivered stay delivered and are never charged again. `,_jsx(_components.code,{children:`filters`}),` replaces the whole filter object; omitted lists become empty.`]}),`\n`,_jsxs(_components.li,{children:[`Turning `,_jsx(_components.code,{children:`include_existing_engagers`}),` on delivers previously seen engagers on the next pass and charges them.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`change-the-webhook-or-recover-a-lost-signing-secret`,children:`Change the webhook or recover a lost signing secret`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Setting or changing `,_jsx(_components.code,{children:`webhook_url`}),`, or sending `,_jsx(_components.code,{children:`rotate_signing_secret: true`}),`, returns a new one-time `,_jsx(_components.code,{children:`signing_secret`}),` with `,_jsx(_components.code,{children:`signing_secret_warning`}),`. Store it immediately.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`{\"webhook_url\": null}`}),` disables the webhook and clears the secret. Rotating without a webhook returns `,_jsx(_components.code,{children:`422 webhook_not_configured`}),`; combining rotation with `,_jsx(_components.code,{children:`webhook_url: null`}),` returns `,_jsx(_components.code,{children:`422 invalid_monitor_update`}),`.`]}),`\n`,_jsx(_components.li,{children:`Repeating the same URL without rotation returns no secret.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Queued deliveries made for the old configuration are cancelled (`,_jsx(_components.code,{children:`webhook_configuration_changed`}),`); use redelivery to send them again. If a delivery is being sent at that moment, the edit returns `,_jsx(_components.code,{children:`409 webhook_delivery_in_progress`}),` and changes nothing; retry shortly. Configuration changes never spend credits.`]}),`\n`,_jsx(Heading,{level:`2`,id:`next-step`,children:`Next step`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.a,{href:`/api-reference/post-engagement-monitors/engagers/redeliver`,children:`Redeliver a webhook`}),` after changing the webhook URL.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Update a post engagement monitor","description":"Change a monitor's settings or filters, pause or resume checks, change its webhook, or rotate the signing secret. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.","canonical":"https://docs.airscale.io/api-reference/post-engagement-monitors/update","openapi":"openapi.json PATCH /v1/post-engagement-monitors/{monitor_id}","href":"/api-reference/post-engagement-monitors/update"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Pause and resume","slug":"pause-and-resume","depth":2,"children":[]},{"title":"Settings","slug":"settings","depth":2,"children":[]},{"title":"Change the webhook or recover a lost signing secret","slug":"change-the-webhook-or-recover-a-lost-signing-secret","depth":2,"children":[]},{"title":"Next step","slug":"next-step","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/airscale/9fa3b93ce50bf4a8/custom.js"],"openApiReferenceData":{"operation":{"operationId":"updatePostEngagementMonitor","tags":["Post engagement monitoring"],"summary":"Update, pause, or resume a monitor, or change its webhook","description":"Change a monitor's settings or filters, pause or resume checks, change its webhook, or rotate the signing secret. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.","x-airscale-rate-limit":"120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.","x-airscale-credit-cost":"No credits are spent by the update itself. Resuming requires at least 0.2 credits. Turning include_existing_engagers on delivers and charges previously seen engagers on the next pass.","parameters":["d082c027-9912-47d2-8eed-45f549b64a67"],"requestBody":"f94bfee1-a4a7-4a48-bb9a-34d1a03cd41b","responses":{"200":"a9f42934-17ec-42da-ad96-541b72184429","400":"1200c1a3-4994-4586-b7e6-a840e143770a","401":"001c7863-9b2b-46a4-8ff9-1c1ec4cd1c8b","402":"dca7c8d4-f683-4d76-9dff-438bd2a3a296","404":"c29136bd-2ceb-42a0-8c0a-b3e9e306e848","409":"4248f8fa-f4a2-49b1-8a17-580d4cc00eca","413":"868dfc7b-2d32-4cda-a92d-c084a84a62d3","422":"36a64b00-e31f-4b94-833e-a9cf362e451c","429":"6dc02369-ea3d-4651-8d4a-14b7bcb4976c","503":"37311169-7d86-4f1c-b58e-5bd39fba8ac9"},"method":"patch","type":"path","servers":["b1097e1d-089e-45f3-97ef-ba0b9b6a9962"],"security":["18c92dab-d143-4697-9c89-a2c4c51573a4"],"path":"/v1/post-engagement-monitors/{monitor_id}","baseUrlOptions":["https://api.airscale.io"],"title":"Update, pause, or resume a monitor, or change its webhook","codeSamples":[],"requestExampleLanguages":["bash","node","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.action":"pause"},{"body.action":"resume"},{"body.frequency":"weekly","body.engagement_types.items.0":"comments","body.filters.titles.items.0":"Founder"},{"body.webhook_url.oneOf.0":"https://hooks.example.com/airscale/engagers"},{"body.rotate_signing_secret":true},{}]},"dependencies":{"parameters":{"d082c027-9912-47d2-8eed-45f549b64a67":{"name":"monitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"},"example":"71111111-1111-4111-8111-111111111111"}},"requestBody":{"required":true,"description":"Send at least one supported field. Any other field, including sources, is rejected.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"name":{"type":"string","minLength":1,"maxLength":120,"uniqueKey":"name","typeLabel":"string"},"frequency":{"type":"string","enum":["daily","weekly"],"uniqueKey":"frequency","typeLabel":"enum\u003cstring>"},"action":{"type":"string","enum":["pause","resume"],"uniqueKey":"action","typeLabel":"enum\u003cstring>"},"engagement_types":{"type":"array","minItems":1,"maxItems":2,"uniqueItems":true,"items":{"type":"string","enum":["reactions","comments"],"uniqueKey":"engagement_types.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"engagement_types","typeLabel":"enum\u003cstring>[]"},"include_existing_engagers":{"type":"boolean","uniqueKey":"include_existing_engagers","typeLabel":"boolean"},"filters":{"type":"object","additionalProperties":false,"description":"Replaces the monitor's filters. Omitted filter lists become empty.","properties":{"titles":{"type":"array","maxItems":50,"items":{"type":"string","minLength":1,"maxLength":200,"uniqueKey":"filters.titles.items.[INDEX]","typeLabel":"string"},"default":[],"uniqueKey":"filters.titles","typeLabel":"string[]"},"locations":{"type":"array","maxItems":50,"items":{"type":"string","minLength":1,"maxLength":200,"uniqueKey":"filters.locations.items.[INDEX]","typeLabel":"string"},"default":[],"uniqueKey":"filters.locations","typeLabel":"string[]"},"excluded_company_urls":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":500,"uniqueKey":"filters.excluded_company_urls.items.[INDEX]","typeLabel":"string"},"default":[],"description":"LinkedIn company URLs whose employees are left out.","uniqueKey":"filters.excluded_company_urls","typeLabel":"string[]"}},"uniqueKey":"filters","typeLabel":"object"},"webhook_url":{"oneOf":[{"type":"string","format":"uri","maxLength":2048,"description":"Set or change the webhook (a public HTTPS URL without embedded credentials), or send null to disable it and clear its signing secret. Setting a new URL returns a fresh signing_secret.","uniqueKey":"webhook_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","maxLength":2048,"description":"Set or change the webhook (a public HTTPS URL without embedded credentials), or send null to disable it and clear its signing secret. Setting a new URL returns a fresh signing_secret.","uniqueKey":"webhook_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"webhook_url","typeLabel":"string\u003curi> | null"},"rotate_signing_secret":{"type":"boolean","const":true,"description":"Generate a new signing secret for the enabled webhook. Cannot be combined with webhook_url: null.","uniqueKey":"rotate_signing_secret","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"pause":{"title":"pause","value":{"action":"pause"}},"resume":{"title":"resume","value":{"action":"resume"}},"settings":{"title":"settings","value":{"frequency":"weekly","engagement_types":["comments"],"filters":{"titles":["Founder"],"locations":[],"excluded_company_urls":[]}}},"webhook":{"title":"webhook","value":{"webhook_url":"https://hooks.example.com/airscale/engagers"}},"rotate":{"title":"rotate","value":{"rotate_signing_secret":true}},"disableWebhook":{"title":"disableWebhook","value":{"webhook_url":null}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"a9f42934-17ec-42da-ad96-541b72184429":{"description":"The updated monitor. signing_secret and signing_secret_warning appear only when a new secret was generated.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["monitor"],"properties":{"monitor":{"type":"object","additionalProperties":false,"required":["id","name","status","frequency","engagement_types","include_existing_engagers","filters","results_table_id","results_status","results_error","next_check_at","last_checked_at","last_error","webhook_url","webhook_configured","source_count","engager_count","unread_engager_count","created_at","updated_at"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"monitor.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","isRequired":true,"uniqueKey":"monitor.name","typeLabel":"string"},"status":{"type":"string","enum":["active","paused"],"isRequired":true,"uniqueKey":"monitor.status","typeLabel":"enum\u003cstring>"},"frequency":{"type":"string","enum":["daily","weekly"],"isRequired":true,"uniqueKey":"monitor.frequency","typeLabel":"enum\u003cstring>"},"engagement_types":{"type":"array","items":{"type":"string","enum":["reactions","comments"],"uniqueKey":"monitor.engagement_types.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"monitor.engagement_types","typeLabel":"enum\u003cstring>[]"},"include_existing_engagers":{"type":"boolean","isRequired":true,"uniqueKey":"monitor.include_existing_engagers","typeLabel":"boolean"},"filters":{"type":"object","additionalProperties":false,"required":["titles","locations","excluded_company_urls"],"properties":{"titles":{"type":"array","items":{"type":"string","uniqueKey":"monitor.filters.titles.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"monitor.filters.titles","typeLabel":"string[]"},"locations":{"type":"array","items":{"type":"string","uniqueKey":"monitor.filters.locations.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"monitor.filters.locations","typeLabel":"string[]"},"excluded_company_urls":{"type":"array","items":{"type":"string","uniqueKey":"monitor.filters.excluded_company_urls.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"monitor.filters.excluded_company_urls","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"monitor.filters","typeLabel":"object"},"results_table_id":{"type":"string","description":"The Airscale results table that receives one row per delivered engager.","isRequired":true,"uniqueKey":"monitor.results_table_id","typeLabel":"string"},"results_status":{"type":"string","enum":["ready","pending","blocked"],"description":"ready, pending (engagers waiting for delivery) or blocked (see results_error).","isRequired":true,"uniqueKey":"monitor.results_status","typeLabel":"enum\u003cstring>"},"results_error":{"oneOf":[{"type":"string","description":"Why delivery is blocked, for example insufficient_credits, results_table_deleted, table_row_limit_reached or results_columns_missing.","isRequired":true,"uniqueKey":"monitor.results_error.oneOf.0","typeLabel":"string"},{"type":"null","description":"Why delivery is blocked, for example insufficient_credits, results_table_deleted, table_row_limit_reached or results_columns_missing.","isRequired":true,"uniqueKey":"monitor.results_error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"monitor.results_error","typeLabel":"string | null"},"next_check_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"monitor.next_check_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"monitor.next_check_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"monitor.next_check_at","typeLabel":"string\u003cdate-time> | null"},"last_checked_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"monitor.last_checked_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"monitor.last_checked_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"monitor.last_checked_at","typeLabel":"string\u003cdate-time> | null"},"last_error":{"oneOf":[{"type":"string","description":"A short code when the last check could not complete.","isRequired":true,"uniqueKey":"monitor.last_error.oneOf.0","typeLabel":"string"},{"type":"null","description":"A short code when the last check could not complete.","isRequired":true,"uniqueKey":"monitor.last_error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"monitor.last_error","typeLabel":"string | null"},"webhook_url":{"oneOf":[{"type":"string","format":"uri","isRequired":true,"uniqueKey":"monitor.webhook_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","isRequired":true,"uniqueKey":"monitor.webhook_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"monitor.webhook_url","typeLabel":"string\u003curi> | null"},"webhook_configured":{"type":"boolean","isRequired":true,"uniqueKey":"monitor.webhook_configured","typeLabel":"boolean"},"source_count":{"type":"integer","minimum":0,"description":"Active sources.","isRequired":true,"uniqueKey":"monitor.source_count","typeLabel":"integer"},"engager_count":{"type":"integer","minimum":0,"description":"Engagers delivered to the results table.","isRequired":true,"uniqueKey":"monitor.engager_count","typeLabel":"integer"},"unread_engager_count":{"type":"integer","minimum":0,"description":"Exact count, independent of any page size.","isRequired":true,"uniqueKey":"monitor.unread_engager_count","typeLabel":"integer"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"monitor.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"monitor.updated_at","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"monitor","typeLabel":"object"},"signing_secret":{"type":"string","description":"Present only when the request set a new webhook URL or rotated the secret. Store it immediately.","uniqueKey":"signing_secret","typeLabel":"string"},"signing_secret_warning":{"type":"string","uniqueKey":"signing_secret_warning","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"success":{"title":"success","value":{"monitor":{"id":"71111111-1111-4111-8111-111111111111","name":"Competitor audiences","status":"active","frequency":"daily","engagement_types":["reactions","comments"],"include_existing_engagers":false,"filters":{"titles":["VP","Head of"],"locations":["France"],"excluded_company_urls":["https://www.linkedin.com/company/example-company"]},"results_table_id":"74444444-4444-4444-8444-444444444444","results_status":"ready","results_error":null,"next_check_at":"2026-11-03T09:00:00.000Z","last_checked_at":"2026-11-02T09:00:00.000Z","last_error":null,"webhook_url":"https://hooks.example.com/airscale/engagers","webhook_configured":true,"source_count":2,"engager_count":37,"unread_engager_count":5,"created_at":"2026-11-02T08:58:00.000Z","updated_at":"2026-11-02T09:00:00.000Z"},"signing_secret":"example-signing-secret","signing_secret_warning":"Store this secret now. It is not returned again."}}},"exampleType":"examples"}},"exampleType":"examples"},"1200c1a3-4994-4586-b7e6-a840e143770a":{"description":"The request body is missing or is not valid JSON. The public API returns {\"error\":\"Invalid JSON\"}.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"error":{"title":"error","value":{"error":"Invalid JSON"}}},"exampleType":"examples"}},"exampleType":"examples"},"001c7863-9b2b-46a4-8ff9-1c1ec4cd1c8b":{"description":"A missing Bearer token returns {\"error\":\"Unauthorized\",\"message\":\"Missing or invalid bearer token\"}. An unknown API key returns invalid_api_key.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.0.error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","properties":{"error":{"type":"string","uniqueKey":"oneOf.1.error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"oneOf.1.message","typeLabel":"string"}},"additionalProperties":true,"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"invalidKey":{"title":"invalidKey","value":{"error":{"code":"invalid_api_key","message":"The API key is not valid"}}}},"exampleType":"examples"}},"exampleType":"examples"},"dca7c8d4-f683-4d76-9dff-438bd2a3a296":{"description":"insufficient_credits: resuming requires at least 0.2 credits.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"c29136bd-2ceb-42a0-8c0a-b3e9e306e848":{"description":"monitor_not_found in this workspace.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"error":{"title":"error","value":{"error":{"code":"monitor_not_found","message":"Monitor not found"}}}},"exampleType":"examples"}},"exampleType":"examples"},"4248f8fa-f4a2-49b1-8a17-580d4cc00eca":{"description":"webhook_delivery_in_progress: a webhook send is in flight. The configuration was not changed; retry after the delivery settles.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"868dfc7b-2d32-4cda-a92d-c084a84a62d3":{"description":"The JSON request body exceeds the 256 KiB (262,144 bytes) limit.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"36a64b00-e31f-4b94-833e-a9cf362e451c":{"description":"invalid_monitor_update (for example no supported field, an unknown field, invalid filters, a webhook_url that is not a public HTTPS destination, or rotation combined with webhook_url: null) or webhook_not_configured when rotating without a webhook.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"6dc02369-ea3d-4651-8d4a-14b7bcb4976c":{"description":"The API key has exceeded 120 requests in the current minute across post engagement monitor endpoints. Wait for the Retry-After seconds before retrying.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"error":{"title":"error","value":{"error":"Too Many Requests","message":"Rate limit exceeded: 120 requests per minute"}}},"exampleType":"examples"}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"string"},"example":"60"}},"exampleType":"examples"},"37311169-7d86-4f1c-b58e-5bd39fba8ac9":{"description":"monitoring_not_enabled when resuming while post engagement monitoring is closed, or service_unavailable.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"18c92dab-d143-4697-9c89-a2c4c51573a4":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API key","description":"Use an Airscale workspace API key. Never expose the key in client-side code.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"b1097e1d-089e-45f3-97ef-ba0b9b6a9962":{"url":"https://api.airscale.io","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API key","description":"Use an Airscale workspace API key. Never expose the key in client-side code.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Use an Airscale workspace API key. Never expose the key in client-side code.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"airscale","siteName":"Airschool","title":"Update a post engagement monitor - Airschool","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-02T15:21:14.808Z","originalFileLocation":"api-reference/post-engagement-monitors/update.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Change a monitor\u0026#x27;s settings or filters, pause or resume checks, change its webhook, or rotate the signing secret. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Airschool\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/airscale/iIlUU29U7SNYsr3_/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/airscale/iIlUU29U7SNYsr3_/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/airscale/iIlUU29U7SNYsr3_/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/airscale/iIlUU29U7SNYsr3_/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/airscale/iIlUU29U7SNYsr3_/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/airscale/iIlUU29U7SNYsr3_/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/airscale/iIlUU29U7SNYsr3_/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/airscale/iIlUU29U7SNYsr3_/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/airscale/iIlUU29U7SNYsr3_/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update a post engagement monitor - Airschool\">\u003cmeta data-mint-head property=\"og:description\" content=\"Change a monitor\u0026#x27;s settings or filters, pause or resume checks, change its webhook, or rotate the signing secret. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Airschool\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.airscale.io/api-reference/post-engagement-monitors/update\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://airscale.mintlify.app/_mintlify/api/og/v2?division=Post+engagements\u0026amp;title=Update+a+post+engagement+monitor\u0026amp;description=Change+a+monitor%27s+settings+or+filters%2C+pause+or+resume+checks%2C+change+its+webhook%2C+or+rotate+the+signing+secret.+Rate+limit%3A+120+requests+per+fixed+minute+per+\u0026amp;theme=89d1666b77f2d0da24a1804c\u0026amp;signature=f76d6cf307a6052dd4c09760b4554e21dc6f79257e3fe93e24f66cdec380ecb4\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Update a post engagement monitor - Airschool\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Change a monitor\u0026#x27;s settings or filters, pause or resume checks, change its webhook, or rotate the signing secret. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://airscale.mintlify.app/_mintlify/api/og/v2?division=Post+engagements\u0026amp;title=Update+a+post+engagement+monitor\u0026amp;description=Change+a+monitor%27s+settings+or+filters%2C+pause+or+resume+checks%2C+change+its+webhook%2C+or+rotate+the+signing+secret.+Rate+limit%3A+120+requests+per+fixed+minute+per+\u0026amp;theme=89d1666b77f2d0da24a1804c\u0026amp;signature=f76d6cf307a6052dd4c09760b4554e21dc6f79257e3fe93e24f66cdec380ecb4\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/airscale/iIlUU29U7SNYsr3_/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Airschool\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4079FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.airscale.io/api-reference/post-engagement-monitors/update\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/post-engagement-monitors/update.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.airscale.io/#organization\",\"name\":\"Airschool\",\"url\":\"https://docs.airscale.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/airscale/T4fnFCkEZYFIfzlE/logo/light.svg?fit=max\u0026auto=format\u0026n=T4fnFCkEZYFIfzlE\u0026q=85\u0026s=77cac19c9833b1b4b3e8cc1a21fe7c04\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.airscale.io#website\",\"name\":\"Airschool\",\"url\":\"https://docs.airscale.io\",\"publisher\":{\"@id\":\"https://docs.airscale.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.airscale.io/api-reference/post-engagement-monitors/update#webpage\",\"url\":\"https://docs.airscale.io/api-reference/post-engagement-monitors/update\",\"name\":\"Update a post engagement monitor\",\"description\":\"Change a monitor's settings or filters, pause or resume checks, change its webhook, or rotate the signing secret. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.\",\"dateModified\":\"2026-11-02T15:21:14.808Z\",\"isPartOf\":{\"@id\":\"https://docs.airscale.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.airscale.io/api-reference/post-engagement-monitors/update#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.airscale.io/api-reference/post-engagement-monitors/update#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Intent signals\",\"item\":\"https://docs.airscale.io/api-reference/job-change-monitors/create\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Post engagements\",\"item\":\"https://docs.airscale.io/api-reference/post-engagement-monitors/create\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Update a post engagement monitor\",\"item\":\"https://docs.airscale.io/api-reference/post-engagement-monitors/update\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.airscale.io/api-reference/post-engagement-monitors/update#apireference\",\"headline\":\"Update a post engagement monitor\",\"name\":\"Update a post engagement monitor\",\"description\":\"Change a monitor's settings or filters, pause or resume checks, change its webhook, or rotate the signing secret. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.\",\"url\":\"https://docs.airscale.io/api-reference/post-engagement-monitors/update\",\"mainEntityOfPage\":{\"@id\":\"https://docs.airscale.io/api-reference/post-engagement-monitors/update#webpage\"},\"dateModified\":\"2026-11-02T15:21:14.808Z\",\"publisher\":{\"@id\":\"https://docs.airscale.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.airscale.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Airschool\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Airschool","nav":{"global":null,"tabs":[{"tab":"Home","pages":[{"title":"Home","href":""}]},{"tab":"Documentation","pages":[{"title":"Documentation","href":"/docs/sales-navigator"}]},{"tab":"API Reference","groups":[{"group":"Start here","pages":[{"title":"API Overview","href":"/api-reference/api-overview"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Rate limits","href":"/api-reference/rate-limits"}]},{"group":"Account","pages":[{"title":"Credit count","openapi":"openapi.json POST /v1/credits","href":"/api-reference/credit-count"}]},{"group":"Search and discovery","pages":[{"title":"Find people","openapi":"openapi.json POST /v1/find-people","href":"/api-reference/find-people"},{"title":"Leads Finder","openapi":"openapi.json POST /v1/leads-finder","href":"/api-reference/leads-finder"},{"title":"Find companies","openapi":"openapi.json POST /v1/find-companies","href":"/api-reference/find-companies"},{"title":"Company filter values","openapi":"openapi.json GET /v1/find-companies/filter-values","href":"/api-reference/find-companies/filter-values"},{"title":"Company lookalikes","openapi":"openapi.json POST /v1/company-lookalikes","href":"/api-reference/company-lookalikes"},{"title":"Airsearch","openapi":"openapi.json POST /v1/airsearch","href":"/api-reference/airsearch"}]},{"group":"Contact data","pages":[{"title":"Email finder","openapi":"openapi.json POST /v1/email","href":"/api-reference/email-finder"},{"title":"Bulk email finder","openapi":"openapi.json POST /v1/email-bulk","href":"/api-reference/email-finder-(bulk)"},{"title":"Mobile finder","openapi":"openapi.json POST /v1/phone","href":"/api-reference/mobile-finder"},{"title":"Personal email","openapi":"openapi.json POST /v1/personal-email","href":"/api-reference/personal-email"},{"title":"People URL finder","openapi":"openapi.json POST /v1/url-search-people","href":"/api-reference/people-url-finder"}]},{"group":"Profiles and reverse lookup","pages":[{"title":"People profile","openapi":"openapi.json POST /v1/profile","href":"/api-reference/extract-people-profile"},{"title":"Company profile","openapi":"openapi.json POST /v1/company","href":"/api-reference/extract-company-profile"},{"title":"Domain to LinkedIn","openapi":"openapi.json POST /v1/domain-to-linkedin","href":"/api-reference/domain-to-linkedin"},{"title":"Reverse email","openapi":"openapi.json POST /v1/reverse-email","href":"/api-reference/reverse-email"},{"title":"Reverse phone","openapi":"openapi.json POST /v1/reverse-phone","href":"/api-reference/reverse-phone"}]},{"group":"Post engagement","expanded":false,"pages":[{"title":"Post likers","openapi":"openapi.json POST /v1/post-likers","href":"/api-reference/post-likers"},{"title":"Post commenters","openapi":"openapi.json POST /v1/post-commenters","href":"/api-reference/post-commenters"},{"title":"Post search","openapi":"openapi.json POST /v1/post-search","href":"/api-reference/post-search"},{"title":"Profile comments","openapi":"openapi.json POST /v1/profile-comments","href":"/api-reference/profile-comments"},{"title":"Comment likers","openapi":"openapi.json POST /v1/comment-likers","href":"/api-reference/comment-likers"},{"title":"Profile posts","openapi":"openapi.json POST /v1/profile-posts","href":"/api-reference/profile-posts"},{"title":"Company posts","openapi":"openapi.json POST /v1/company-posts","href":"/api-reference/company-posts"}]},{"group":"Intent signals","expanded":false,"pages":[{"group":"Job changes","expanded":false,"pages":[{"title":"Create a job-change monitor","openapi":"openapi.json POST /v1/job-change-monitors","href":"/api-reference/job-change-monitors/create"},{"title":"List job-change monitors","openapi":"openapi.json GET /v1/job-change-monitors","href":"/api-reference/job-change-monitors/list"},{"title":"Get a job-change monitor","openapi":"openapi.json GET /v1/job-change-monitors/{monitor_id}","href":"/api-reference/job-change-monitors/get"},{"title":"Update a job-change monitor","openapi":"openapi.json PATCH /v1/job-change-monitors/{monitor_id}","href":"/api-reference/job-change-monitors/update"},{"title":"Delete a job-change monitor","openapi":"openapi.json DELETE /v1/job-change-monitors/{monitor_id}","href":"/api-reference/job-change-monitors/delete"},{"title":"Add profiles to a job-change monitor","openapi":"openapi.json POST /v1/job-change-monitors/{monitor_id}/profiles","href":"/api-reference/job-change-monitors/profiles/add"},{"title":"Remove a profile from a job-change monitor","openapi":"openapi.json DELETE /v1/job-change-monitors/{monitor_id}/profiles/{profile_id}","href":"/api-reference/job-change-monitors/profiles/remove"},{"title":"List job-change events","openapi":"openapi.json GET /v1/job-change-monitors/{monitor_id}/events","href":"/api-reference/job-change-monitors/events"},{"title":"Mark a job-change event as read","openapi":"openapi.json POST /v1/job-change-monitors/{monitor_id}/events/{event_id}/read","href":"/api-reference/job-change-monitors/events/read"},{"title":"Redeliver a job-change webhook","openapi":"openapi.json POST /v1/job-change-monitors/{monitor_id}/events/{event_id}/webhook/redeliver","href":"/api-reference/job-change-monitors/events/redeliver"}]},{"group":"New hires","expanded":false,"pages":[{"title":"Create a new hire monitor","openapi":"openapi.json POST /v1/new-hire-monitors","href":"/api-reference/new-hire-monitors/create"},{"title":"List new hire monitors","openapi":"openapi.json GET /v1/new-hire-monitors","href":"/api-reference/new-hire-monitors/list"},{"title":"Get a new hire monitor","openapi":"openapi.json GET /v1/new-hire-monitors/{monitor_id}","href":"/api-reference/new-hire-monitors/get"},{"title":"Update a new hire monitor","openapi":"openapi.json PATCH /v1/new-hire-monitors/{monitor_id}","href":"/api-reference/new-hire-monitors/update"},{"title":"Delete a new hire monitor","openapi":"openapi.json DELETE /v1/new-hire-monitors/{monitor_id}","href":"/api-reference/new-hire-monitors/delete"},{"title":"Add companies to a new hire monitor","openapi":"openapi.json POST /v1/new-hire-monitors/{monitor_id}/companies","href":"/api-reference/new-hire-monitors/companies/add"},{"title":"Remove a company from a new hire monitor","openapi":"openapi.json DELETE /v1/new-hire-monitors/{monitor_id}/companies/{identifier}","href":"/api-reference/new-hire-monitors/companies/remove"},{"title":"List new hire events","openapi":"openapi.json GET /v1/new-hire-monitors/{monitor_id}/events","href":"/api-reference/new-hire-monitors/events"},{"title":"Mark a new hire event as read","openapi":"openapi.json POST /v1/new-hire-monitors/{monitor_id}/events/{event_id}/read","href":"/api-reference/new-hire-monitors/events/read"},{"title":"Redeliver a new hire webhook","openapi":"openapi.json POST /v1/new-hire-monitors/{monitor_id}/events/{event_id}/webhook/redeliver","href":"/api-reference/new-hire-monitors/events/redeliver"}]},{"group":"Post engagements","expanded":false,"pages":[{"title":"Create a post engagement monitor","openapi":"openapi.json POST /v1/post-engagement-monitors","href":"/api-reference/post-engagement-monitors/create"},{"title":"List post engagement monitors","openapi":"openapi.json GET /v1/post-engagement-monitors","href":"/api-reference/post-engagement-monitors/list"},{"title":"Get a post engagement monitor","description":"Retrieve one monitor and its active sources. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.","openapi":"openapi.json GET /v1/post-engagement-monitors/{monitor_id}","href":"/api-reference/post-engagement-monitors/get"},{"title":"Update a post engagement monitor","openapi":"openapi.json PATCH /v1/post-engagement-monitors/{monitor_id}","href":"/api-reference/post-engagement-monitors/update"},{"title":"Delete a post engagement monitor","description":"Stop a monitor and remove it from the API while keeping its results table. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints.","openapi":"openapi.json DELETE /v1/post-engagement-monitors/{monitor_id}","href":"/api-reference/post-engagement-monitors/delete"},{"title":"Add sources to a post engagement monitor","openapi":"openapi.json POST /v1/post-engagement-monitors/{monitor_id}/sources","href":"/api-reference/post-engagement-monitors/sources/add"},{"title":"Remove a source from a post engagement monitor","openapi":"openapi.json DELETE /v1/post-engagement-monitors/{monitor_id}/sources/{source_id}","href":"/api-reference/post-engagement-monitors/sources/remove"},{"title":"List post engagers","openapi":"openapi.json GET /v1/post-engagement-monitors/{monitor_id}/engagers","href":"/api-reference/post-engagement-monitors/engagers"},{"title":"List post engagements","openapi":"openapi.json GET /v1/post-engagement-monitors/{monitor_id}/engagements","href":"/api-reference/post-engagement-monitors/engagements"},{"title":"Mark a post engager as read","openapi":"openapi.json POST /v1/post-engagement-monitors/{monitor_id}/engagers/{engager_id}/read","href":"/api-reference/post-engagement-monitors/engagers/read"},{"title":"Redeliver a post engager webhook","openapi":"openapi.json POST /v1/post-engagement-monitors/{monitor_id}/engagers/{engager_id}/webhook/redeliver","href":"/api-reference/post-engagement-monitors/engagers/redeliver"}]}]},{"group":"Miscellaneous","expanded":false,"pages":[{"title":"Business intent topics","openapi":"openapi.json POST /v1/business-intent-topics","href":"/api-reference/business-intent-topics"},{"title":"Website Technologies","openapi":"openapi.json POST /v1/technologies","href":"/api-reference/miscellaneous/website-technologies"},{"title":"WhatsApp checker","openapi":"openapi.json POST /v1/whatsapp-check","href":"/api-reference/miscellaneous/whatsapp-check"},{"title":"WhatsApp check status","openapi":"openapi.json GET /v1/whatsapp-check/operations/{operation_id}","href":"/api-reference/miscellaneous/whatsapp-check/status"},{"title":"Meta Ads","openapi":"openapi.json POST /v1/meta-ads","href":"/api-reference/miscellaneous/meta-ads"},{"title":"Google Ads","openapi":"openapi.json POST /v1/google-ads","href":"/api-reference/miscellaneous/google-ads"},{"title":"Google Maps","openapi":"openapi.json POST /v1/google-maps","href":"/api-reference/miscellaneous/google-maps"},{"title":"Email verifier","openapi":"openapi.json POST /v1/email-verifier","href":"/api-reference/miscellaneous/email-verifier"},{"title":"US DNC Checker","openapi":"openapi.json POST /v1/us-dnc-check","href":"/api-reference/dnc-checker"},{"title":"UK DNC Checker","openapi":"openapi.json POST /v1/uk-dnc-check","href":"/api-reference/uk-dnc-checker"}]}]},{"tab":"MCP \u0026 Agents","pages":[{"title":"MCP \u0026 Agents","href":"/mcp/how-to-use-the-airscale-mcp"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli/overview"}]},{"tab":"Use cases","pages":[{"title":"Use cases","href":"/usecases/quick-beginner-guide"}]}]},"basePath":"","title":"Update a post engagement monitor - Airschool","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}