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

# Set organization spending cap

> Set a positive monthly USD cap, to six decimal places. Reservations count toward admission. Requires spend_limits:write.



## OpenAPI

````yaml /openapi.json post /v1/organization/spend_limit
openapi: 3.1.0
info:
  title: Limitless API
  version: 0.2.0
  description: >-
    Customer inference, scoped organization administration, policies, and health
    probes for Limitless at https://trylimitless.ai. This deployment uses
    sandbox credits and test payments but sends real inference requests. Model
    features depend on the active backend. The OpenAI SDK base URL is
    https://trylimitless.ai/v1.
servers:
  - url: https://trylimitless.ai
    description: >-
      Limitless sandbox API: test payments and real inference. OpenAI SDK
      clients add /v1 to this origin.
security:
  - customerKey: []
tags:
  - name: Health
  - name: Models
  - name: Inference
  - name: Credits
  - name: Organization
  - name: Projects
  - name: Project keys
  - name: Admin keys
  - name: Spending limits
  - name: Reports
  - name: Policies
paths:
  /v1/organization/spend_limit:
    post:
      tags:
        - Spending limits
      summary: Set organization spending cap
      description: >-
        Set a positive monthly USD cap, to six decimal places. Reservations
        count toward admission. Requires spend_limits:write.
      operationId: updateOrganizationSpendLimit
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdministrationSetSpendLimitRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdministrationSpendLimit'
          description: Successful response.
          headers:
            X-Request-ID:
              description: Gateway request ID for Activity and support.
              schema:
                type: string
                format: uuid
        '400':
          $ref: '#/components/responses/Api400'
        '401':
          $ref: '#/components/responses/Api401'
        '403':
          $ref: '#/components/responses/Api403'
        '404':
          $ref: '#/components/responses/Api404'
        '409':
          $ref: '#/components/responses/Api409'
        '413':
          $ref: '#/components/responses/Api413'
        '422':
          $ref: '#/components/responses/Api422'
        '429':
          $ref: '#/components/responses/Api429'
        '500':
          $ref: '#/components/responses/Api500'
        '503':
          $ref: '#/components/responses/Api503'
      security:
        - adminKey: []
components:
  schemas:
    AdministrationSetSpendLimitRequest:
      properties:
        amount_usd:
          anyOf:
            - type: number
              exclusiveMinimum: 0
            - type: string
              pattern: >-
                ^(?!^[-+.]*$)[+-]?0*(?:\d{0,12}|(?=[\d.]{1,19}0*$)\d{0,12}\.\d{0,6}0*$)
          description: >-
            Monthly USD cap, positive and no greater than 1,000,000, with at
            most six decimal places.
        alert_threshold_basis_points:
          anyOf:
            - type: integer
              maximum: 10000
              minimum: 0
            - type: 'null'
          description: >-
            Optional threshold metadata from 0 to 10,000. This release does not
            send threshold notifications.
      type: object
      required:
        - amount_usd
    AdministrationSpendLimit:
      properties:
        id:
          type: string
          format: uuid
        object:
          type: string
          const: organization.spend_limit
          default: organization.spend_limit
        scope:
          type: string
          enum:
            - organization
            - project
        project_id:
          anyOf:
            - type: string
            - type: 'null'
        amount_usd:
          type: string
          description: >-
            Monthly USD cap, positive and no greater than 1,000,000, with at
            most six decimal places.
        period:
          type: string
          const: monthly
          default: monthly
        status:
          type: string
          const: active
          default: active
        alert_threshold_basis_points:
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            Optional threshold metadata from 0 to 10,000. This release does not
            send threshold notifications.
        created_at:
          type: integer
        updated_at:
          type: integer
      type: object
      required:
        - id
        - scope
        - amount_usd
        - created_at
        - updated_at
    ErrorResponse:
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
      type: object
      required:
        - error
    ErrorDetail:
      properties:
        code:
          type: string
        message:
          type: string
        type:
          type: string
          description: Error category; policy failures use policy_error.
        param:
          anyOf:
            - type: string
            - type: 'null'
        request_id:
          type: string
        doc_url:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - code
        - message
        - type
  responses:
    Api400:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: Request validation failed.
      headers:
        X-Request-ID:
          description: Gateway request ID for Activity and support.
          schema:
            type: string
            format: uuid
    Api401:
      headers:
        X-Request-ID:
          description: Gateway request ID for Activity and support.
          schema:
            type: string
            format: uuid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: Missing or invalid credential.
    Api403:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: Credential scope or policy denied this operation.
      headers:
        X-Request-ID:
          description: Gateway request ID for Activity and support.
          schema:
            type: string
            format: uuid
    Api404:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: Resource or model not found in the caller’s organization.
      headers:
        X-Request-ID:
          description: Gateway request ID for Activity and support.
          schema:
            type: string
            format: uuid
    Api409:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: Revision, state or idempotency conflict.
      headers:
        X-Request-ID:
          description: Gateway request ID for Activity and support.
          schema:
            type: string
            format: uuid
    Api413:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: JSON body exceeds the gateway size limit.
      headers:
        X-Request-ID:
          description: Gateway request ID for Activity and support.
          schema:
            type: string
            format: uuid
    Api422:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: Provider request validation failed.
      headers:
        X-Request-ID:
          description: Gateway request ID for Activity and support.
          schema:
            type: string
            format: uuid
    Api429:
      headers:
        X-Request-ID:
          description: Gateway request ID for Activity and support.
          schema:
            type: string
            format: uuid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: Request rate or concurrency exceeded.
    Api500:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: Unexpected gateway failure.
      headers:
        X-Request-ID:
          description: Gateway request ID for Activity and support.
          schema:
            type: string
            format: uuid
    Api503:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: A required service or configuration is unavailable.
      headers:
        X-Request-ID:
          description: Gateway request ID for Activity and support.
          schema:
            type: string
            format: uuid
  securitySchemes:
    customerKey:
      type: http
      scheme: bearer
      bearerFormat: lk_...
      description: >-
        Project customer key. Requires the permission for the requested
        endpoint.
    adminKey:
      type: http
      scheme: bearer
      bearerFormat: lka_...
      description: >-
        Organization Admin API key with an appropriate scope. Customer keys
        cannot call organization routes.

````

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