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

# Change your usage summary email

> Turns your own usage summary email off, or sets it to daily or weekly.

> [accordion] Details
>
> It goes to the email you sign in with: a daily one shortly after each UTC day ends, a weekly one on UTC Mondays for the Monday to Sunday before. It has the calls and top integrations; an Owner's or Admin's also has the billing period's estimated overage, and a Member's never has dollars. A new choice starts with the next day or week.
>
> * An Owner or Admin may also set dollar\_alerts to turn their own usage alert emails in dollars on or off. An overage or % of overage budget alert emails an Owner or Admin it names, or reaches by role, only while they have it on. It is off until you turn it on, and only you can turn yours on. A Member, or an API key without team:manage, is refused it.
>
> * Each change is recorded in your team's audit log. A field you leave out stays as it is.
>
> * An API key needs jobs:read.
>
> * **Callers:** an API key, an MCP OAuth token or a Dashboard session.
>
> * **Permission:** any signed-in member, for their own records; an API key also needs `jobs:read`.
>
> * **Effect:** Creates or changes something.
>
> * **Errors:** [`business_account_required`](https://docs.pomerado.ai/errors#business_account_required), [`role_permission_missing`](https://docs.pomerado.ai/errors#role_permission_missing), [`key_permission_missing`](https://docs.pomerado.ai/errors#key_permission_missing), and the [errors any request can get](https://docs.pomerado.ai/errors.md).


## OpenAPI

````yaml /api-reference/openapi.json patch /v1/usage/summary
openapi: 3.1.0
info:
  title: Pomerado API
  version: '1'
  description: >-
    Run and build website tools, follow their jobs, and manage logins, API keys
    and webhooks. Authenticate with a Pomerado API key (pom_…), an MCP OAuth
    token or a Dashboard session as a Bearer token.
servers:
  - url: https://api.pomerado.ai
security: []
tags:
  - name: account
    x-group: Account
  - name: api_keys
    x-group: API keys
  - name: connected_apps
    x-group: Connected apps
  - name: usage
    x-group: Usage
  - name: quota
    x-group: Quota
  - name: spend_controls
    x-group: Spend controls
  - name: usage_alerts
    x-group: Usage alerts
  - name: usage_summary
    x-group: Usage summary
  - name: billing
    x-group: Billing
  - name: integrations
    x-group: Integrations
  - name: connect
    x-group: Connect
  - name: code
    x-group: Code
  - name: logins
    x-group: Saved logins
  - name: two_factor
    x-group: 2FA
  - name: login_access
    x-group: Login access
  - name: tools
    x-group: Tools
  - name: shapes
    x-group: Shapes
  - name: webhooks
    x-group: Webhooks
  - name: payer_profiles
    x-group: Payer profiles
  - name: payer_addresses
    x-group: Payer addresses
  - name: payment_methods
    x-group: Payment methods
  - name: runs
    x-group: Runs
  - name: builds
    x-group: Builds
  - name: jobs
    x-group: Jobs
  - name: suggestions
    x-group: Suggestions
  - name: audit
    x-group: Audit
  - name: files
    x-group: Files
  - name: team
    x-group: Team
  - name: sso
    x-group: Single sign-on
  - name: issue_reports
    x-group: Problem reports
paths:
  /v1/usage/summary:
    patch:
      tags:
        - usage_summary
      summary: Change your usage summary email
      description: Turns your own usage summary email off, or sets it to daily or weekly.
      operationId: usage_summary.update
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              required: []
              properties:
                frequency:
                  type: string
                  enum:
                    - 'off'
                    - daily
                    - weekly
                dollar_alerts:
                  type: boolean
                  description: >-
                    Owners and Admins only: turn your own dollar alert emails on
                    or off
              additionalProperties: false
      responses:
        '200':
          description: Your usage summary
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsageSummary'
        '400':
          description: invalid_request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: unauthorized, reauthentication_required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: >-
            business_account_required, forbidden, role_permission_missing,
            key_permission_missing
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '413':
          description: request_too_large
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: internal_error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: temporarily_unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearer: []
components:
  schemas:
    UsageSummary:
      type: object
      required:
        - frequency
      properties:
        frequency:
          type: string
          enum:
            - 'off'
            - daily
            - weekly
          description: Your own summary email
        members:
          type: array
          items:
            type: object
            required:
              - member_id
              - name
              - email
              - frequency
            properties:
              member_id:
                type: string
                description: The member's user ID
              name:
                anyOf:
                  - type: string
                  - type: 'null'
              email:
                anyOf:
                  - type: string
                  - type: 'null'
              frequency:
                type: string
                enum:
                  - daily
                  - weekly
            additionalProperties: false
          description: >-
            Owners and Admins only: every member who gets a summary, and how
            often. Absent for anyone else
        dollar_alerts:
          type: boolean
          description: >-
            Owners and Admins only: whether you get usage alert emails in
            dollars (overage and % of overage budget alerts). Off until you turn
            it on. Absent for anyone else
      additionalProperties: false
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - retryable
            - docs_url
          properties:
            code:
              type: string
            message:
              type: string
            retryable:
              type: boolean
            docs_url:
              type: string
            details:
              type: object
              required: []
              properties: {}
              additionalProperties:
                $id: /schemas/unknown
          additionalProperties: false
      additionalProperties: false
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.