> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topograph.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Upsert workspace high-usage override



## OpenAPI

````yaml patch /v2/billing/notifications/workspaces/{workspaceId}/config
openapi: 3.0.0
info:
  title: Topograph
  description: The Topograph API
  version: '0.1'
  contact: {}
servers:
  - url: https://api.topograph.co
security:
  - x-api-key: []
tags: []
paths:
  /v2/billing/notifications/workspaces/{workspaceId}/config:
    patch:
      tags:
        - Billing Notifications
      summary: Upsert workspace high-usage override
      operationId: BillingNotificationsController_upsertWorkspaceOverride_v2
      parameters:
        - name: workspaceId
          required: true
          in: path
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateWorkspaceHighUsageOverrideDto'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BillingNotificationWorkspaceOverrideDto'
      security:
        - x-api-key: []
components:
  schemas:
    UpdateWorkspaceHighUsageOverrideDto:
      type: object
      properties:
        highUsageEnabled:
          type: boolean
          description: >-
            Override the account-level master toggle for per-workspace
            high-usage notifications. Undefined means "inherit from account
            config".
          example: true
        highUsageEmailEnabled:
          type: boolean
          description: >-
            Override the account-level email routing for high-usage
            notifications for this workspace.
          example: true
        highUsageWebhookEnabled:
          type: boolean
          description: >-
            Override the account-level webhook routing for high-usage
            notifications for this workspace.
          example: true
        highUsagePeriodMinutes:
          type: number
          description: >-
            Override the rolling window, in minutes, used to sum this
            workspace's spend when evaluating high-usage tiers. Min 5, max
            43200.
          example: 1440
          minimum: 5
          maximum: 43200
        highUsageTiers:
          description: >-
            Override the high-usage tiers for this workspace specifically. Fires
            when the workspace spend over the rolling window meets-or-exceeds
            `cents`. Tier names must be unique.
          minItems: 1
          maxItems: 5
          type: array
          items:
            $ref: '#/components/schemas/HighUsageTierDto'
    BillingNotificationWorkspaceOverrideDto:
      type: object
      properties:
        id:
          type: string
          description: Override row ID.
          example: f2b5e0b8-1a3c-4f7e-9d2a-7c6b8a1d4e52
        workspaceId:
          type: string
          description: Workspace ID this override applies to.
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        createdAt:
          type: string
          description: Row creation timestamp.
          example: '2026-04-15T12:34:56.789Z'
          format: date-time
        updatedAt:
          type: string
          description: Row last-update timestamp.
          example: '2026-04-22T08:12:34.567Z'
          format: date-time
        highUsageEnabled:
          type: boolean
          description: Override for master high-usage toggle. Null means "inherit".
          example: true
          nullable: true
        highUsageEmailEnabled:
          type: boolean
          description: Override for email routing. Null means "inherit".
          example: true
          nullable: true
        highUsageWebhookEnabled:
          type: boolean
          description: Override for webhook routing. Null means "inherit".
          example: true
          nullable: true
        highUsagePeriodMinutes:
          type: number
          description: Override for rolling window minutes. Null means "inherit".
          example: 720
          nullable: true
        highUsageTiers:
          description: Override for tier thresholds. Null means "inherit".
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/HighUsageTierDto'
      required:
        - id
        - workspaceId
        - createdAt
        - updatedAt
    HighUsageTierDto:
      type: object
      properties:
        tier:
          type: string
          description: Severity tier name. Must be unique within the array.
          enum:
            - warning
            - critical
          example: warning
        cents:
          type: number
          description: >-
            Spend threshold in cents over the rolling period. A notification
            fires when the rolling-period spend is at or above this value.
          example: 100000
          minimum: 0
      required:
        - tier
        - cents
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````