What to alert on. Use limits.all for a combined Limits alert, or a single limit such as limits.api,
limits.concurrency, limits.queue, limits.webhooks.processing,
limits.webhooks.env_rate, limits.webhooks.endpoint_rate or limits.webhooks.waiters.
string
required
One of dev, staging, prod or preview.
string
Preview branch. Only valid when environment is preview.
object
required
Show properties
number
Evaluation window in seconds.
object
required
For Limits alerts, set kind to state and stateKey to the same value as capabilityKey.
Show properties
string[]
limits.all only. The limits to watch. Defaults to all of them. Values are the single limit
capability keys above.
"any" | "all"
limits.all only. Raise when any selected limit is true, or only when all are.
("approaching" | "limited")[]
Which limit signals to watch. approaching means usage has reached the utilisation share;
limited means the limit is already affecting traffic. limits.queue only supports
approaching.
object
Thresholds, for example utilisationPct (default 80, from 1 to 100).
object[]
required
At least one notifier, for example { "type": "channel", "channelId": "..." }.
object
required
Optional expiresAt (ISO 8601 date in the future).
string
A name for the alert.
Invalid components or signals return a 400 with an error message.
Group alerts
Set capabilityKey to alerts.group to group alerts. The group raises when compositeMode is any or all of its members fire. Members keep evaluating but notify only through the group.
members (optional): alerts to create with the group. Each has the same body as a single alert, without environment or branch. The group and its members are created in one transaction, so a validation error fails the whole request.
A group holds at most 20 alerts, existing and inline combined. Members must be active, not already in a group, and in the same environment.
action: "ungroup" on the alert endpoint dissolves the group. It requires delete permission.
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Trigger.dev","description":"Trigger.dev is an open source background jobs framework that lets you write reliable workflows in plain async code. Run long-running AI tasks, handle complex background jobs, and build AI agents with built-in queuing, automatic retries, and real-time monitoring. No timeouts, elastic scaling, and zero infrastructure management required.","colors":{"primary":"#A8FF53","light":"#A8FF53","dark":"#A8FF53"},"logo":{"light":"https://mintlify.s3.us-west-1.amazonaws.com/trigger/logo/light.png","dark":"https://mintcdn.com/trigger/0bD0UfsjaINxS6Tw/logo/dark.png?fit=max\u0026auto=format\u0026n=0bD0UfsjaINxS6Tw\u0026q=85\u0026s=42d177f642319662a1d62d66af79e168","href":"https://trigger.dev"},"favicon":"https://mintcdn.com/trigger/uys6iMwf9B_ojh8r/images/favicon.png?fit=max\u0026auto=format\u0026n=uys6iMwf9B_ojh8r\u0026q=85\u0026s=a0941157a9b102cbf0db33280d518458","api":{"openapi":["openapi.yml","v3-openapi.yaml"],"playground":{"display":"simple"}},"appearance":{"default":"dark","strict":true},"background":{"color":{"light":"#fff","dark":"#121317"}},"navbar":{"primary":{"type":"github","href":"https://github.com/triggerdotdev/trigger.dev"}},"footer":{"socials":{"x":"https://twitter.com/triggerdotdev","github":"https://github.com/triggerdotdev","linkedin":"https://www.linkedin.com/company/triggerdotdev"},"links":[{"header":"Developers","items":[{"label":"Changelog","href":"https://trigger.dev/changelog"},{"label":"Contributing","href":"https://github.com/triggerdotdev/trigger.dev/blob/main/CONTRIBUTING.md"},{"label":"Open source","href":"https://github.com/triggerdotdev/trigger.dev?tab=Apache-2.0-1-ov-file"},{"label":"GitHub","href":"https://github.com/triggerdotdev/trigger.dev"},{"label":"OSS Friends","href":"https://trigger.dev/oss-friends"}]},{"header":"Product","items":[{"label":"Pricing","href":"https://trigger.dev/pricing"},{"label":"How it works","href":"https://trigger.dev/"},{"label":"Features","href":"https://trigger.dev/product"},{"label":"Roadmap","href":"https://feedback.trigger.dev/roadmap"},{"label":"FAQs","href":"https://trigger.dev/pricing"},{"label":"Uptime status","href":"https://status.trigger.dev/"}]},{"header":"Company","items":[{"label":"Blog","href":"https://trigger.dev/blog"},{"label":"Contact","href":"https://trigger.dev/contact"},{"label":"Careers","href":"https://trigger.dev/jobs"},{"label":"Privacy","href":"https://trigger.dev/legal/privacy"},{"label":"Terms of service","href":"https://trigger.dev/legal"}]}]},"styling":{"codeblocks":{"theme":"css-variables"},"latex":false},"contextual":{"options":["copy","view","claude"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"trigger","hasAudioNarration":false,"actualSubdomain":"trigger","customDomains":["trigger.dev"],"gitSource":{"type":"github","owner":"triggerdotdev","repo":"trigger.dev","deployBranch":"docs-live","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":false,"issues":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b0069b0cf93c63408f16917","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Documentation","count":251},{"language":"default","tag":"API reference","count":100},{"language":"default","tag":"Guides \u0026 examples","count":88},{"language":"default","tag":"Webhooks","count":56},{"language":"default","tag":"Agents","count":51},{"language":"default","tag":"Providers","count":46},{"language":"default","tag":"Built-in providers","count":42},{"language":"default","tag":"Example projects","count":24},{"language":"default","tag":"Example tasks","count":24},{"language":"default","tag":"Writing tasks","count":22}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"rbac-expansion","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":"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":"site-roles","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":"instinct-self-updating-docs","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":"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":"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":"editor-metadata","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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"button~.absolute.peer-hover\\:opacity-100{color:#000}:root{--mint-color-background: #121317;--mint-color-text: #d4d4d4;--mint-token-constant: #9b99ff;--mint-token-string: #afec73;--mint-token-comment: #5f6570;--mint-token-keyword: #e888f8;--mint-token-parameter: #cccbff;--mint-token-function: #d9f07c;--mint-token-string-expression: #afec73;--mint-token-punctuation: #878c99;--mint-token-link: #826dff;--shiki-foreground: #d4d4d4;--shiki-background: #121317;--shiki-token-constant: #9b99ff;--shiki-token-string: #afec73;--shiki-token-comment: #5f6570;--shiki-token-keyword: #e888f8;--shiki-token-parameter: #cccbff;--shiki-token-function: #d9f07c;--shiki-token-string-expression: #afec73;--shiki-token-punctuation: #878c99;--shiki-token-link: #826dff}"}]}
{"page":{"pagePath":"management/alerts/create","slug":"/management/alerts/create","pageMetadata":{"title":"Create an alert","description":"Create a monitoring alert for a project, including Limits alerts.","api":"POST https://api.trigger.dev/api/v1/projects/{projectRef}/monitoring-alerts","href":"/management/alerts/create"},"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: \"Create a monitoring alert for a project, including Limits alerts.\"\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];const PrivateBeta=({children})=>{const{Warning}=_provideComponents()||{};if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(Warning,{children:[_jsx(`strong`,{children:`Private beta.`}),` This feature is only available to some organizations right now.`,children]})};function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,_MdxComponentBoundary}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsxs(_Fragment,{children:[_jsx(_MdxComponentBoundary,{name:`PrivateBeta`,children:_jsx(PrivateBeta,{flag:`alertsEnabled`})}),`\n`,_jsxs(_components.p,{children:[`Authenticate with a `,_jsx(_components.a,{href:`/management/authentication`,children:`personal access token`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`body`,children:`Body`}),`\n`,_jsx(ParamField,{body:`capabilityKey`,type:`string`,required:true,id:`param-capability-key`,children:_jsxs(_components.p,{children:[`What to alert on. Use `,_jsx(_components.code,{children:`limits.all`}),` for a combined Limits alert, or a single limit such as `,_jsx(_components.code,{children:`limits.api`}),`,\n`,_jsx(_components.code,{children:`limits.concurrency`}),`, `,_jsx(_components.code,{children:`limits.queue`}),`, `,_jsx(_components.code,{children:`limits.webhooks.processing`}),`,\n`,_jsx(_components.code,{children:`limits.webhooks.env_rate`}),`, `,_jsx(_components.code,{children:`limits.webhooks.endpoint_rate`}),` or `,_jsx(_components.code,{children:`limits.webhooks.waiters`}),`.`]})}),`\n`,_jsx(ParamField,{body:`environment`,type:`string`,required:true,id:`param-environment`,children:_jsxs(_components.p,{children:[`One of `,_jsx(_components.code,{children:`dev`}),`, `,_jsx(_components.code,{children:`staging`}),`, `,_jsx(_components.code,{children:`prod`}),` or `,_jsx(_components.code,{children:`preview`}),`.`]})}),`\n`,_jsx(ParamField,{body:`branch`,type:`string`,id:`param-branch`,children:_jsxs(_components.p,{children:[`Preview branch. Only valid when `,_jsx(_components.code,{children:`environment`}),` is `,_jsx(_components.code,{children:`preview`}),`.`]})}),`\n`,_jsx(ParamField,{body:`params`,type:`object`,required:true,id:`param-params`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`windowSec`,type:`number`,id:`param-window-sec`,children:_jsx(_components.p,{children:`Evaluation window in seconds.`})})})}),`\n`,_jsxs(ParamField,{body:`condition`,type:`object`,required:true,id:`param-condition`,children:[_jsxs(_components.p,{children:[`For Limits alerts, set `,_jsx(_components.code,{children:`kind`}),` to `,_jsx(_components.code,{children:`state`}),` and `,_jsx(_components.code,{children:`stateKey`}),` to the same value as `,_jsx(_components.code,{children:`capabilityKey`}),`.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`components`,type:`string[]`,id:`param-components`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`limits.all`}),` only. The limits to watch. Defaults to all of them. Values are the single limit\ncapability keys above.`]})}),_jsx(ParamField,{body:`compositeMode`,type:`\"any\" | \"all\"`,id:`param-composite-mode`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`limits.all`}),` only. Raise when any selected limit is true, or only when all are.`]})}),_jsx(ParamField,{body:`signals`,type:`(\"approaching\" | \"limited\")[]`,id:`param-signals`,children:_jsxs(_components.p,{children:[`Which limit signals to watch. `,_jsx(_components.code,{children:`approaching`}),` means usage has reached the utilisation share;\n`,_jsx(_components.code,{children:`limited`}),` means the limit is already affecting traffic. `,_jsx(_components.code,{children:`limits.queue`}),` only supports\n`,_jsx(_components.code,{children:`approaching`}),`.`]})}),_jsx(ParamField,{body:`params`,type:`object`,id:`param-params-1`,children:_jsxs(_components.p,{children:[`Thresholds, for example `,_jsx(_components.code,{children:`utilisationPct`}),` (default 80, from 1 to 100).`]})})]})]}),`\n`,_jsx(ParamField,{body:`notifiers`,type:`object[]`,required:true,id:`param-notifiers`,children:_jsxs(_components.p,{children:[`At least one notifier, for example `,_jsx(_components.code,{children:`{ \"type\": \"channel\", \"channelId\": \"...\" }`}),`.`]})}),`\n`,_jsx(ParamField,{body:`behavior`,type:`object`,required:true,id:`param-behavior`,children:_jsxs(_components.p,{children:[`Optional `,_jsx(_components.code,{children:`expiresAt`}),` (ISO 8601 date in the future).`]})}),`\n`,_jsx(ParamField,{body:`name`,type:`string`,id:`param-name`,children:_jsx(_components.p,{children:`A name for the alert.`})}),`\n`,_jsxs(_components.p,{children:[`Invalid `,_jsx(_components.code,{children:`components`}),` or `,_jsx(_components.code,{children:`signals`}),` return a `,_jsx(_components.code,{children:`400`}),` with an error message.`]}),`\n`,_jsx(Heading,{level:`2`,id:`group-alerts`,children:`Group alerts`}),`\n`,_jsxs(_components.p,{children:[`Set `,_jsx(_components.code,{children:`capabilityKey`}),` to `,_jsx(_components.code,{children:`alerts.group`}),` to group alerts. The group raises when `,_jsx(_components.code,{children:`compositeMode`}),` is `,_jsx(_components.code,{children:`any`}),` or `,_jsx(_components.code,{children:`all`}),` of its members fire. Members keep evaluating but notify only through the group.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`condition`}),`: `,_jsx(_components.code,{children:`{ \"kind\": \"state\", \"stateKey\": \"group\", \"compositeMode\": \"any\" | \"all\", \"memberAlertIds\": [\"alert_1234\"] }`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`members`}),` (optional): alerts to create with the group. Each has the same body as a single alert, without `,_jsx(_components.code,{children:`environment`}),` or `,_jsx(_components.code,{children:`branch`}),`. The group and its members are created in one transaction, so a validation error fails the whole request.`]}),`\n`,_jsx(_components.li,{children:`A group holds at most 20 alerts, existing and inline combined. Members must be active, not already in a group, and in the same environment.`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`action: \"ungroup\"`}),` on the alert endpoint dissolves the group. It requires delete permission.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`examples`,children:`Examples`}),`\n`,_jsx(_components.p,{children:`Watch every limit and raise when any is true:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`17`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes css-variables css-variables`,style:{backgroundColor:`var(--mint-background)`,\"--shiki-dark-bg\":`var(--mint-background)`,color:`var(--mint-foreground)`,\"--shiki-dark\":`var(--mint-foreground)`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`17`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`var(--mint-token-function, #0068d6)`,\"--shiki-dark\":`var(--mint-token-function, #0068d6)`},children:`curl`}),_jsx(_components.span,{style:{color:`var(--mint-token-string, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string, #297a3a)`},children:` -X`}),_jsx(_components.span,{style:{color:`var(--mint-token-string, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string, #297a3a)`},children:` POST`}),_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"https://api.trigger.dev/api/v1/projects/proj_1234/monitoring-alerts\"`}),_jsx(_components.span,{style:{color:`var(--mint-foreground)`,\"--shiki-dark\":`var(--mint-foreground)`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`var(--mint-token-string, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string, #297a3a)`},children:` -H`}),_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"Authorization: Bearer $TRIGGER_ACCESS_TOKEN\"`}),_jsx(_components.span,{style:{color:`var(--mint-foreground)`,\"--shiki-dark\":`var(--mint-foreground)`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`var(--mint-token-string, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string, #297a3a)`},children:` -H`}),_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`var(--mint-foreground)`,\"--shiki-dark\":`var(--mint-foreground)`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`var(--mint-token-string, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string, #297a3a)`},children:` -d`}),_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"capabilityKey\": \"limits.all\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"environment\": \"prod\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"params\": { \"windowSec\": 300 },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"condition\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"kind\": \"state\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"stateKey\": \"limits.all\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"compositeMode\": \"any\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"signals\": [\"approaching\", \"limited\"],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"params\": { \"utilisationPct\": 80 }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"behavior\": {},`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"notifiers\": [{ \"type\": \"channel\", \"channelId\": \"channel_1234\" }]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Watch only the API rate limit, when usage reaches 90%:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`16`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes css-variables css-variables`,style:{backgroundColor:`var(--mint-background)`,\"--shiki-dark-bg\":`var(--mint-background)`,color:`var(--mint-foreground)`,\"--shiki-dark\":`var(--mint-foreground)`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`16`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`var(--mint-token-function, #0068d6)`,\"--shiki-dark\":`var(--mint-token-function, #0068d6)`},children:`curl`}),_jsx(_components.span,{style:{color:`var(--mint-token-string, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string, #297a3a)`},children:` -X`}),_jsx(_components.span,{style:{color:`var(--mint-token-string, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string, #297a3a)`},children:` POST`}),_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"https://api.trigger.dev/api/v1/projects/proj_1234/monitoring-alerts\"`}),_jsx(_components.span,{style:{color:`var(--mint-foreground)`,\"--shiki-dark\":`var(--mint-foreground)`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`var(--mint-token-string, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string, #297a3a)`},children:` -H`}),_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"Authorization: Bearer $TRIGGER_ACCESS_TOKEN\"`}),_jsx(_components.span,{style:{color:`var(--mint-foreground)`,\"--shiki-dark\":`var(--mint-foreground)`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`var(--mint-token-string, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string, #297a3a)`},children:` -H`}),_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`var(--mint-foreground)`,\"--shiki-dark\":`var(--mint-foreground)`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`var(--mint-token-string, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string, #297a3a)`},children:` -d`}),_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"capabilityKey\": \"limits.api\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"environment\": \"prod\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"params\": { \"windowSec\": 300 },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"condition\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"kind\": \"state\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"stateKey\": \"limits.api\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"signals\": [\"approaching\"],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"params\": { \"utilisationPct\": 90 }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"behavior\": {},`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` \"notifiers\": [{ \"type\": \"channel\", \"channelId\": \"channel_1234\" }]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-token-string-expression, #297a3a)`,\"--shiki-dark\":`var(--mint-token-string-expression, #297a3a)`},children:` }'`})}),`\n`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{PrivateBeta,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":"css-variables"},"config":{},"pageMetadata":{"title":"Create an alert","description":"Create a monitoring alert for a project, including Limits alerts.","api":"POST https://api.trigger.dev/api/v1/projects/{projectRef}/monitoring-alerts","href":"/management/alerts/create"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Body","slug":"body","depth":2,"children":[]},{"title":"Group alerts","slug":"group-alerts","depth":2,"children":[]},{"title":"Examples","slug":"examples","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Create an alert","path":"/api/v1/projects/{projectRef}/monitoring-alerts","servers":[{"url":"https://api.trigger.dev"}],"method":"post","request":{"security":[],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"capabilityKey":[{"type":"string","description":"What to alert on. Use `limits.all` for a combined Limits alert, or a single limit such as `limits.api` , `limits.concurrency` , `limits.queue` , `limits.webhooks.processing` , `limits.webhooks.env_rate` , `limits.webhooks.endpoint_rate` or `limits.webhooks.waiters` .","required":true}],"environment":[{"type":"string","description":"One of `dev` , `staging` , `prod` or `preview` .","required":true}],"branch":[{"type":"string","description":"Preview branch. Only valid when `environment` is `preview` ."}],"params":[{"type":"object","properties":{"windowSec":[{"type":"number","description":"Evaluation window in seconds."}]},"required":true}],"condition":[{"type":"object","properties":{"components":[{"type":"array","items":[{"type":"string"}],"description":"`limits.all` only. The limits to watch. Defaults to all of them. Values are the single limit capability keys above."}],"compositeMode":[{"type":"object","properties":{},"description":"`limits.all` only. Raise when any selected limit is true, or only when all are."}],"signals":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Which limit signals to watch. `approaching` means usage has reached the utilisation share; `limited` means the limit is already affecting traffic. `limits.queue` only supports `approaching` ."}],"params":[{"type":"object","properties":{},"description":"Thresholds, for example `utilisationPct` (default 80, from 1 to 100)."}]},"description":"For Limits alerts, set `kind` to `state` and `stateKey` to the same value as `capabilityKey` .","required":true}],"notifiers":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"At least one notifier, for example `{ \"type\": \"channel\", \"channelId\": \"...\" }` .","required":true}],"behavior":[{"type":"object","properties":{},"description":"Optional `expiresAt` (ISO 8601 date in the future).","required":true}],"name":[{"type":"string","description":"A name for the alert."}]}}],"examples":{"example":{"value":{"capabilityKey":"\u003cstring>","environment":"\u003cstring>","branch":"\u003cstring>","params":{"windowSec":123},"condition":{"components":["\u003cstring>"],"compositeMode":{},"signals":[{}],"params":{}},"notifiers":[{}],"behavior":{},"name":"\u003cstring>"}}}}}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"trigger","siteName":"Trigger.dev","title":"Create an alert - Trigger.dev","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T16:22:46.990Z","originalFileLocation":"management/alerts/create.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";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=\"dark\"}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=\"Create a monitoring alert for a project, including Limits alerts.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Trigger.dev\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/trigger/dAMCNvNG7r7-Ozw1/_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=\"/docs/mintlify-assets/_mintlify/favicons/trigger/dAMCNvNG7r7-Ozw1/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/trigger/dAMCNvNG7r7-Ozw1/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/trigger/dAMCNvNG7r7-Ozw1/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/trigger/dAMCNvNG7r7-Ozw1/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/trigger/dAMCNvNG7r7-Ozw1/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/trigger/dAMCNvNG7r7-Ozw1/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/trigger/dAMCNvNG7r7-Ozw1/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/trigger/dAMCNvNG7r7-Ozw1/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create an alert - Trigger.dev\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a monitoring alert for a project, including Limits alerts.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Trigger.dev\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://trigger.dev/docs/management/alerts/create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://trigger.mintlify.site/docs/_mintlify/api/og/v2?division=Alerts+API\u0026amp;title=Create+an+alert\u0026amp;description=Create+a+monitoring+alert+for+a+project%2C+including+Limits+alerts.\u0026amp;theme=a5bdee7a99608ff6863102f8\u0026amp;signature=8ad8b537521bcbeed831530096f98ddb8185b4cf2b283bee94ad71e7aaaccdf8\">\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=\"Create an alert - Trigger.dev\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a monitoring alert for a project, including Limits alerts.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://trigger.mintlify.site/docs/_mintlify/api/og/v2?division=Alerts+API\u0026amp;title=Create+an+alert\u0026amp;description=Create+a+monitoring+alert+for+a+project%2C+including+Limits+alerts.\u0026amp;theme=a5bdee7a99608ff6863102f8\u0026amp;signature=8ad8b537521bcbeed831530096f98ddb8185b4cf2b283bee94ad71e7aaaccdf8\">\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=\"/docs/mintlify-assets/_mintlify/favicons/trigger/dAMCNvNG7r7-Ozw1/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Trigger.dev\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#A8FF53\">\u003clink data-mint-head rel=\"canonical\" href=\"https://trigger.dev/docs/management/alerts/create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/management/alerts/create.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://trigger.dev/#organization\",\"name\":\"Trigger.dev\",\"url\":\"https://trigger.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintlify.s3.us-west-1.amazonaws.com/trigger/logo/light.png\"}},{\"@type\":\"WebSite\",\"@id\":\"https://trigger.dev/docs#website\",\"name\":\"Trigger.dev\",\"url\":\"https://trigger.dev/docs\",\"publisher\":{\"@id\":\"https://trigger.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://trigger.dev/docs/management/alerts/create#webpage\",\"url\":\"https://trigger.dev/docs/management/alerts/create\",\"name\":\"Create an alert\",\"description\":\"Create a monitoring alert for a project, including Limits alerts.\",\"dateModified\":\"2026-11-10T16:22:46.990Z\",\"isPartOf\":{\"@id\":\"https://trigger.dev/docs#website\"},\"breadcrumb\":{\"@id\":\"https://trigger.dev/docs/management/alerts/create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://trigger.dev/docs/management/alerts/create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Trigger.dev\",\"item\":\"https://trigger.dev/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create an alert\",\"item\":\"https://trigger.dev/docs/management/alerts/create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://trigger.dev/docs/management/alerts/create#apireference\",\"headline\":\"Create an alert\",\"name\":\"Create an alert\",\"description\":\"Create a monitoring alert for a project, including Limits alerts.\",\"url\":\"https://trigger.dev/docs/management/alerts/create\",\"mainEntityOfPage\":{\"@id\":\"https://trigger.dev/docs/management/alerts/create#webpage\"},\"dateModified\":\"2026-11-10T16:22:46.990Z\",\"publisher\":{\"@id\":\"https://trigger.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://trigger.dev/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Trigger.dev\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Trigger.dev\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/management/alerts/create.md","siteName":"Trigger.dev","nav":{"global":null,"dropdowns":[{"dropdown":"Documentation","icon":"book-open","description":"Resources for Trigger.dev","groups":[{"group":"Getting started","pages":[{"title":"Trigger.dev docs","sidebarTitle":"Introduction","mode":"center","href":"/introduction"},{"title":"Quick start: add Trigger.dev to your project","sidebarTitle":"Quick start","href":"/quick-start"},{"title":"Manual setup","href":"/manual-setup"},{"title":"Video walkthrough","href":"/video-walkthrough"},{"title":"How Trigger.dev works","sidebarTitle":"How it works","href":"/how-it-works"},{"title":"Limits","href":"/limits"}]},{"group":"Fundamentals","pages":[{"group":"Tasks","pages":[{"title":"Tasks: Overview","sidebarTitle":"Overview","href":"/tasks/overview"},{"title":"schemaTask","sidebarTitle":"Schema task","href":"/tasks/schemaTask"},{"title":"Scheduled tasks (cron)","href":"/tasks/scheduled"}]},{"title":"Triggering","href":"/triggering"},{"title":"Runs","href":"/runs"},{"group":"Runs","hidden":true,"searchable":true,"pages":[{"title":"Using runs.list() efficiently","sidebarTitle":"runs.list() best practices","href":"/runs/list-best-practices"}]},{"group":"API keys","pages":[{"title":"API keys","href":"/apikeys"},{"title":"Custom API key access","sidebarTitle":"Custom access","href":"/apikeys/custom-access"}]},{"group":"OIDC","pages":[{"title":"OpenID Connect (OIDC)","sidebarTitle":"Overview","href":"/oidc"},{"title":"Connect to AWS","sidebarTitle":"AWS","href":"/oidc/aws"},{"title":"Connect to Microsoft Azure","sidebarTitle":"Azure","href":"/oidc/azure"},{"title":"Connect to Google Cloud","sidebarTitle":"Google Cloud","href":"/oidc/gcp"},{"title":"Connect to Anthropic","sidebarTitle":"Anthropic","href":"/oidc/anthropic"},{"title":"Connect to HashiCorp Vault","sidebarTitle":"Vault","href":"/oidc/vault"},{"title":"Connect to Infisical","sidebarTitle":"Infisical","href":"/oidc/infisical"},{"title":"Connect to Doppler","sidebarTitle":"Doppler","href":"/oidc/doppler"},{"title":"Connect to Snowflake","sidebarTitle":"Snowflake","href":"/oidc/snowflake"},{"title":"Connect to Databricks","sidebarTitle":"Databricks","href":"/oidc/databricks"},{"title":"Connect to Hugging Face","sidebarTitle":"Hugging Face","href":"/oidc/hugging-face"},{"title":"Connect to OpenRouter","sidebarTitle":"OpenRouter","href":"/oidc/openrouter"},{"title":"Custom OIDC integrations","sidebarTitle":"Custom integrations","href":"/oidc/custom"}]}]},{"group":"Building with AI","pages":[{"title":"Building with AI: overview","sidebarTitle":"Overview","href":"/building-with-ai"},{"group":"MCP Server","pages":[{"title":"MCP Introduction","sidebarTitle":"Introduction","href":"/mcp-introduction"},{"title":"MCP Tools","sidebarTitle":"Tools","href":"/mcp-tools"}]},{"title":"Skills","sidebarTitle":"Skills","href":"/skills"},{"title":"Agent rules","sidebarTitle":"Agent rules","href":"/mcp-agent-rules"}]},{"group":"Writing tasks","pages":[{"title":"Writing tasks: Overview","sidebarTitle":"Overview","href":"/writing-tasks-introduction"},{"title":"Logging, tracing \u0026 metrics","href":"/logging"},{"title":"Errors \u0026 Retrying","href":"/errors-retrying"},{"group":"Wait","pages":[{"title":"Wait: Overview","sidebarTitle":"Overview","href":"/wait"},{"title":"Wait for","href":"/wait-for"},{"title":"Wait until","href":"/wait-until"},{"title":"Wait for token","href":"/wait-for-token"}]},{"title":"Queues","href":"/queues"},{"title":"Concurrency","href":"/concurrency"},{"title":"Versioning","href":"/versioning"},{"title":"Machines","href":"/machines"},{"title":"Idempotency","href":"/idempotency"},{"title":"Max duration","sidebarTitle":"Max duration","href":"/runs/max-duration"},{"title":"Heartbeats","sidebarTitle":"Heartbeats","href":"/runs/heartbeats"},{"title":"Tags","href":"/tags"},{"title":"Run metadata","sidebarTitle":"Metadata","href":"/runs/metadata"},{"title":"Streaming data from tasks","sidebarTitle":"Streams","href":"/tasks/streams"},{"title":"Usage","href":"/run-usage"},{"title":"Context","href":"/context"},{"title":"Priority","href":"/runs/priority"},{"title":"Hidden tasks","href":"/hidden-tasks"},{"title":"Bulk actions with the SDK","sidebarTitle":"Bulk actions","href":"/runs/bulk-actions"}]},{"group":"Agents","pages":[{"title":"AI Agents","sidebarTitle":"Overview","href":"/ai-chat/overview"},{"title":"Quick Start","sidebarTitle":"Quick Start","href":"/ai-chat/quick-start"},{"title":"Migrate from an AI SDK route handler","sidebarTitle":"Migrate from a route handler","href":"/ai-chat/migrating-from-a-route-handler"},{"group":"Building agents","pages":[{"title":"Anatomy of an agent","sidebarTitle":"Anatomy","href":"/ai-chat/anatomy"},{"title":"Backend","sidebarTitle":"Backend","href":"/ai-chat/backend"},{"title":"Lifecycle hooks","sidebarTitle":"Lifecycle hooks","href":"/ai-chat/lifecycle-hooks"},{"title":"Tools","sidebarTitle":"Tools","href":"/ai-chat/tools"},{"title":"Frontend","sidebarTitle":"Frontend","href":"/ai-chat/frontend"},{"title":"Server-Side Chat","sidebarTitle":"Server-Side Chat","href":"/ai-chat/server-chat"},{"title":"Sessions","sidebarTitle":"Sessions","href":"/ai-chat/sessions"},{"title":"Side channels","sidebarTitle":"Side channels","href":"/ai-chat/side-channels"},{"title":"chat.local","sidebarTitle":"chat.local","href":"/ai-chat/chat-local"},{"title":"Types","sidebarTitle":"Types","href":"/ai-chat/types"},{"title":"Custom agents","sidebarTitle":"Custom agents","href":"/ai-chat/custom-agents"},{"title":"How the AI Agents SDK works","sidebarTitle":"How it works","href":"/ai-chat/how-it-works"}]},{"group":"Features","pages":[{"title":"Prompts","sidebarTitle":"Prompts","href":"/ai/prompts"},{"title":"LLM observability","sidebarTitle":"LLM observability","href":"/ai/observability"},{"title":"Fast starts","sidebarTitle":"Fast starts","href":"/ai-chat/fast-starts"},{"title":"Compaction","sidebarTitle":"Compaction","href":"/ai-chat/compaction"},{"title":"Prompt caching","sidebarTitle":"Prompt caching","href":"/ai-chat/prompt-caching"},{"title":"Pending Messages","sidebarTitle":"Pending Messages","href":"/ai-chat/pending-messages"},{"title":"Background injection","sidebarTitle":"Background injection","href":"/ai-chat/background-injection"},{"title":"Actions","sidebarTitle":"Actions","href":"/ai-chat/actions"},{"title":"Transcript storage","sidebarTitle":"Transcript storage","href":"/ai-chat/transcript-storage"},{"title":"Migrate from hydrateMessages to transcript storage","sidebarTitle":"Migrating from hydrateMessages","href":"/ai-chat/migrating-from-hydrate-messages"},{"title":"Error handling","sidebarTitle":"Error handling","href":"/ai-chat/error-handling"}]},{"group":"Channels","pages":[{"title":"Channels (chat frontends)","sidebarTitle":"Overview","href":"/webhooks/channels"},{"title":"Slack agents","sidebarTitle":"Slack agents","href":"/webhooks/slack"},{"title":"Linear agents","sidebarTitle":"Linear agents","href":"/webhooks/linear"},{"title":"Human-in-the-loop over a channel","sidebarTitle":"Human-in-the-loop","href":"/webhooks/human-in-the-loop"}]},{"group":"Patterns","pages":[{"title":"Sub-Agents","sidebarTitle":"Sub-Agents","href":"/ai-chat/patterns/sub-agents"},{"title":"Version upgrades","sidebarTitle":"Version upgrades","href":"/ai-chat/patterns/version-upgrades"},{"title":"Database persistence for chat","sidebarTitle":"Database persistence","href":"/ai-chat/patterns/database-persistence"},{"title":"Persistence and replay","sidebarTitle":"Persistence and replay","href":"/ai-chat/patterns/persistence-and-replay"},{"title":"Branching conversations","sidebarTitle":"Branching conversations","href":"/ai-chat/patterns/branching-conversations"},{"title":"Code execution sandbox","sidebarTitle":"Code sandbox","href":"/ai-chat/patterns/code-sandbox"},{"title":"Human-in-the-loop","sidebarTitle":"Human-in-the-loop","href":"/ai-chat/patterns/human-in-the-loop"},{"title":"Tool result auditing","sidebarTitle":"Tool result auditing","href":"/ai-chat/patterns/tool-result-auditing"},{"title":"Large payloads in chat.agent","sidebarTitle":"Large payloads","href":"/ai-chat/patterns/large-payloads"},{"title":"Agent Skills","sidebarTitle":"Agent Skills","href":"/ai-chat/patterns/skills"},{"title":"OOM resilience","sidebarTitle":"OOM resilience","href":"/ai-chat/patterns/oom-resilience"},{"title":"Recovery boot","sidebarTitle":"Recovery boot","href":"/ai-chat/patterns/recovery-boot"},{"title":"Trusted edge signals","sidebarTitle":"Trusted edge signals","href":"/ai-chat/patterns/trusted-edge-signals"},{"title":"Redact chat content from traces","sidebarTitle":"Redact chat content","href":"/ai-chat/patterns/redacting-telemetry"},{"title":"Native compaction \u0026 provider fallback","sidebarTitle":"Native compaction","href":"/ai-chat/patterns/native-compaction"}]},{"group":"Reference","pages":[{"title":"API Reference","sidebarTitle":"API Reference","href":"/ai-chat/reference"},{"title":"Client Protocol","sidebarTitle":"Client Protocol","href":"/ai-chat/client-protocol"},{"title":"Testing","sidebarTitle":"Testing","href":"/ai-chat/testing"},{"title":"MCP Server","sidebarTitle":"MCP Server","href":"/ai-chat/mcp"},{"title":"Upgrade Guide: prerelease → Sessions-as-run-manager","sidebarTitle":"Sessions Upgrade Guide","href":"/ai-chat/upgrade-guide"},{"title":"AI Agents SDK changelog","sidebarTitle":"Changelog","href":"/ai-chat/changelog"}]}]},{"group":"Webhooks","pages":[{"title":"Webhooks overview","sidebarTitle":"Overview","href":"/webhooks/overview"},{"title":"Webhooks quick start","sidebarTitle":"Quick start","href":"/webhooks/quick-start"},{"title":"How webhooks work","sidebarTitle":"How it works","href":"/webhooks/how-it-works"},{"title":"Use your own webhook handler","sidebarTitle":"Using your own handler","href":"/webhooks/own-handler"},{"group":"Providers","expanded":true,"pages":[{"group":"Built-in providers","pages":[{"title":"Webhook providers","sidebarTitle":"All providers","href":"/webhooks/providers"},{"title":"Attio webhooks","sidebarTitle":"Attio","href":"/webhooks/providers/attio"},{"title":"Autumn webhooks","sidebarTitle":"Autumn","href":"/webhooks/providers/autumn"},{"title":"Cal.com webhooks","sidebarTitle":"Cal.com","href":"/webhooks/providers/cal-com"},{"title":"Calendly webhooks","sidebarTitle":"Calendly","href":"/webhooks/providers/calendly"},{"title":"Clerk webhooks","sidebarTitle":"Clerk","href":"/webhooks/providers/clerk"},{"title":"Discord webhooks","sidebarTitle":"Discord","href":"/webhooks/providers/discord"},{"title":"DocuSign webhooks","sidebarTitle":"DocuSign","href":"/webhooks/providers/docusign"},{"title":"ElevenLabs webhooks","sidebarTitle":"ElevenLabs","href":"/webhooks/providers/elevenlabs"},{"title":"Firecrawl webhooks","sidebarTitle":"Firecrawl","href":"/webhooks/providers/firecrawl"},{"title":"GitHub webhooks","sidebarTitle":"GitHub","href":"/webhooks/providers/github"},{"title":"GitLab webhooks","sidebarTitle":"GitLab","href":"/webhooks/providers/gitlab"},{"title":"Granola webhooks","sidebarTitle":"Granola","href":"/webhooks/providers/granola"},{"title":"Hookdeck webhooks","sidebarTitle":"Hookdeck","href":"/webhooks/providers/hookdeck"},{"title":"Infisical webhooks","sidebarTitle":"Infisical","href":"/webhooks/providers/infisical"},{"title":"Jira webhooks","sidebarTitle":"Jira","href":"/webhooks/providers/jira"},{"title":"Langfuse webhooks","sidebarTitle":"Langfuse","href":"/webhooks/providers/langfuse"},{"title":"Linear webhooks","sidebarTitle":"Linear","href":"/webhooks/providers/linear"},{"title":"Loops webhooks","sidebarTitle":"Loops","href":"/webhooks/providers/loops"},{"title":"Metronome webhooks","sidebarTitle":"Metronome","href":"/webhooks/providers/metronome"},{"title":"Mux webhooks","sidebarTitle":"Mux","href":"/webhooks/providers/mux"},{"title":"OpenAI webhooks","sidebarTitle":"OpenAI","href":"/webhooks/providers/openai"},{"title":"PagerDuty webhooks","sidebarTitle":"PagerDuty","href":"/webhooks/providers/pagerduty"},{"title":"Plain webhooks","sidebarTitle":"Plain","href":"/webhooks/providers/plain"},{"title":"PlanetScale webhooks","sidebarTitle":"PlanetScale","href":"/webhooks/providers/planetscale"},{"title":"Recall.ai webhooks","sidebarTitle":"Recall.ai","href":"/webhooks/providers/recall-ai"},{"title":"Replicate webhooks","sidebarTitle":"Replicate","href":"/webhooks/providers/replicate"},{"title":"Resend webhooks","sidebarTitle":"Resend","href":"/webhooks/providers/resend"},{"title":"Retell AI webhooks","sidebarTitle":"Retell AI","href":"/webhooks/providers/retell"},{"title":"Sentry webhooks","sidebarTitle":"Sentry","href":"/webhooks/providers/sentry"},{"title":"Shopify webhooks","sidebarTitle":"Shopify","href":"/webhooks/providers/shopify"},{"title":"Slack webhooks","sidebarTitle":"Slack","href":"/webhooks/providers/slack"},{"title":"Square webhooks","sidebarTitle":"Square","href":"/webhooks/providers/square"},{"title":"Receive and verify Stripe webhooks","sidebarTitle":"Stripe","href":"/webhooks/providers/stripe"},{"title":"Supabase webhooks","sidebarTitle":"Supabase","href":"/webhooks/providers/supabase"},{"title":"Tailscale webhooks","sidebarTitle":"Tailscale","href":"/webhooks/providers/tailscale"},{"title":"Typeform webhooks","sidebarTitle":"Typeform","href":"/webhooks/providers/typeform"},{"title":"Vapi webhooks","sidebarTitle":"Vapi","href":"/webhooks/providers/vapi"},{"title":"Vercel webhooks","sidebarTitle":"Vercel","href":"/webhooks/providers/vercel"},{"title":"WhatsApp webhooks","sidebarTitle":"WhatsApp","href":"/webhooks/providers/whatsapp"},{"title":"WorkOS webhooks","sidebarTitle":"WorkOS","href":"/webhooks/providers/workos"},{"title":"Zendesk webhooks","sidebarTitle":"Zendesk","href":"/webhooks/providers/zendesk"}]},{"title":"Custom webhook providers","sidebarTitle":"Custom providers","href":"/webhooks/custom-providers"},{"title":"Connect a webhook provider","sidebarTitle":"Connect a provider","href":"/webhooks/connect"},{"title":"Webhook signing secrets","sidebarTitle":"Signing secrets","href":"/webhooks/signing-secrets"},{"title":"Webhook verification","sidebarTitle":"Verification","href":"/webhooks/verification"}]},{"group":"Handle events","expanded":true,"pages":[{"title":"Webhook tasks","sidebarTitle":"Webhook tasks","href":"/webhooks/webhook-tasks"},{"title":"Filtering deliveries","sidebarTitle":"Filters","href":"/webhooks/filters"},{"title":"Waiting for a webhook","sidebarTitle":"Waiters","href":"/webhooks/waiters"},{"title":"Routing to a session","sidebarTitle":"Session routing","href":"/webhooks/session-routing"}]},{"group":"Deliveries and limits","expanded":true,"pages":[{"title":"Deliveries and endpoints","sidebarTitle":"Deliveries and endpoints","href":"/webhooks/deliveries"},{"title":"Webhooks pricing and limits","sidebarTitle":"Pricing \u0026 limits","href":"/webhooks/pricing-and-limits"}]}]},{"group":"Configuration","pages":[{"title":"The trigger.config.ts file","sidebarTitle":"trigger.config.ts","href":"/config/config-file"},{"group":"Build extensions","pages":[{"title":"Build extensions","sidebarTitle":"Overview","href":"/config/extensions/overview"},{"group":"Built-in extensions","pages":[{"title":"Prisma","sidebarTitle":"prismaExtension","href":"/config/extensions/prismaExtension"},{"title":"Python","sidebarTitle":"pythonExtension","href":"/config/extensions/pythonExtension"},{"title":"Playwright","sidebarTitle":"playwright","href":"/config/extensions/playwright"},{"title":"Puppeteer build extension","sidebarTitle":"puppeteer","href":"/config/extensions/puppeteer"},{"title":"Lightpanda build extension","sidebarTitle":"lightpanda","tag":"v4","href":"/config/extensions/lightpanda"},{"title":"FFmpeg","sidebarTitle":"ffmpeg","href":"/config/extensions/ffmpeg"},{"title":"apt-get","sidebarTitle":"aptGet","href":"/config/extensions/aptGet"},{"title":"Additional Files","sidebarTitle":"additionalFiles","href":"/config/extensions/additionalFiles"},{"title":"Additional Packages","sidebarTitle":"additionalPackages","href":"/config/extensions/additionalPackages"},{"title":"Sync env vars","sidebarTitle":"syncEnvVars","href":"/config/extensions/syncEnvVars"},{"title":"esbuild Plugin","sidebarTitle":"esbuildPlugin","href":"/config/extensions/esbuildPlugin"},{"title":"Emit Decorator Metadata","sidebarTitle":"emitDecoratorMetadata","href":"/config/extensions/emitDecoratorMetadata"},{"title":"Audio Waveform","sidebarTitle":"audioWaveform","href":"/config/extensions/audioWaveform"}]},{"title":"Custom build extensions","sidebarTitle":"Custom","href":"/config/extensions/custom"}]}]},{"group":"Deployment","pages":[{"title":"Deployment","sidebarTitle":"Overview","href":"/deployment/overview"},{"title":"Environment Variables","href":"/deploy-environment-variables"},{"title":"CI / GitHub Actions","href":"/github-actions"},{"title":"Trusted publishing","href":"/deployment/trusted-publishing"},{"title":"Preview branches","href":"/deployment/preview-branches"},{"title":"Development branches","sidebarTitle":"Dev branches","href":"/deployment/dev-branches"},{"title":"Atomic deployments","sidebarTitle":"Atomic deployments","href":"/deployment/atomic-deployment"},{"group":"Deployment integrations","pages":[{"title":"GitHub integration","href":"/github-integration"},{"title":"Vercel integration","href":"/vercel-integration"}]}]},{"group":"Private networking","pages":[{"title":"Private networking","sidebarTitle":"Overview","href":"/private-networking/overview"},{"title":"Setting up PrivateLink in the AWS Console","sidebarTitle":"AWS Console setup","href":"/private-networking/aws-console-setup"},{"title":"Troubleshooting private networking","sidebarTitle":"Troubleshooting","href":"/private-networking/troubleshooting"}]},{"group":"Realtime","pages":[{"title":"Realtime overview","sidebarTitle":"Overview","href":"/realtime/overview"},{"title":"How Realtime works","sidebarTitle":"How it works","href":"/realtime/how-it-works"},{"title":"The run object","sidebarTitle":"The run object","href":"/realtime/run-object"},{"title":"Realtime authentication","sidebarTitle":"Realtime auth","href":"/realtime/auth"},{"group":"React hooks","pages":[{"title":"React hooks for real-time task updates","sidebarTitle":"Overview","href":"/realtime/react-hooks/overview"},{"title":"Trigger tasks from React","sidebarTitle":"Triggering","href":"/realtime/react-hooks/triggering"},{"title":"Run updates in React","sidebarTitle":"Run updates","href":"/realtime/react-hooks/subscribe"},{"title":"Stream data to React (AI, files, progress)","sidebarTitle":"Streaming","href":"/realtime/react-hooks/streams"},{"title":"Read a session channel in React","sidebarTitle":"Session streams","href":"/realtime/react-hooks/session-stream"},{"title":"SWR hooks","sidebarTitle":"SWR","href":"/realtime/react-hooks/swr"},{"title":"useWaitToken","href":"/realtime/react-hooks/use-wait-token"}]},{"group":"Backend","pages":[{"title":"Subscribe to tasks from your backend","sidebarTitle":"Overview","href":"/realtime/backend/overview"},{"title":"Run updates (backend)","sidebarTitle":"Run updates","href":"/realtime/backend/subscribe"},{"title":"Stream data to your backend (AI, files)","sidebarTitle":"Streaming","href":"/realtime/backend/streams"},{"title":"Input Streams","sidebarTitle":"Input Streams","href":"/realtime/backend/input-streams"}]}]},{"group":"CLI","pages":[{"title":"Introduction","href":"/cli-introduction"},{"group":"Commands","pages":[{"title":"CLI deploy command","sidebarTitle":"deploy","href":"/cli-deploy-commands"},{"title":"CLI dev command","sidebarTitle":"dev","href":"/cli-dev-commands"},{"title":"CLI env commands","sidebarTitle":"env","href":"/cli-env-commands"},{"title":"CLI init command","sidebarTitle":"init","href":"/cli-init-commands"},{"title":"CLI list-profiles command","sidebarTitle":"list-profiles","href":"/cli-list-profiles-commands"},{"title":"CLI login command","sidebarTitle":"login","href":"/cli-login-commands"},{"title":"CLI logout command","sidebarTitle":"logout","href":"/cli-logout-commands"},{"title":"CLI preview archive command","sidebarTitle":"preview archive","href":"/cli-preview-archive"},{"title":"CLI projects commands","sidebarTitle":"projects","href":"/cli-projects-commands"},{"title":"CLI promote command","sidebarTitle":"promote","href":"/cli-promote-commands"},{"title":"CLI runs commands","sidebarTitle":"runs","href":"/cli-runs-commands"},{"title":"CLI switch command","sidebarTitle":"switch","href":"/cli-switch"},{"title":"CLI tasks commands","sidebarTitle":"tasks","href":"/cli-tasks-commands"},{"title":"CLI update command","sidebarTitle":"update","href":"/cli-update-commands"},{"title":"CLI webhooks commands","sidebarTitle":"webhooks","href":"/cli-webhooks-commands"},{"title":"CLI whoami command","sidebarTitle":"whoami","href":"/cli-whoami-commands"}]}]},{"group":"Observability","pages":[{"title":"Query","href":"/observability/query"},{"title":"Dashboards","href":"/observability/dashboards"},{"title":"Project health report","sidebarTitle":"Health report","href":"/reports"}]},{"group":"Using the Dashboard","pages":[{"title":"Run tests","href":"/run-tests"},{"title":"Alerts","href":"/troubleshooting-alerts"},{"title":"Billing limits and alerts","sidebarTitle":"Billing limits \u0026 alerts","href":"/billing-limits"},{"title":"Replaying","href":"/replaying"},{"title":"Bulk actions in the dashboard","sidebarTitle":"Bulk actions","href":"/bulk-actions"}]},{"group":"Troubleshooting","pages":[{"title":"Common problems","href":"/troubleshooting"},{"title":"Database connections","sidebarTitle":"Database connections","href":"/database-connections"},{"title":"How to reduce your spend","href":"/how-to-reduce-your-spend"},{"title":"Debugging in VS Code","sidebarTitle":"Debugging in VS Code","href":"/troubleshooting-debugging-in-vscode"},{"title":"How to upgrade the Trigger.dev packages","sidebarTitle":"Upgrading packages","href":"/upgrading-packages"},{"title":"Zod","href":"/troubleshooting-zod"},{"title":"Uptime Status","href":"/troubleshooting-uptime-status"},{"title":"GitHub Issues","url":"https://github.com/triggerdotdev/trigger.dev/issues","href":"/troubleshooting-github-issues"},{"title":"Request a feature","url":"https://feedback.trigger.dev/","href":"/request-feature"}]},{"group":"Self-hosting","pages":[{"title":"Self-hosting overview","sidebarTitle":"Overview","href":"/self-hosting/overview"},{"title":"Docker compose","href":"/self-hosting/docker"},{"title":"Kubernetes","href":"/self-hosting/kubernetes"},{"title":"Security \u0026 vulnerability reporting","sidebarTitle":"Security","href":"/self-hosting/security"},{"group":"Environment variables","pages":[{"title":"Webapp","sidebarTitle":"Webapp","mode":"wide","href":"/self-hosting/env/webapp"},{"title":"Supervisor","sidebarTitle":"Supervisor","mode":"wide","href":"/self-hosting/env/supervisor"}]}]},{"group":"Open source","pages":[{"title":"Contributing","href":"/open-source-contributing"},{"title":"GitHub repo","url":"https://github.com/triggerdotdev/trigger.dev","href":"/github-repo"},{"title":"Changelog","url":"https://trigger.dev/changelog","href":"/changelog"},{"title":"Roadmap","url":"https://feedback.trigger.dev/roadmap","href":"/roadmap"}]},{"group":"Help","pages":[{"title":"Discord Community","url":"https://trigger.dev/discord","href":"/community"},{"title":"Slack support","href":"/help-slack"},{"title":"Email us","url":"https://trigger.dev/contact","href":"/help-email"}]}]},{"dropdown":"API reference","icon":"code","description":"The Trigger.dev API","groups":[{"group":"API reference","pages":[{"title":"Management API overview","sidebarTitle":"Overview","href":"/management/overview"},{"title":"Authentication","sidebarTitle":"Authentication","href":"/management/authentication"},{"title":"Multiple SDK clients","sidebarTitle":"Multiple SDK clients","href":"/management/multiple-clients"},{"title":"Errors and retries","sidebarTitle":"Errors and retries","href":"/management/errors-and-retries"},{"title":"Auto-pagination","sidebarTitle":"Auto-pagination","href":"/management/auto-pagination"},{"title":"Advanced usage","sidebarTitle":"Advanced usage","href":"/management/advanced-usage"}]},{"group":"Tasks API","pages":[{"title":"Trigger","openapi":"v3-openapi POST /api/v1/tasks/{taskIdentifier}/trigger","href":"/management/tasks/trigger"},{"title":"Batch trigger","openapi":"v3-openapi POST /api/v1/tasks/batch","href":"/management/tasks/batch-trigger"},{"title":"Trigger task batch","openapi":"v3-openapi POST /api/v1/tasks/{taskIdentifier}/batch","href":"/management/tasks/trigger-batch"}]},{"group":"Batches API","pages":[{"title":"Create batch","openapi":"openapi POST /api/v3/batches","href":"/management/batches/create"},{"title":"Retrieve a batch","openapi":"v3-openapi GET /api/v1/batches/{batchId}","href":"/management/batches/retrieve"},{"title":"Retrieve batch results","openapi":"v3-openapi GET /api/v1/batches/{batchId}/results","href":"/management/batches/retrieve-results"},{"title":"Stream batch items","openapi":"openapi POST /api/v3/batches/{batchId}/items","href":"/management/batches/stream-items"}]},{"group":"Runs API","pages":[{"title":"List runs","openapi":"v3-openapi GET /api/v1/runs","href":"/management/runs/list"},{"title":"Retrieve run","openapi":"v3-openapi GET /api/v3/runs/{runId}","href":"/management/runs/retrieve"},{"title":"Replay run","openapi":"v3-openapi POST /api/v1/runs/{runId}/replay","href":"/management/runs/replay"},{"title":"Cancel run","openapi":"v3-openapi POST /api/v2/runs/{runId}/cancel","href":"/management/runs/cancel"},{"title":"Reschedule run","openapi":"v3-openapi POST /api/v1/runs/{runId}/reschedule","href":"/management/runs/reschedule"},{"title":"Update metadata","openapi":"v3-openapi PUT /api/v1/runs/{runId}/metadata","href":"/management/runs/update-metadata"},{"title":"Add tags to a run","openapi":"v3-openapi POST /api/v1/runs/{runId}/tags","href":"/management/runs/add-tags"},{"title":"Retrieve run events","openapi":"v3-openapi GET /api/v1/runs/{runId}/events","href":"/management/runs/retrieve-events"},{"title":"Retrieve run trace","openapi":"v3-openapi GET /api/v1/runs/{runId}/trace","href":"/management/runs/retrieve-trace"},{"title":"Retrieve run result","openapi":"v3-openapi GET /api/v1/runs/{runId}/result","href":"/management/runs/retrieve-result"}]},{"group":"Bulk actions API","pages":[{"title":"Create bulk action","openapi":"v3-openapi POST /api/v1/bulk-actions","href":"/management/bulk-actions/create"},{"title":"List bulk actions","openapi":"v3-openapi GET /api/v1/bulk-actions","href":"/management/bulk-actions/list"},{"title":"Retrieve bulk action","openapi":"v3-openapi GET /api/v1/bulk-actions/{bulkActionId}","href":"/management/bulk-actions/retrieve"},{"title":"Abort bulk action","openapi":"v3-openapi POST /api/v1/bulk-actions/{bulkActionId}/abort","description":"Abort a pending bulk action so it stops processing additional runs. Runs already processed by the action are not undone.","href":"/management/bulk-actions/abort"}]},{"group":"Alerts API","pages":[{"title":"Create an alert","api":"POST https://api.trigger.dev/api/v1/projects/{projectRef}/monitoring-alerts","href":"/management/alerts/create"}]},{"group":"Errors API","pages":[{"title":"List errors","openapi":"v3-openapi GET /api/v1/errors","description":"List error groups in a specific environment. Runs that fail are grouped by a fingerprint derived from the error type, message, and stack trace. Filter by task identifier, version, status, search text, and time range.\n","href":"/management/errors/list"},{"title":"Retrieve an error","openapi":"v3-openapi GET /api/v1/errors/{errorId}","href":"/management/errors/retrieve"},{"title":"Resolve an error","openapi":"v3-openapi POST /api/v1/errors/{errorId}/resolve","href":"/management/errors/resolve"},{"title":"Ignore an error","openapi":"v3-openapi POST /api/v1/errors/{errorId}/ignore","href":"/management/errors/ignore"},{"title":"Unresolve an error","openapi":"v3-openapi POST /api/v1/errors/{errorId}/unresolve","href":"/management/errors/unresolve"}]},{"group":"Webhooks API","pages":[{"title":"List webhook endpoints","openapi":"v3-openapi GET /api/v1/webhooks/endpoints","href":"/management/webhooks/list-endpoints"},{"title":"Retrieve a webhook endpoint","openapi":"v3-openapi GET /api/v1/webhooks/endpoints/{endpointId}","href":"/management/webhooks/retrieve-endpoint"},{"title":"Enable a webhook endpoint","openapi":"v3-openapi POST /api/v1/webhooks/endpoints/{endpointId}/enable","href":"/management/webhooks/enable-endpoint"},{"title":"Disable a webhook endpoint","openapi":"v3-openapi POST /api/v1/webhooks/endpoints/{endpointId}/disable","href":"/management/webhooks/disable-endpoint"},{"title":"Generate a webhook signing secret","openapi":"v3-openapi POST /api/v1/webhooks/endpoints/{endpointId}/rotate-secret","href":"/management/webhooks/generate-secret"},{"title":"Set a webhook signing secret","openapi":"v3-openapi PUT /api/v1/webhooks/endpoints/{endpointId}/secret","href":"/management/webhooks/set-secret"},{"title":"List webhook deliveries","openapi":"v3-openapi GET /api/v1/webhooks/deliveries","href":"/management/webhooks/list-deliveries"},{"title":"Retrieve a webhook delivery","openapi":"v3-openapi GET /api/v1/webhooks/deliveries/{deliveryId}","href":"/management/webhooks/retrieve-delivery"},{"title":"Replay a webhook delivery","openapi":"v3-openapi POST /api/v1/webhooks/deliveries/{deliveryId}/replay","href":"/management/webhooks/replay-delivery"},{"title":"Create a webhook waiter","openapi":"v3-openapi POST /api/v1/webhooks/endpoints/{endpointId}/waiters","href":"/management/webhooks/create-waiter"},{"title":"Cancel a webhook waiter","openapi":"v3-openapi POST /api/v1/webhooks/waiters/{waiterId}/cancel","href":"/management/webhooks/cancel-waiter"}]},{"group":"Queues API","pages":[{"title":"List Queues","openapi":"v3-openapi GET /api/v1/queues","href":"/management/queues/list"},{"title":"Retrieve Queue","openapi":"v3-openapi GET /api/v1/queues/{queueParam}","href":"/management/queues/retrieve"},{"title":"Pause or Resume Queue","openapi":"v3-openapi POST /api/v1/queues/{queueParam}/pause","href":"/management/queues/pause"},{"title":"Override Concurrency Limit","openapi":"v3-openapi POST /api/v1/queues/{queueParam}/concurrency/override","href":"/management/queues/concurrency-override"},{"title":"Reset Concurrency Limit","openapi":"v3-openapi POST /api/v1/queues/{queueParam}/concurrency/reset","href":"/management/queues/concurrency-reset"}]},{"group":"Concurrency limits API","pages":[{"title":"List Concurrency Limits","openapi":"v3-openapi GET /api/v1/concurrency-limits","href":"/management/concurrency-limits/list"},{"title":"Retrieve Concurrency Limit","openapi":"v3-openapi GET /api/v1/concurrency-limits/{name}","href":"/management/concurrency-limits/retrieve"},{"title":"Pause or Resume Concurrency Limit","openapi":"v3-openapi POST /api/v1/concurrency-limits/{name}/pause","href":"/management/concurrency-limits/pause"},{"title":"Override Concurrency Limit","openapi":"v3-openapi POST /api/v1/concurrency-limits/{name}/override","href":"/management/concurrency-limits/override"},{"title":"Reset Concurrency Limit","openapi":"v3-openapi POST /api/v1/concurrency-limits/{name}/reset","href":"/management/concurrency-limits/reset"}]},{"group":"Schedules API","pages":[{"title":"List Schedules","openapi":"v3-openapi GET /api/v1/schedules","href":"/management/schedules/list"},{"title":"Create Schedule","openapi":"v3-openapi POST /api/v1/schedules","href":"/management/schedules/create"},{"title":"Retrieve Schedule","openapi":"v3-openapi GET /api/v1/schedules/{schedule_id}","href":"/management/schedules/retrieve"},{"title":"Update Schedule","openapi":"v3-openapi PUT /api/v1/schedules/{schedule_id}","href":"/management/schedules/update"},{"title":"Delete Schedule","openapi":"v3-openapi DELETE /api/v1/schedules/{schedule_id}","href":"/management/schedules/delete"},{"title":"Deactivate Schedule","openapi":"v3-openapi POST /api/v1/schedules/{schedule_id}/deactivate","href":"/management/schedules/deactivate"},{"title":"Activate Schedule","openapi":"v3-openapi POST /api/v1/schedules/{schedule_id}/activate","href":"/management/schedules/activate"},{"title":"Get timezones","openapi":"v3-openapi GET /api/v1/timezones","href":"/management/schedules/timezones"}]},{"group":"Env Vars API","pages":[{"title":"List Env Vars","openapi":"v3-openapi GET /api/v1/projects/{projectRef}/envvars/{env}","href":"/management/envvars/list"},{"title":"Import Env Vars","openapi":"v3-openapi POST /api/v1/projects/{projectRef}/envvars/{env}/import","href":"/management/envvars/import"},{"title":"Create Env Var","openapi":"v3-openapi POST /api/v1/projects/{projectRef}/envvars/{env}","href":"/management/envvars/create"},{"title":"Retrieve Env Var","openapi":"v3-openapi GET /api/v1/projects/{projectRef}/envvars/{env}/{name}","href":"/management/envvars/retrieve"},{"title":"Update Env Var","openapi":"v3-openapi PUT /api/v1/projects/{projectRef}/envvars/{env}/{name}","href":"/management/envvars/update"},{"title":"Delete Env Var","openapi":"v3-openapi DELETE /api/v1/projects/{projectRef}/envvars/{env}/{name}","href":"/management/envvars/delete"}]},{"group":"Deployments API","pages":[{"title":"List deployments","openapi":"v3-openapi GET /api/v1/deployments","href":"/management/deployments/list"},{"title":"Get deployment","openapi":"v3-openapi GET /api/v1/deployments/{deploymentId}","href":"/management/deployments/retrieve"},{"title":"Get latest deployment","openapi":"v3-openapi GET /api/v1/deployments/latest","href":"/management/deployments/get-latest"},{"title":"Promote deployment","openapi":"v3-openapi POST /api/v1/deployments/{version}/promote","href":"/management/deployments/promote"}]},{"group":"Waitpoints API","pages":[{"title":"Create a waitpoint token","openapi":"v3-openapi POST /api/v1/waitpoints/tokens","href":"/management/waitpoints/create"},{"title":"List waitpoint tokens","openapi":"v3-openapi GET /api/v1/waitpoints/tokens","href":"/management/waitpoints/list"},{"title":"Retrieve a waitpoint token","openapi":"v3-openapi GET /api/v1/waitpoints/tokens/{waitpointId}","href":"/management/waitpoints/retrieve"},{"title":"Complete a waitpoint token","openapi":"v3-openapi POST /api/v1/waitpoints/tokens/{waitpointId}/complete","href":"/management/waitpoints/complete"},{"title":"Complete a waitpoint token via HTTP callback","openapi":"v3-openapi POST /api/v1/waitpoints/tokens/{waitpointId}/callback/{callbackHash}","href":"/management/waitpoints/complete-callback"}]},{"group":"Sessions API","pages":[{"title":"Create session","openapi":"v3-openapi POST /api/v1/sessions","href":"/management/sessions/create"},{"title":"List sessions","openapi":"v3-openapi GET /api/v1/sessions","href":"/management/sessions/list"},{"title":"Retrieve session","openapi":"v3-openapi GET /api/v1/sessions/{session}","href":"/management/sessions/retrieve"},{"title":"Update session","openapi":"v3-openapi PATCH /api/v1/sessions/{session}","href":"/management/sessions/update"},{"title":"Close session","openapi":"v3-openapi POST /api/v1/sessions/{session}/close","href":"/management/sessions/close"},{"title":"Session channels","sidebarTitle":"Channels","href":"/management/sessions/channels"}]},{"group":"Query API","pages":[{"title":"Execute a query","openapi":"v3-openapi POST /api/v1/query","href":"/management/query/execute"},{"title":"Get query schema","openapi":"v3-openapi GET /api/v1/query/schema","href":"/management/query/schema"},{"title":"List dashboards","openapi":"v3-openapi GET /api/v1/query/dashboards","href":"/management/query/dashboards"},{"title":"Create dashboard","openapi":"v3-openapi POST /api/v1/query/dashboards","href":"/management/query/create-dashboard"},{"title":"Retrieve dashboard","openapi":"v3-openapi GET /api/v1/query/dashboards/{dashboardId}","href":"/management/query/retrieve-dashboard"},{"title":"Update dashboard","openapi":"v3-openapi PATCH /api/v1/query/dashboards/{dashboardId}","href":"/management/query/update-dashboard"},{"title":"Replace dashboard widgets","openapi":"v3-openapi PUT /api/v1/query/dashboards/{dashboardId}","href":"/management/query/replace-dashboard"},{"title":"Delete dashboard","openapi":"v3-openapi DELETE /api/v1/query/dashboards/{dashboardId}","href":"/management/query/delete-dashboard"},{"title":"Add dashboard widget","openapi":"v3-openapi POST /api/v1/query/dashboards/{dashboardId}/widgets","href":"/management/query/add-dashboard-widget"},{"title":"Update dashboard widget","openapi":"v3-openapi PATCH /api/v1/query/dashboards/{dashboardId}/widgets/{widgetId}","href":"/management/query/update-dashboard-widget"},{"title":"Delete dashboard widget","openapi":"v3-openapi DELETE /api/v1/query/dashboards/{dashboardId}/widgets/{widgetId}","href":"/management/query/delete-dashboard-widget"}]}]},{"dropdown":"Guides \u0026 examples","icon":"books","description":"A great way to get started","groups":[{"group":"Introduction","pages":[{"title":"Frameworks, guides and examples","sidebarTitle":"Overview","mode":"center","href":"/guides/introduction"}]},{"group":"Frameworks","pages":[{"title":"Bun guide","sidebarTitle":"Bun","icon":"js","href":"/guides/frameworks/bun"},{"title":"Next.js setup guide","sidebarTitle":"Next.js","icon":"N","href":"/guides/frameworks/nextjs"},{"title":"Node.js setup guide","sidebarTitle":"Node.js","icon":"node-js","href":"/guides/frameworks/nodejs"},{"title":"Remix setup guide","sidebarTitle":"Remix","icon":"r","href":"/guides/frameworks/remix"},{"title":"Custom webhook handler with Next.js","sidebarTitle":"Custom webhook handler with Next.js","href":"/guides/frameworks/nextjs-webhooks"},{"title":"Custom webhook handler with Remix","sidebarTitle":"Custom webhook handler with Remix","href":"/guides/frameworks/remix-webhooks"},{"title":"SvelteKit setup guide","sidebarTitle":"SvelteKit","icon":"s","href":"/guides/community/sveltekit"}]},{"group":"Guides","pages":[{"group":"AI Agents","icon":{"style":"regular","name":"microchip-ai"},"pages":[{"title":"AI agents overview","sidebarTitle":"Overview","href":"/guides/ai-agents/overview"},{"title":"Build a chat agent","sidebarTitle":"Chat agent","href":"/guides/ai-agents/chat-agent"},{"title":"Generate and translate copy","sidebarTitle":"Generate \u0026 translate copy","href":"/guides/ai-agents/generate-translate-copy"},{"title":"Route a question to a different AI model","sidebarTitle":"Route a question","href":"/guides/ai-agents/route-question"},{"title":"Respond to customer inquiry and check for inappropriate content","sidebarTitle":"Respond \u0026 check content","href":"/guides/ai-agents/respond-and-check-content"},{"title":"Translate text and refine it based on feedback","sidebarTitle":"Translate and refine","href":"/guides/ai-agents/translate-and-refine"},{"title":"Verify a news article","sidebarTitle":"Verify news article","href":"/guides/ai-agents/verify-news-article"}]},{"title":"Claude Agent SDK setup guide","sidebarTitle":"Claude Agent SDK","icon":"sparkles","href":"/guides/ai-agents/claude-code-trigger"},{"title":"Drizzle setup guide","sidebarTitle":"Drizzle setup guide","icon":"D","href":"/guides/frameworks/drizzle"},{"title":"Prisma setup guide","sidebarTitle":"Prisma setup guide","icon":"Triangle","href":"/guides/frameworks/prisma"},{"title":"Nango OAuth with Trigger.dev","sidebarTitle":"Nango OAuth guide","icon":"key","href":"/guides/frameworks/nango"},{"title":"Sequin database triggers","sidebarTitle":"Sequin database triggers","icon":"database","href":"/guides/frameworks/sequin"},{"group":"Supabase","icon":{"style":"solid","name":"bolt"},"pages":[{"title":"Supabase overview","sidebarTitle":"Overview","href":"/guides/frameworks/supabase-guides-overview"},{"title":"Triggering tasks from Supabase edge functions","sidebarTitle":"Edge function hello world","href":"/guides/frameworks/supabase-edge-functions-basic"},{"title":"Triggering tasks from Supabase Database Webhooks","sidebarTitle":"Database webhooks","href":"/guides/frameworks/supabase-edge-functions-database-webhooks"},{"title":"Authenticating Supabase tasks: JWTs and service roles","sidebarTitle":"Supabase authentication","href":"/guides/frameworks/supabase-authentication"}]}]},{"group":"Migration guides","pages":[{"title":"Migrating from v3","href":"/migrating-from-v3"},{"title":"Migrating from Mergent","sidebarTitle":"Migrating from Mergent","href":"/migration-mergent"},{"title":"Migrating from n8n","sidebarTitle":"Migrating from n8n","href":"/migration-n8n"}]},{"group":"Use cases","pages":[{"title":"Use cases","sidebarTitle":"Overview","href":"/guides/use-cases/overview"},{"title":"Data processing \u0026 ETL workflows","sidebarTitle":"Data processing \u0026 ETL","href":"/guides/use-cases/data-processing-etl"},{"title":"AI media generation workflows","sidebarTitle":"AI media generation","href":"/guides/use-cases/media-generation"},{"title":"Media processing workflows","sidebarTitle":"Media processing","href":"/guides/use-cases/media-processing"},{"title":"Marketing workflows","sidebarTitle":"Marketing","href":"/guides/use-cases/marketing"}]},{"group":"Example projects","pages":[{"title":"Automated website monitoring with Anchor Browser","sidebarTitle":"Anchor Browser web scraper","href":"/guides/example-projects/anchor-browser-web-scraper"},{"title":"Ask Trigger chat agent","sidebarTitle":"Ask Trigger chat agent","href":"/guides/example-projects/ask-trigger-chat-agent"},{"title":"Next.js Batch LLM Evaluator","sidebarTitle":"Batch LLM Evaluator","href":"/guides/example-projects/batch-llm-evaluator"},{"title":"Changelog generator using Claude Agent SDK","sidebarTitle":"Claude changelog generator","href":"/guides/example-projects/claude-changelog-generator"},{"title":"Claude GitHub wiki","sidebarTitle":"Claude GitHub wiki","href":"/guides/example-projects/claude-github-wiki"},{"title":"Claude 3.7 thinking chatbot","sidebarTitle":"Claude thinking chatbot","href":"/guides/example-projects/claude-thinking-chatbot"},{"title":"ClickHouse chat agent","sidebarTitle":"ClickHouse chat agent","href":"/guides/example-projects/clickhouse-chat-agent"},{"title":"Background Cursor agent using the Cursor CLI","sidebarTitle":"Cursor background agent","href":"/guides/example-projects/cursor-background-agent"},{"title":"ElevenLabs Voice agent","sidebarTitle":"ElevenLabs Voice agent","href":"/guides/example-projects/elevenlabs-voice-agent"},{"title":"How to trigger an AI agent from a new Granola note","sidebarTitle":"Granola meeting agent","href":"/guides/example-projects/granola-meeting-agent"},{"title":"Grok AI Teammates: chat agents with their own cloud computer","sidebarTitle":"Grok AI Teammates","href":"/guides/example-projects/grok-ai-teammates"},{"title":"Human-in-the-loop workflow with ReactFlow and Trigger.dev waitpoint tokens","sidebarTitle":"Human-in-the-loop workflow","href":"/guides/example-projects/human-in-the-loop-workflow"},{"title":"Mastra agents with memory sharing + Trigger.dev task orchestration","sidebarTitle":"Mastra agents with memory","href":"/guides/example-projects/mastra-agents-with-memory"},{"title":"Meme generator with human-in-the-loop approval","sidebarTitle":"AI meme generator","href":"/guides/example-projects/meme-generator-human-in-the-loop"},{"title":"OpenAI Agents SDK for Typescript + Trigger.dev playground","sidebarTitle":"OpenAI Agents SDK for Typescript playground","href":"/guides/example-projects/openai-agents-sdk-typescript-playground"},{"title":"Product image generator using Replicate and Trigger.dev","sidebarTitle":"Product image generator","href":"/guides/example-projects/product-image-generator"},{"title":"Next.js Realtime CSV Importer","sidebarTitle":"Realtime CSV Importer","href":"/guides/example-projects/realtime-csv-importer"},{"title":"Image generation with Fal.ai and Trigger.dev Realtime","sidebarTitle":"Realtime image gen with Fal.ai","href":"/guides/example-projects/realtime-fal-ai"},{"title":"How to connect Trigger.dev AI agents with Recall.ai meeting agents","sidebarTitle":"Recall.ai meeting agent","href":"/guides/example-projects/recall-meeting-agent"},{"title":"Resend email agent with Slack approval","sidebarTitle":"Resend email agent","href":"/guides/example-projects/resend-email-agent"},{"title":"Smart Spreadsheet","sidebarTitle":"Smart Spreadsheet","href":"/guides/example-projects/smart-spreadsheet"},{"title":"Turborepo monorepo with Prisma","sidebarTitle":"Turborepo monorepo with Prisma","href":"/guides/example-projects/turborepo-monorepo-prisma"},{"title":"Deep research agent using Vercel's AI SDK","sidebarTitle":"Deep research agent","href":"/guides/example-projects/vercel-ai-sdk-deep-research"},{"title":"Vercel AI SDK image generator","sidebarTitle":"Vercel AI SDK image generator","href":"/guides/example-projects/vercel-ai-sdk-image-generator"}]},{"group":"Python guides","pages":[{"title":"OpenAI Agents SDK for Python guardrails","sidebarTitle":"OpenAI Agents SDK for Python guardrails","href":"/guides/example-projects/openai-agent-sdk-guardrails"},{"title":"Python image processing example","sidebarTitle":"Process images","href":"/guides/python/python-image-processing"},{"title":"Convert documents to markdown using Python and MarkItDown","sidebarTitle":"Convert docs to markdown","href":"/guides/python/python-doc-to-markdown"},{"title":"Python headless browser web crawler example","sidebarTitle":"Headless web crawler","href":"/guides/python/python-crawl4ai"},{"title":"Python PDF form extractor example","sidebarTitle":"Extract form data from PDFs","href":"/guides/python/python-pdf-form-extractor"}]},{"group":"Example tasks","pages":[{"title":"Generate an image using DALL·E 3","sidebarTitle":"DALL·E image generation","href":"/guides/examples/dall-e3-generate-image"},{"title":"Transcribe audio using Deepgram","sidebarTitle":"Deepgram audio transcription","href":"/guides/examples/deepgram-transcribe-audio"},{"title":"Convert an image to a cartoon using Fal.ai","sidebarTitle":"Fal.ai image to cartoon","href":"/guides/examples/fal-ai-image-to-cartoon"},{"title":"Generate an image from a prompt using Fal.ai and Trigger.dev Realtime","sidebarTitle":"Fal.ai with Realtime","href":"/guides/examples/fal-ai-realtime"},{"title":"Video processing with FFmpeg","sidebarTitle":"FFmpeg video processing","href":"/guides/examples/ffmpeg-video-processing"},{"title":"Crawl a URL using Firecrawl","sidebarTitle":"Firecrawl URL crawl","href":"/guides/examples/firecrawl-url-crawl"},{"title":"Lightpanda examples with Trigger.dev","sidebarTitle":"Lightpanda","tag":"v4","href":"/guides/examples/lightpanda"},{"title":"Convert documents to PDF using LibreOffice","sidebarTitle":"LibreOffice PDF conversion","href":"/guides/examples/libreoffice-pdf-conversion"},{"title":"Call OpenAI with retrying","sidebarTitle":"OpenAI with retrying","href":"/guides/examples/open-ai-with-retrying"},{"title":"Turn a PDF into an image using MuPDF","sidebarTitle":"PDF to image","href":"/guides/examples/pdf-to-image"},{"title":"Connect to a private GCP resource from a deployed task","sidebarTitle":"Private GCP resource","href":"/guides/examples/private-gcp-resource"},{"title":"Puppeteer examples with Trigger.dev","sidebarTitle":"Puppeteer","href":"/guides/examples/puppeteer"},{"title":"Generate a PDF using react-pdf and save it to R2","sidebarTitle":"React to PDF","href":"/guides/examples/react-pdf"},{"title":"Send emails using React Email","sidebarTitle":"React Email","href":"/guides/examples/react-email"},{"title":"Image-to-image generation using Replicate and nano-banana","sidebarTitle":"Replicate image generation","href":"/guides/examples/replicate-image-generation"},{"title":"Send a sequence of emails using Resend","sidebarTitle":"Resend email sequence","href":"/guides/examples/resend-email-sequence"},{"title":"Generate OG Images using Satori","sidebarTitle":"Satori OG Images","href":"/guides/examples/satori"},{"title":"Scrape the top 3 articles from Hacker News and email yourself a summary every weekday","sidebarTitle":"Browserbase \u0026 Puppeteer","href":"/guides/examples/scrape-hacker-news"},{"title":"Track errors with Sentry","sidebarTitle":"Sentry error tracking","href":"/guides/examples/sentry-error-tracking"},{"title":"Process images using Sharp","sidebarTitle":"Sharp image processing","href":"/guides/examples/sharp-image-processing"},{"title":"Supabase database operations using Trigger.dev","sidebarTitle":"Supabase database operations","href":"/guides/examples/supabase-database-operations"},{"title":"Uploading files to Supabase Storage","sidebarTitle":"Supabase Storage upload","href":"/guides/examples/supabase-storage-upload"},{"title":"Using the Vercel AI SDK","sidebarTitle":"Vercel AI SDK","href":"/guides/examples/vercel-ai-sdk"},{"title":"Syncing environment variables from your Vercel projects","sidebarTitle":"Vercel sync env vars","href":"/guides/examples/vercel-sync-env-vars"}]},{"group":"Community packages","pages":[{"title":"dotenvx","sidebarTitle":"dotenvx","icon":"square-e","href":"/guides/community/dotenvx"},{"title":"Fatima","sidebarTitle":"Fatima","icon":"f","href":"/guides/community/fatima"},{"title":"Rate limiter","sidebarTitle":"Rate limiter","icon":"gauge-simple-low","href":"/guides/community/rate-limiter"},{"title":"SvelteKit setup guide","sidebarTitle":"SvelteKit","icon":"s","href":"/guides/community/sveltekit"}]}]}]},"basePath":"","title":"Create an alert - Trigger.dev","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":["c2aa737661","b0f84f53ff","2b790eda92"],"chunks":["OpenApiReferenceProvider-Ku9dSkH0.js","snippetPresets-Cjez4eet.js","utils-BqNa-fnS.js","style-to-object-BY3JEAdk.js","utils-DiE92JCe.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-Bi0DpqVf.js","conditional-requirements-CFM0id0Q.js","cloneDeep-C6xnxscF.js","_Uint8Array-B7g0OYAt.js","isObject-FP1Yky1u.js","Page--B9YZ09u.js","CodeSnippet-CTZvgJfu.js","DynamicMarkdown-CsgNpZb1.js","SectionHeading-C3K437Dy.js","icon-DlxjjqnB.js","ApiExamples-Bf8Ecb5t.js","usePlaygroundInputsStore-BA942cq6.js","shallow-D0sePNkF.js","isEqual-CnnQO8sL.js","CodeSnippets-BTANoy1T.js","getApiPlaygroundDisplay-BK2o1XYu.js","MethodPill-Cr7Ib9nN.js","getPastedJson-DXo3wtHt.js","Check2Icon-ChEI-f_B.js","axios-CsQoIw0U.js"]}