Adds a usage alert, which is to email its recipients when your team’s usage crosses its trigger, at most once a UTC day, or once a billing period for overage and budget_percent.
It is recorded in your team’s audit log. Each goes to the address the recipient signs in with.
Owners and Admins only. An API key needs team:manage.
trigger: calls (in a UTC day), included_calls_percent (of the day’s included calls), overage (cents of overage in the billing period), budget_percent (of the overage budget) or cap_reached. Percentages are 1 to 1000.
recipients: roles, everyone in them when it sends, and member_ids, verified members of your team (members who have joined it). At least one. Alerts in dollars (overage, budget_percent) email only the Owners and Admins among them.
A team keeps up to 50 alerts.
Callers: an API key, an MCP OAuth token or a Dashboard session.
Permission:team:manage; an API key also needs team:manage.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
trigger
object
required
What sets it off: calls or included_calls_percent each UTC day, overage or budget_percent (dollars, Owners and Admins only) each billing period, or cap_reached when the daily cap refuses runs
Option 1
Option 2
Option 3
Option 4
Option 5
Show child attributes
recipients
object
required
At least one role or member
Show child attributes
on
boolean
Default true
Response
The alert
id
string
required
trigger
object
required
What sets it off: calls or included_calls_percent each UTC day, overage or budget_percent (dollars, Owners and Admins only) each billing period, or cap_reached when the daily cap refuses runs
Option 1
Option 2
Option 3
Option 4
Option 5
Show child attributes
window
enum<string>
required
It is emailed at most once in each: a UTC day, or a billing period
Available options:
day,
billing_period
on
boolean
required
recipients
object
required
Show child attributes
on_changed_at
string
required
When it was created, or last turned on or off
last_sent_at
string | null
required
ISO 8601 UTC
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Pomerado","description":"Fast, reliable tools for websites, for AI agents and programs: an MCP server and a REST API.","colors":{"primary":"#c71f3e","light":"#f04a5f","dark":"#a81734"},"logo":{"light":"https://mintcdn.com/pomerado/MWnuKCF6pT3dH-IM/logo/light.svg?fit=max\u0026auto=format\u0026n=MWnuKCF6pT3dH-IM\u0026q=85\u0026s=b1723a79805dcc9e0c0982901abf76fd","dark":"https://mintcdn.com/pomerado/MWnuKCF6pT3dH-IM/logo/dark.svg?fit=max\u0026auto=format\u0026n=MWnuKCF6pT3dH-IM\u0026q=85\u0026s=e91dd44a93eff07c2e368db999756f98","href":"https://pomerado.ai"},"favicon":"https://mintcdn.com/pomerado/MWnuKCF6pT3dH-IM/logo/favicon.png?fit=max\u0026auto=format\u0026n=MWnuKCF6pT3dH-IM\u0026q=85\u0026s=78a3bf5220c92811101e80f0f1c2708a","api":{"examples":{"languages":["curl","javascript","python"]}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"pomerado","hasAudioNarration":false,"actualSubdomain":"pomerado","customDomains":["docs.pomerado.ai"],"gitSource":{"type":"github","owner":"pomerado","repo":"pomerado-docs","deployBranch":"main","contentDirectory":"public-docs","isPrivate":true,"mountPath":"","label":"","_id":"6af0f181ddecdf8794c0cadb"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af97af859fc4106fcc4e0ad","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"API reference","count":134},{"language":"default","tag":"Docs","count":51},{"language":"default","tag":"Guides","count":41},{"language":"default","tag":"Tools and integrations","count":25},{"language":"default","tag":"MCP reference","count":18},{"language":"default","tag":"Pomerado MCP","count":16},{"language":"default","tag":"Jobs","count":12},{"language":"default","tag":"Payer profiles","count":11},{"language":"default","tag":"Saved logins","count":10},{"language":"default","tag":"Team","count":10}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","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":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/usage_alerts/add-a-usage-alert","slug":"/api-reference/usage_alerts/add-a-usage-alert","pageMetadata":{"title":"Add a usage alert","description":"Adds a usage alert, which is to email its recipients when your team's usage crosses its trigger, at most once a UTC day, or once a billing period for overage and budget_percent.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/usage/alerts","href":"/api-reference/usage_alerts/add-a-usage-alert","autogeneratedByOpenApi":true},"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: \"Adds a usage alert, which is to email its recipients when your team’s usage crosses its trigger, at most once a UTC day, or once a billing period for overage and budget_percent.\"\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{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Accordion}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);return _jsxs(Accordion,{title:`Details`,id:`details`,children:[_jsx(_components.p,{children:`It is recorded in your team’s audit log. Each goes to the address the recipient signs in with.`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Owners and Admins only. An API key needs team:manage.`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`trigger: calls (in a UTC day), included_calls_percent (of the day’s included calls), overage (cents of overage in the billing period), budget_percent (of the overage budget) or cap_reached. Percentages are 1 to 1000.`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`recipients: roles, everyone in them when it sends, and member_ids, verified members of your team (members who have joined it). At least one. Alerts in dollars (overage, budget_percent) email only the Owners and Admins among them.`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`A team keeps up to 50 alerts.`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Callers:`}),` an API key, an MCP OAuth token or a Dashboard session.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Permission:`}),` `,_jsx(_components.code,{children:`team:manage`}),`; an API key also needs `,_jsx(_components.code,{children:`team:manage`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Effect:`}),` Creates or changes something.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Errors:`}),` `,_jsx(_components.a,{href:`/errors#business_account_required`,children:_jsx(_components.code,{children:`business_account_required`})}),`, `,_jsx(_components.a,{href:`/errors#role_permission_missing`,children:_jsx(_components.code,{children:`role_permission_missing`})}),`, and the `,_jsx(_components.a,{href:`/errors`,children:`errors any request can get`}),`.`]}),`\n`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Add a usage alert","description":"Adds a usage alert, which is to email its recipients when your team's usage crosses its trigger, at most once a UTC day, or once a billing period for overage and budget_percent.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/usage/alerts","href":"/api-reference/usage_alerts/add-a-usage-alert","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"usage_alerts.create","tags":["usage_alerts"],"summary":"Add a usage alert","description":"Adds a usage alert, which is to email its recipients when your team's usage crosses its trigger, at most once a UTC day, or once a billing period for overage and budget_percent.","requestBody":"4891b5da-4d5a-4a25-a561-55bf26a952c9","responses":{"201":"02c82410-d777-45f2-812a-78e9ddd868f7","400":"40929288-4a0f-410d-87e9-7995eff000d9","401":"d86dedcd-a1fa-431a-90d5-b3aa565532aa","403":"b3f8cee2-00aa-4d47-9701-00814b0d6f3a","413":"2aaa74ad-b2d4-4684-a37a-065c96be0ebb","500":"a46a9a7c-8413-4136-bd51-9fefae70bcab","503":"7bce7d6a-4a28-4355-9b78-9cac669b7202"},"security":["c906b36d-e9e7-4f66-bcf0-0e0b7a59c3df"],"x-pomerado-effect":"write","x-pomerado-callers":["session","oauth","api_key"],"x-pomerado-permission":"team:manage","x-pomerado-key-permission":"team:manage","x-mint":{"content":"\u003cAccordion title=\"Details\">\n\nIt is recorded in your team's audit log. Each goes to the address the recipient signs in with.\n\n- Owners and Admins only. An API key needs team:manage.\n- trigger: calls (in a UTC day), included_calls_percent (of the day's included calls), overage (cents of overage in the billing period), budget_percent (of the overage budget) or cap_reached. Percentages are 1 to 1000.\n- recipients: roles, everyone in them when it sends, and member_ids, verified members of your team (members who have joined it). At least one. Alerts in dollars (overage, budget_percent) email only the Owners and Admins among them.\n- A team keeps up to 50 alerts.\n\n- **Callers:** an API key, an MCP OAuth token or a Dashboard session.\n- **Permission:** `team:manage`; an API key also needs `team:manage`.\n- **Effect:** Creates or changes something.\n- **Errors:** [`business_account_required`](/errors#business_account_required), [`role_permission_missing`](/errors#role_permission_missing), and the [errors any request can get](/errors).\n\n\u003c/Accordion>"},"method":"post","type":"path","servers":["c6a56640-289a-4948-a5b3-bf54ed227851"],"path":"/v1/usage/alerts","baseUrlOptions":["https://api.pomerado.ai"],"title":"Add a usage alert","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["trigger","recipients"],"properties":{"trigger":{"oneOf":[{"type":"object","description":"What sets it off: calls or included_calls_percent each UTC day, overage or budget_percent (dollars, Owners and Admins only) each billing period, or cap_reached when the daily cap refuses runs","required":["kind","calls"],"properties":{"kind":{"type":"string","enum":["calls"],"isRequired":true,"uniqueKey":"trigger.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"calls":{"type":"integer","description":"Tool calls in a UTC day","minimum":1,"maximum":1000000000,"isRequired":true,"uniqueKey":"trigger.oneOf.0.calls","typeLabel":"integer"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"trigger.oneOf.0","typeLabel":"object"},{"type":"object","description":"What sets it off: calls or included_calls_percent each UTC day, overage or budget_percent (dollars, Owners and Admins only) each billing period, or cap_reached when the daily cap refuses runs","required":["kind","percent"],"properties":{"kind":{"type":"string","enum":["included_calls_percent"],"isRequired":true,"uniqueKey":"trigger.oneOf.1.kind","typeLabel":"enum\u003cstring>"},"percent":{"type":"integer","description":"Of the UTC day's included calls, 1 to 1000","minimum":1,"maximum":1000,"isRequired":true,"uniqueKey":"trigger.oneOf.1.percent","typeLabel":"integer"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"trigger.oneOf.1","typeLabel":"object"},{"type":"object","description":"What sets it off: calls or included_calls_percent each UTC day, overage or budget_percent (dollars, Owners and Admins only) each billing period, or cap_reached when the daily cap refuses runs","required":["kind","overage_cents"],"properties":{"kind":{"type":"string","enum":["overage"],"isRequired":true,"uniqueKey":"trigger.oneOf.2.kind","typeLabel":"enum\u003cstring>"},"overage_cents":{"type":"integer","description":"Overage in the billing period, in US cents","minimum":1,"maximum":100000000000,"isRequired":true,"uniqueKey":"trigger.oneOf.2.overage_cents","typeLabel":"integer"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"trigger.oneOf.2","typeLabel":"object"},{"type":"object","description":"What sets it off: calls or included_calls_percent each UTC day, overage or budget_percent (dollars, Owners and Admins only) each billing period, or cap_reached when the daily cap refuses runs","required":["kind","percent"],"properties":{"kind":{"type":"string","enum":["budget_percent"],"isRequired":true,"uniqueKey":"trigger.oneOf.3.kind","typeLabel":"enum\u003cstring>"},"percent":{"type":"integer","description":"Of the overage budget in the billing period, 1 to 1000","minimum":1,"maximum":1000,"isRequired":true,"uniqueKey":"trigger.oneOf.3.percent","typeLabel":"integer"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"trigger.oneOf.3","typeLabel":"object"},{"type":"object","description":"What sets it off: calls or included_calls_percent each UTC day, overage or budget_percent (dollars, Owners and Admins only) each billing period, or cap_reached when the daily cap refuses runs","required":["kind"],"properties":{"kind":{"type":"string","enum":["cap_reached"],"isRequired":true,"uniqueKey":"trigger.oneOf.4.kind","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"trigger.oneOf.4","typeLabel":"object"}],"isRequired":true,"uniqueKey":"trigger","typeLabel":"object"},"recipients":{"type":"object","required":[],"properties":{"roles":{"type":"array","items":{"type":"string","enum":["owner","admin","member","tool_user"],"uniqueKey":"recipients.roles.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Everyone in these roles when it sends","maxItems":4,"uniqueKey":"recipients.roles","typeLabel":"enum\u003cstring>[]"},"member_ids":{"type":"array","items":{"type":"string","description":"a team member ID: the user_id GET /v1/team/members gives: user_ and up to 100 letters or digits","examples":["user_01K6QZ8V3N4M5P6R7S8T9W0XYZ"],"uniqueKey":"recipients.member_ids.items.[INDEX]","typeLabel":"string"},"description":"Verified members of your team, each by user ID: members who have joined it","maxItems":100,"uniqueKey":"recipients.member_ids","typeLabel":"string[]"}},"additionalProperties":false,"description":"At least one role or member","isRequired":true,"uniqueKey":"recipients","typeLabel":"object"},"on":{"type":"boolean","description":"Default true","uniqueKey":"on","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"trigger":{"kind":"calls","calls":500000000},"recipients":{"roles":[],"member_ids":["user_01K6QZ8V3N4M5P6R7S8T9W0XYZ"]},"on":true}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"02c82410-d777-45f2-812a-78e9ddd868f7":{"description":"The alert","content":{"application/json":{"schema":{"type":"object","required":["id","trigger","window","on","recipients","on_changed_at","last_sent_at"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"trigger":{"oneOf":[{"type":"object","description":"What sets it off: calls or included_calls_percent each UTC day, overage or budget_percent (dollars, Owners and Admins only) each billing period, or cap_reached when the daily cap refuses runs","required":["kind","calls"],"properties":{"kind":{"type":"string","enum":["calls"],"isRequired":true,"uniqueKey":"trigger.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"calls":{"type":"integer","description":"Tool calls in a UTC day","minimum":1,"maximum":1000000000,"isRequired":true,"uniqueKey":"trigger.oneOf.0.calls","typeLabel":"integer"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"trigger.oneOf.0","typeLabel":"object"},{"type":"object","description":"What sets it off: calls or included_calls_percent each UTC day, overage or budget_percent (dollars, Owners and Admins only) each billing period, or cap_reached when the daily cap refuses runs","required":["kind","percent"],"properties":{"kind":{"type":"string","enum":["included_calls_percent"],"isRequired":true,"uniqueKey":"trigger.oneOf.1.kind","typeLabel":"enum\u003cstring>"},"percent":{"type":"integer","description":"Of the UTC day's included calls, 1 to 1000","minimum":1,"maximum":1000,"isRequired":true,"uniqueKey":"trigger.oneOf.1.percent","typeLabel":"integer"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"trigger.oneOf.1","typeLabel":"object"},{"type":"object","description":"What sets it off: calls or included_calls_percent each UTC day, overage or budget_percent (dollars, Owners and Admins only) each billing period, or cap_reached when the daily cap refuses runs","required":["kind","overage_cents"],"properties":{"kind":{"type":"string","enum":["overage"],"isRequired":true,"uniqueKey":"trigger.oneOf.2.kind","typeLabel":"enum\u003cstring>"},"overage_cents":{"type":"integer","description":"Overage in the billing period, in US cents","minimum":1,"maximum":100000000000,"isRequired":true,"uniqueKey":"trigger.oneOf.2.overage_cents","typeLabel":"integer"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"trigger.oneOf.2","typeLabel":"object"},{"type":"object","description":"What sets it off: calls or included_calls_percent each UTC day, overage or budget_percent (dollars, Owners and Admins only) each billing period, or cap_reached when the daily cap refuses runs","required":["kind","percent"],"properties":{"kind":{"type":"string","enum":["budget_percent"],"isRequired":true,"uniqueKey":"trigger.oneOf.3.kind","typeLabel":"enum\u003cstring>"},"percent":{"type":"integer","description":"Of the overage budget in the billing period, 1 to 1000","minimum":1,"maximum":1000,"isRequired":true,"uniqueKey":"trigger.oneOf.3.percent","typeLabel":"integer"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"trigger.oneOf.3","typeLabel":"object"},{"type":"object","description":"What sets it off: calls or included_calls_percent each UTC day, overage or budget_percent (dollars, Owners and Admins only) each billing period, or cap_reached when the daily cap refuses runs","required":["kind"],"properties":{"kind":{"type":"string","enum":["cap_reached"],"isRequired":true,"uniqueKey":"trigger.oneOf.4.kind","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"trigger.oneOf.4","typeLabel":"object"}],"isRequired":true,"uniqueKey":"trigger","typeLabel":"object"},"window":{"type":"string","enum":["day","billing_period"],"description":"It is emailed at most once in each: a UTC day, or a billing period","isRequired":true,"uniqueKey":"window","typeLabel":"enum\u003cstring>"},"on":{"type":"boolean","isRequired":true,"uniqueKey":"on","typeLabel":"boolean"},"recipients":{"type":"object","required":["roles","members"],"properties":{"roles":{"type":"array","items":{"type":"string","enum":["owner","admin","member","tool_user"],"uniqueKey":"recipients.roles.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Everyone in these roles when it sends","isRequired":true,"uniqueKey":"recipients.roles","typeLabel":"enum\u003cstring>[]"},"members":{"type":"array","items":{"type":"object","required":["member_id","name","email"],"properties":{"member_id":{"type":"string","description":"The member's user ID","isRequired":true,"uniqueKey":"recipients.members.items.[INDEX].member_id","typeLabel":"string"},"name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"recipients.members.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"recipients.members.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"recipients.members.items.[INDEX].name","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"recipients.members.items.[INDEX].email.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"recipients.members.items.[INDEX].email.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"recipients.members.items.[INDEX].email","typeLabel":"string | null"}},"additionalProperties":false,"description":"A member. name and email are null once your team no longer knows them, and to an API key without team:manage for anyone but its own member","uniqueKey":"recipients.members.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"recipients.members","typeLabel":"object[]"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"recipients","typeLabel":"object"},"on_changed_at":{"type":"string","description":"When it was created, or last turned on or off","isRequired":true,"uniqueKey":"on_changed_at","typeLabel":"string"},"last_sent_at":{"oneOf":[{"type":"string","description":"ISO 8601 UTC","isRequired":true,"uniqueKey":"last_sent_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"last_sent_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"last_sent_at","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","trigger":{"kind":"calls","calls":500000000},"window":"day","on":true,"recipients":{"roles":["owner"],"members":[{"member_id":"\u003cstring>","name":"\u003cstring>","email":"\u003cstring>"}]},"on_changed_at":"\u003cstring>","last_sent_at":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"40929288-4a0f-410d-87e9-7995eff000d9":{"description":"invalid_request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable","docs_url"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"docs_url":{"type":"string","isRequired":true,"uniqueKey":"error.docs_url","typeLabel":"string"},"details":{"type":"object","required":[],"properties":{},"additionalProperties":{"oneOf":[{"$id":"/schemas/unknown"}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"docs_url":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"d86dedcd-a1fa-431a-90d5-b3aa565532aa":{"description":"unauthorized, reauthentication_required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable","docs_url"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"docs_url":{"type":"string","isRequired":true,"uniqueKey":"error.docs_url","typeLabel":"string"},"details":{"type":"object","required":[],"properties":{},"additionalProperties":{"oneOf":[{"$id":"/schemas/unknown"}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"docs_url":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"b3f8cee2-00aa-4d47-9701-00814b0d6f3a":{"description":"business_account_required, role_permission_missing, forbidden","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable","docs_url"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"docs_url":{"type":"string","isRequired":true,"uniqueKey":"error.docs_url","typeLabel":"string"},"details":{"type":"object","required":[],"properties":{},"additionalProperties":{"oneOf":[{"$id":"/schemas/unknown"}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"docs_url":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"2aaa74ad-b2d4-4684-a37a-065c96be0ebb":{"description":"request_too_large","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable","docs_url"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"docs_url":{"type":"string","isRequired":true,"uniqueKey":"error.docs_url","typeLabel":"string"},"details":{"type":"object","required":[],"properties":{},"additionalProperties":{"oneOf":[{"$id":"/schemas/unknown"}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"docs_url":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"a46a9a7c-8413-4136-bd51-9fefae70bcab":{"description":"internal_error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable","docs_url"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"docs_url":{"type":"string","isRequired":true,"uniqueKey":"error.docs_url","typeLabel":"string"},"details":{"type":"object","required":[],"properties":{},"additionalProperties":{"oneOf":[{"$id":"/schemas/unknown"}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"docs_url":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"7bce7d6a-4a28-4355-9b78-9cac669b7202":{"description":"temporarily_unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable","docs_url"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"docs_url":{"type":"string","isRequired":true,"uniqueKey":"error.docs_url","typeLabel":"string"},"details":{"type":"object","required":[],"properties":{},"additionalProperties":{"oneOf":[{"$id":"/schemas/unknown"}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"docs_url":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"c906b36d-e9e7-4f66-bcf0-0e0b7a59c3df":{"bearer":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearer"}}},"servers":{"c6a56640-289a-4948-a5b3-bf54ed227851":{"url":"https://api.pomerado.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer","name":"Authorization"}],"title":"bearer"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"pomerado","siteName":"Pomerado","title":"Add a usage alert - Pomerado","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-15T09:27:27.742Z","originalFileLocation":"api-reference/usage_alerts/add-a-usage-alert.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}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=\"Adds a usage alert, which is to email its recipients when your team\u0026#x27;s usage crosses its trigger, at most once a UTC day, or once a billing period for overage and budget_percent.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Pomerado\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/pomerado/OK4DStTtADU9WYMj/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/pomerado/OK4DStTtADU9WYMj/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/pomerado/OK4DStTtADU9WYMj/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/pomerado/OK4DStTtADU9WYMj/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/pomerado/OK4DStTtADU9WYMj/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/pomerado/OK4DStTtADU9WYMj/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/pomerado/OK4DStTtADU9WYMj/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/pomerado/OK4DStTtADU9WYMj/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/pomerado/OK4DStTtADU9WYMj/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Add a usage alert - Pomerado\">\u003cmeta data-mint-head property=\"og:description\" content=\"Adds a usage alert, which is to email its recipients when your team\u0026#x27;s usage crosses its trigger, at most once a UTC day, or once a billing period for overage and budget_percent.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Pomerado\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.pomerado.ai/api-reference/usage_alerts/add-a-usage-alert\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://pomerado.mintlify.site/_mintlify/api/og/v2?division=Spend+controls\u0026amp;title=Add+a+usage+alert\u0026amp;description=Adds+a+usage+alert%2C+which+is+to+email+its+recipients+when+your+team%27s+usage+crosses+its+trigger%2C+at+most+once+a+UTC+day%2C+or+once+a+billing+period+for+overage+an\u0026amp;theme=43a9dbd260677a50f1d670ed\u0026amp;signature=ef1f972623315878ccbe2b65e2d11f41170c6e6e7729a60c54963496b572218a\">\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=\"Add a usage alert - Pomerado\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Adds a usage alert, which is to email its recipients when your team\u0026#x27;s usage crosses its trigger, at most once a UTC day, or once a billing period for overage and budget_percent.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://pomerado.mintlify.site/_mintlify/api/og/v2?division=Spend+controls\u0026amp;title=Add+a+usage+alert\u0026amp;description=Adds+a+usage+alert%2C+which+is+to+email+its+recipients+when+your+team%27s+usage+crosses+its+trigger%2C+at+most+once+a+UTC+day%2C+or+once+a+billing+period+for+overage+an\u0026amp;theme=43a9dbd260677a50f1d670ed\u0026amp;signature=ef1f972623315878ccbe2b65e2d11f41170c6e6e7729a60c54963496b572218a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/pomerado/OK4DStTtADU9WYMj/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Pomerado\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#c71f3e\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.pomerado.ai/api-reference/usage_alerts/add-a-usage-alert\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/usage_alerts/add-a-usage-alert.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.pomerado.ai/#organization\",\"name\":\"Pomerado\",\"url\":\"https://docs.pomerado.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/pomerado/MWnuKCF6pT3dH-IM/logo/light.svg?fit=max\u0026auto=format\u0026n=MWnuKCF6pT3dH-IM\u0026q=85\u0026s=b1723a79805dcc9e0c0982901abf76fd\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.pomerado.ai#website\",\"name\":\"Pomerado\",\"url\":\"https://docs.pomerado.ai\",\"publisher\":{\"@id\":\"https://docs.pomerado.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.pomerado.ai/api-reference/usage_alerts/add-a-usage-alert#webpage\",\"url\":\"https://docs.pomerado.ai/api-reference/usage_alerts/add-a-usage-alert\",\"name\":\"Add a usage alert\",\"description\":\"Adds a usage alert, which is to email its recipients when your team's usage crosses its trigger, at most once a UTC day, or once a billing period for overage and budget_percent.\",\"dateModified\":\"2026-11-15T09:27:27.742Z\",\"isPartOf\":{\"@id\":\"https://docs.pomerado.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.pomerado.ai/api-reference/usage_alerts/add-a-usage-alert#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.pomerado.ai/api-reference/usage_alerts/add-a-usage-alert#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Spend controls\",\"item\":\"https://docs.pomerado.ai/api-reference/spend_controls/get-your-teams-daily-cap-and-overage-budget\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Add a usage alert\",\"item\":\"https://docs.pomerado.ai/api-reference/usage_alerts/add-a-usage-alert\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.pomerado.ai/api-reference/usage_alerts/add-a-usage-alert#apireference\",\"headline\":\"Add a usage alert\",\"name\":\"Add a usage alert\",\"description\":\"Adds a usage alert, which is to email its recipients when your team's usage crosses its trigger, at most once a UTC day, or once a billing period for overage and budget_percent.\",\"url\":\"https://docs.pomerado.ai/api-reference/usage_alerts/add-a-usage-alert\",\"mainEntityOfPage\":{\"@id\":\"https://docs.pomerado.ai/api-reference/usage_alerts/add-a-usage-alert#webpage\"},\"dateModified\":\"2026-11-15T09:27:27.742Z\",\"publisher\":{\"@id\":\"https://docs.pomerado.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.pomerado.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Pomerado\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Pomerado\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/usage_alerts/add-a-usage-alert.md","siteName":"Pomerado","nav":{"global":null,"anchors":[{"anchor":"Docs","pages":[{"title":"Docs","href":""}]},{"anchor":"API reference","groups":[{"group":"Overview","pages":[{"title":"API reference","sidebarTitle":"Introduction","href":"/api-reference/introduction"}]},{"group":"Account","pages":[{"title":"Get your account","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/account","href":"/api-reference/account/get-your-account"},{"title":"Set your name","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/account/name","href":"/api-reference/account/set-your-name"},{"title":"Get your preferences","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/account/preferences","href":"/api-reference/account/get-your-preferences"},{"title":"Change your preferences","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/account/preferences","href":"/api-reference/account/change-your-preferences"},{"title":"Set your time zone","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/account/time-zone","href":"/api-reference/account/set-your-time-zone"},{"title":"Get your account's privacy settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/account/privacy","href":"/api-reference/account/get-your-accounts-privacy-settings"},{"title":"Change your account's privacy settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/account/privacy","href":"/api-reference/account/change-your-accounts-privacy-settings"},{"title":"Get your card page's brand","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/account/card-page","href":"/api-reference/account/get-your-card-pages-brand"},{"title":"Set your card page's brand","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/account/card-page","href":"/api-reference/account/set-your-card-pages-brand"}]},{"group":"Runs","pages":[{"title":"List the runs your team started","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/runs","href":"/api-reference/runs/list-the-runs-your-team-started"},{"title":"Run a tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/runs","href":"/api-reference/runs/run-a-tool"},{"title":"Run a read-only tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/runs/read-only","href":"/api-reference/runs/run-a-read-only-tool"},{"title":"Run an integration's tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/integrations/{id}/tools/{tool_id}/runs","href":"/api-reference/runs/run-an-integrations-tool"},{"title":"Run a read-only tool on a list of inputs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/runs/read-only/batch","href":"/api-reference/runs/run-a-read-only-tool-on-a-list-of-inputs"},{"title":"Run an integration's read tool on a list of inputs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/integrations/{id}/tools/{tool_id}/runs/batch","href":"/api-reference/runs/run-an-integrations-read-tool-on-a-list-of-inputs"},{"title":"Get a batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/batches/{id}","href":"/api-reference/runs/get-a-batch"},{"title":"Cancel a batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/batches/{id}/cancel","href":"/api-reference/runs/cancel-a-batch"},{"title":"Get a run's log","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/runs/{id}/log","href":"/api-reference/runs/get-a-runs-log"}]},{"group":"Builds","pages":[{"title":"Build a tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/builds","href":"/api-reference/builds/build-a-tool"}]},{"group":"Build ideas","pages":[{"title":"Get build ideas","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/suggestions","href":"/api-reference/suggestions/get-build-ideas"}]},{"group":"Jobs","pages":[{"title":"List jobs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/jobs","href":"/api-reference/jobs/list-jobs"},{"title":"Get a job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/jobs/{id}","href":"/api-reference/jobs/get-a-job"},{"title":"Answer a job's question","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/jobs/{id}/answers","href":"/api-reference/jobs/answer-a-jobs-question"},{"title":"Cancel a job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/jobs/{id}/cancel","href":"/api-reference/jobs/cancel-a-job"},{"title":"Resume a paused build","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/jobs/{id}/resume","href":"/api-reference/jobs/resume-a-paused-build"},{"title":"Get a build's activity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/jobs/{id}/activity","href":"/api-reference/jobs/get-a-builds-activity"}]},{"group":"Tools and integrations","pages":[{"title":"Tools and integrations","sidebarTitle":"Overview","href":"/api-reference/tools-and-integrations"},{"title":"List tools","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/tools","href":"/api-reference/tools/list-tools"},{"title":"Get a tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/tools/{id}","href":"/api-reference/tools/get-a-tool"},{"title":"Delete a tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/tools/{id}","href":"/api-reference/tools/delete-a-tool"},{"title":"Request a change to a tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/tools/{id}/changes","href":"/api-reference/tools/request-a-change-to-a-tool"},{"title":"List integrations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/integrations","href":"/api-reference/integrations/list-integrations"},{"title":"List your team's integrations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/integrations/team","href":"/api-reference/integrations/list-your-teams-integrations"},{"title":"Get an integration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/integrations/{id}","href":"/api-reference/integrations/get-an-integration"},{"title":"Set integration visibility","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/integrations/{id}/visibility","href":"/api-reference/integrations/set-integration-visibility"},{"title":"Delete an integration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/integrations/{id}/tools","href":"/api-reference/integrations/delete-an-integration"},{"title":"Get an integration's OpenAPI document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/integrations/{id}/openapi.json","href":"/api-reference/integrations/get-an-integrations-openapi-document"},{"title":"Get an integration's reference","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/integrations/{id}/reference","href":"/api-reference/integrations/get-an-integrations-reference"},{"title":"Add an integration to My integrations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/integrations/{id}/added","href":"/api-reference/integrations/add-an-integration-to-my-integrations"},{"title":"Remove an added integration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/integrations/{id}/added","href":"/api-reference/integrations/remove-an-added-integration"},{"title":"Get MCP client setup","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/connect","href":"/api-reference/connect/get-mcp-client-setup"},{"title":"List your team's code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/code","href":"/api-reference/code/list-your-teams-code"},{"title":"Get a tool's code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/code/{id}","href":"/api-reference/code/get-a-tools-code"},{"title":"Download a tool's code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/code/{id}/export","href":"/api-reference/code/download-a-tools-code"},{"title":"Get a download link for a tool's code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/code/{id}/export-link","href":"/api-reference/code/get-a-download-link-for-a-tools-code"},{"title":"Save a file in a tool's draft","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/code/{id}/draft","href":"/api-reference/code/save-a-file-in-a-tools-draft"},{"title":"Discard a tool's draft","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/code/{id}/draft","href":"/api-reference/code/discard-a-tools-draft"},{"title":"Restore an earlier version of a tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/code/{id}/versions/{number}/restore","href":"/api-reference/code/restore-an-earlier-version-of-a-tool"},{"title":"Run a tool's code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/code/{id}/runs","href":"/api-reference/code/run-a-tools-code"},{"title":"Read a run's output","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/code/runs/{id}/output","href":"/api-reference/code/read-a-runs-output"},{"title":"Publish a tool's draft","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/code/{id}/draft/publish","href":"/api-reference/code/publish-a-tools-draft"}]},{"group":"Shapes","pages":[{"title":"List your shapes of a tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/tools/{id}/shapes","href":"/api-reference/shapes/list-your-shapes-of-a-tool"},{"title":"Get a shape","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/shapes/{id}","href":"/api-reference/shapes/get-a-shape"},{"title":"Make a shape","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/tools/{id}/shapes","href":"/api-reference/shapes/make-a-shape"},{"title":"Change a shape","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/shapes/{id}","href":"/api-reference/shapes/change-a-shape"},{"title":"Delete a shape","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/shapes/{id}","href":"/api-reference/shapes/delete-a-shape"},{"title":"Restore a version of a shape","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/shapes/{id}/restore","href":"/api-reference/shapes/restore-a-version-of-a-shape"}]},{"group":"Files","pages":[{"title":"Get a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/files/{id}","href":"/api-reference/files/get-a-file"},{"title":"Upload a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/files","href":"/api-reference/files/upload-a-file"},{"title":"Delete a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/files/{id}","href":"/api-reference/files/delete-a-file"}]},{"group":"Webhooks","pages":[{"title":"List webhooks","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Get a webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/webhooks/{id}","href":"/api-reference/webhooks/get-a-webhook"},{"title":"Create a webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/webhooks","href":"/api-reference/webhooks/create-a-webhook"},{"title":"Update a webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/webhooks/{id}","href":"/api-reference/webhooks/update-a-webhook"},{"title":"Delete a webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/webhooks/{id}","href":"/api-reference/webhooks/delete-a-webhook"},{"title":"Test a webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/webhooks/{id}/test","href":"/api-reference/webhooks/test-a-webhook"},{"title":"Rotate a webhook secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/webhooks/{id}/rotate-secret","href":"/api-reference/webhooks/rotate-a-webhook-secret"}]},{"group":"Saved logins","pages":[{"title":"List pending logins","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/logins/pending","href":"/api-reference/logins/list-pending-logins"},{"title":"List saved logins","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/logins","href":"/api-reference/logins/list-saved-logins"},{"title":"Get a saved login","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/logins/{id}","href":"/api-reference/logins/get-a-saved-login"},{"title":"Save a login","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/logins","href":"/api-reference/logins/save-a-login"},{"title":"Change a saved login","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/logins/{id}","href":"/api-reference/logins/change-a-saved-login"},{"title":"Delete a saved login","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/logins/{id}","href":"/api-reference/logins/delete-a-saved-login"},{"title":"Import saved logins","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/logins/import","href":"/api-reference/logins/import-saved-logins"},{"title":"Get a pending login","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/logins/pending/{id}","href":"/api-reference/logins/get-a-pending-login"},{"title":"Cancel a pending login","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/logins/pending/{id}","href":"/api-reference/logins/cancel-a-pending-login"},{"title":"Reveal a saved login","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/logins/{id}/reveal","href":"/api-reference/logins/reveal-a-saved-login"}]},{"group":"2FA","pages":[{"title":"Replace recovery codes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/logins/{id}/recovery-codes","href":"/api-reference/two_factor/replace-recovery-codes"},{"title":"Get an authenticator code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/logins/{id}/authenticator-code","href":"/api-reference/two_factor/get-an-authenticator-code"},{"title":"Get a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/logins/{id}/sms-number","href":"/api-reference/two_factor/get-a-phone-number"},{"title":"Assign a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/logins/{id}/sms-number","href":"/api-reference/two_factor/assign-a-phone-number"},{"title":"Verify a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/logins/{id}/sms-number/verify","href":"/api-reference/two_factor/verify-a-phone-number"},{"title":"Remove a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/logins/{id}/sms-number","href":"/api-reference/two_factor/remove-a-phone-number"}]},{"group":"Login access","pages":[{"title":"Get login access","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/logins/{id}/access","href":"/api-reference/login_access/get-login-access"},{"title":"Change login access","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/logins/{id}/access","href":"/api-reference/login_access/change-login-access"}]},{"group":"Team","pages":[{"title":"List team members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/team/members","href":"/api-reference/team/list-team-members"},{"title":"List invitations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/team/invitations","href":"/api-reference/team/list-invitations"},{"title":"Get team settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/team","href":"/api-reference/team/get-team-settings"},{"title":"Change a member's role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/team/members/{user_id}","href":"/api-reference/team/change-a-members-role"},{"title":"Remove a team member","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/team/members/{user_id}","href":"/api-reference/team/remove-a-team-member"},{"title":"Invite team members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/team/invitations","href":"/api-reference/team/invite-team-members"},{"title":"Resend an invitation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/team/invitations/{id}/resend","href":"/api-reference/team/resend-an-invitation"},{"title":"Revoke an invitation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/team/invitations/{id}","href":"/api-reference/team/revoke-an-invitation"},{"title":"Get the team's intent setting","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/team/intent-settings","href":"/api-reference/team/get-the-teams-intent-setting"},{"title":"Change the team's intent setting","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/team/intent-settings","href":"/api-reference/team/change-the-teams-intent-setting"}]},{"group":"Single sign-on","pages":[{"title":"Get the team's single sign-on setup","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/team/sso","href":"/api-reference/sso/get-the-teams-single-sign-on-setup"},{"title":"Open the team's Admin Portal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/team/sso/setup-links","href":"/api-reference/sso/open-the-teams-admin-portal"},{"title":"Email your IT admin a setup link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/team/sso/it-admin-invitations","href":"/api-reference/sso/email-your-it-admin-a-setup-link"}]},{"group":"Audit log","pages":[{"title":"List your team's audit log","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/audit-events","href":"/api-reference/audit/list-your-teams-audit-log"}]},{"group":"API keys","pages":[{"title":"List API keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/api-keys","href":"/api-reference/api_keys/list-api-keys"},{"title":"Create an API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/api-keys","href":"/api-reference/api_keys/create-an-api-key"},{"title":"Revoke an API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/api-keys/{id}","href":"/api-reference/api_keys/revoke-an-api-key"},{"title":"Rotate an API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/api-keys/{id}/rotate","href":"/api-reference/api_keys/rotate-an-api-key"},{"title":"Mark an API key copied","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/api-keys/{id}/copied","href":"/api-reference/api_keys/mark-an-api-key-copied"}]},{"group":"Connected apps","pages":[{"title":"List connected apps","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/connected-apps","href":"/api-reference/connected_apps/list-connected-apps"},{"title":"Disconnect an app","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/connected-apps/{id}","href":"/api-reference/connected_apps/disconnect-an-app"}]},{"group":"Usage and quota","pages":[{"title":"Get your usage","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/usage","href":"/api-reference/usage/get-your-usage"},{"title":"Get your team's spend this billing period","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/usage/spend","href":"/api-reference/usage/get-your-teams-spend-this-billing-period"},{"title":"Get your plan limits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/quota","href":"/api-reference/quota/get-your-plan-limits"}]},{"group":"Spend controls","pages":[{"title":"Get your team's daily cap and overage budget","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/usage/spend-controls","href":"/api-reference/spend_controls/get-your-teams-daily-cap-and-overage-budget"},{"title":"Change your team's daily cap or overage budget","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/usage/spend-controls","href":"/api-reference/spend_controls/change-your-teams-daily-cap-or-overage-budget"},{"title":"List your team's usage alerts","description":"Lists your Business team's usage alerts, oldest first: what sets each off, whom it emails, whether it is on and when it last sent.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/usage/alerts","href":"/api-reference/usage_alerts/list-your-teams-usage-alerts"},{"title":"Add a usage alert","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/usage/alerts","href":"/api-reference/usage_alerts/add-a-usage-alert"},{"title":"Change a usage alert","description":"Changes a usage alert's trigger or recipients, or turns it on or off.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/usage/alerts/{alert_id}","href":"/api-reference/usage_alerts/change-a-usage-alert"},{"title":"Delete a usage alert","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/usage/alerts/{alert_id}","href":"/api-reference/usage_alerts/delete-a-usage-alert"},{"title":"Get your usage summary email","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/usage/summary","href":"/api-reference/usage_summary/get-your-usage-summary-email"},{"title":"Change your usage summary email","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/usage/summary","href":"/api-reference/usage_summary/change-your-usage-summary-email"}]},{"group":"Billing","pages":[{"title":"Get your subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/billing","href":"/api-reference/billing/get-your-subscription"},{"title":"Start a Premium checkout","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/billing/checkout","href":"/api-reference/billing/start-a-premium-checkout"},{"title":"Open the billing portal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/billing/portal","href":"/api-reference/billing/open-the-billing-portal"},{"title":"Redeem a free Premium code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/billing/redeem","href":"/api-reference/billing/redeem-a-free-premium-code"}]},{"group":"Payer profiles","pages":[{"title":"List payer profiles","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/payer-profiles","href":"/api-reference/payer_profiles/list-payer-profiles"},{"title":"Get a payer profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/payer-profiles/{id}","href":"/api-reference/payer_profiles/get-a-payer-profile"},{"title":"Create a payer profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/payer-profiles","href":"/api-reference/payer_profiles/create-a-payer-profile"},{"title":"Update a payer profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/payer-profiles/{id}","href":"/api-reference/payer_profiles/update-a-payer-profile"},{"title":"Delete a payer profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/payer-profiles/{id}","href":"/api-reference/payer_profiles/delete-a-payer-profile"},{"title":"Add a payer address","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/payer-profiles/{id}/addresses","href":"/api-reference/payer_addresses/add-a-payer-address"},{"title":"Update a payer address","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/payer-profiles/{id}/addresses/{address_id}","href":"/api-reference/payer_addresses/update-a-payer-address"},{"title":"Delete a payer address","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/payer-profiles/{id}/addresses/{address_id}","href":"/api-reference/payer_addresses/delete-a-payer-address"},{"title":"List payment methods","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/payer-profiles/{id}/payment-methods","href":"/api-reference/payment_methods/list-payment-methods"},{"title":"Add a payment method","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/payer-profiles/{id}/payment-methods","href":"/api-reference/payment_methods/add-a-payment-method"},{"title":"Delete a payment method","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/payer-profiles/{id}/payment-methods/{payment_method_id}","href":"/api-reference/payment_methods/delete-a-payment-method"}]},{"group":"Problem reports","pages":[{"title":"Report a problem","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/issue-reports","href":"/api-reference/issue_reports/report-a-problem"}]}]},{"anchor":"MCP reference","pages":[{"title":"MCP reference","href":"/mcp-reference/conventions"}]},{"anchor":"Errors","pages":[{"title":"Errors","href":"/errors"}]}]},"basePath":"","title":"Add a usage alert - Pomerado","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","Page-BIYvYBgk.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}