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

# Reset a customer's allowance windows

> Closes the scope's OPEN rolling allowance windows, so the customer's next call anchors a fresh instance with a full allowance. The only thing that hands an allowance back early. Answers 200 with `closed_windows: 0` when nothing was open; 400 (`unsupported_mode`) when the scope is not in windows mode.



## OpenAPI

````yaml post /v1/ai/billing/customers/{customer_id}/windows/reset
openapi: 3.1.0
info:
  title: Hyperline API
  version: 0.0.0
servers:
  - url: https://api.hyperline.co
  - url: https://sandbox.api.hyperline.co
security: []
paths:
  /v1/ai/billing/customers/{customer_id}/windows/reset:
    post:
      tags:
        - AI > Billing
      summary: Reset a customer's allowance windows
      description: >-
        Closes the scope's OPEN rolling allowance windows, so the customer's
        next call anchors a fresh instance with a full allowance. The only thing
        that hands an allowance back early. Answers 200 with `closed_windows: 0`
        when nothing was open; 400 (`unsupported_mode`) when the scope is not in
        windows mode.
      operationId: resetAgentCustomerWindows
      parameters:
        - schema:
            type: string
          required: true
          name: customer_id
          in: path
        - schema:
            type: string
            minLength: 1
            maxLength: 128
            description: >-
              Agent scope identifier. Null on scoped results denotes the
              customer's shared pool.
            example: support
          required: false
          description: >-
            Agent scope identifier. Null on scoped results denotes the
            customer's shared pool.
          name: agent
          in: query
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  agent:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Agent scope identifier. Null on scoped results denotes the
                      customer's shared pool.
                    example: support
                  closed_windows:
                    type: number
                    description: Number of closed windows.
                    example: 1
                  meters:
                    type: array
                    items:
                      type: object
                      properties:
                        key:
                          type: string
                          description: >-
                            Dimension or allowance identifier used by usage
                            payloads and meter results.
                          example: cached_input_tokens
                        included_units:
                          type: string
                          pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i
                          description: >-
                            Weighted units included in one allowance window, as
                            an exact decimal string.
                          example: '10000'
                        used_units:
                          type: string
                          pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i
                          description: >-
                            Allowance units already consumed in the current
                            window.
                          example: '2500'
                        remaining_units:
                          type: string
                          pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i
                          description: Unconsumed allowance units, clamped at zero.
                          example: '7500'
                        window_started_at:
                          type:
                            - string
                            - 'null'
                          format: date-time
                          description: >-
                            Window started at, as a UTC ISO 8601 timestamp. Null
                            when unavailable.
                          example: '2026-09-02T00:00:00Z'
                        resets_at:
                          type:
                            - string
                            - 'null'
                          format: date-time
                          description: >-
                            Resets at, as a UTC ISO 8601 timestamp. Null when
                            unavailable.
                          example: '2026-09-03T00:00:00Z'
                      required:
                        - key
                        - included_units
                        - used_units
                        - remaining_units
                        - window_started_at
                        - resets_at
                    description: >-
                      Current state of every rolling allowance window, or null
                      outside windows mode.
                    example:
                      - key: daily
                        included_units: '10000'
                        used_units: '2500'
                        remaining_units: '7500'
                        window_started_at: '2026-09-02T00:00:00Z'
                        resets_at: '2026-09-03T00:00:00Z'
                required:
                  - agent
                  - closed_windows
                  - meters
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
        '404':
          description: Policy not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
        '409':
          description: The request conflicts with the current configuration.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
      security:
        - bearer: []
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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