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

# Set user credits limits

> Set individual per-user credits limits for one or more users. Supports bulk updates (up to 100 users per request). Identify each user by email. Pass null for limit to remove an individual override.



## OpenAPI

````yaml https://api.factory.ai/api/v0/openapi.json put /api/v0/organization/usage/limits/users
openapi: 3.0.1
info:
  title: Factory Public API
  description: >-
    Public API for Factory platform. Requires authentication via the
    `Authorization: Bearer` header.
  version: 0.1.0
servers:
  - url: https://api.factory.ai/
    description: Production
security:
  - BearerAuth: []
paths:
  /api/v0/organization/usage/limits/users:
    put:
      tags:
        - Organization
      summary: Set user credits limits
      description: >-
        Set individual per-user credits limits for one or more users. Supports
        bulk updates (up to 100 users per request). Identify each user by email.
        Pass null for limit to remove an individual override.
      operationId: setUserLimits
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SetUserLimitsRequestBody'
      responses:
        '200':
          description: Response for status 200
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SetUserLimits200ResponseBody'
        '400':
          description: Response for status 400
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SetUserLimits400ResponseBody'
        '401':
          description: Response for status 401
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SetUserLimits401ResponseBody'
        '403':
          description: Response for status 403
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SetUserLimits403ResponseBody'
        '500':
          description: Response for status 500
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SetUserLimits500ResponseBody'
components:
  schemas:
    SetUserLimitsRequestBody:
      type: object
      properties:
        users:
          type: array
          items:
            type: object
            properties:
              email:
                type: string
                format: email
                description: User email address
              limit:
                type: integer
                minimum: 1000000
                nullable: true
                description: >-
                  Credits limit to set for this user (minimum 1,000,000). Pass
                  null to remove the individual override.
            required:
              - email
              - limit
            additionalProperties: false
          minItems: 1
          maxItems: 100
          description: >-
            Array of user limit entries (up to 100). Each identifies a user by
            email.
      required:
        - users
      additionalProperties: false
    SetUserLimits200ResponseBody:
      type: object
      properties:
        updated:
          type: array
          items:
            type: object
            properties:
              email:
                type: string
                format: email
                description: User email address
              limit:
                type: integer
                minimum: 0
                nullable: true
                description: The limit that was set, or null if the override was removed
            required:
              - email
              - limit
            additionalProperties: false
          description: Successfully updated user limits
        errors:
          type: array
          items:
            type: object
            properties:
              email:
                type: string
                description: Email that was provided
              error:
                type: string
                description: Error message
            required:
              - email
              - error
            additionalProperties: false
          description: Errors for users that could not be updated
      required:
        - updated
        - errors
      additionalProperties: false
    SetUserLimits400ResponseBody:
      type: object
      properties:
        detail:
          type: string
          description: Human-readable error message
        status:
          type: number
          description: HTTP status code
        title:
          type: string
          description: HTTP status title
        metadata:
          type: object
          additionalProperties: {}
          description: Additional error metadata
      required:
        - detail
        - status
        - title
      additionalProperties: false
    SetUserLimits401ResponseBody:
      type: object
      properties:
        detail:
          type: string
          description: Human-readable error message
        status:
          type: number
          description: HTTP status code
        title:
          type: string
          description: HTTP status title
        metadata:
          type: object
          additionalProperties: {}
          description: Additional error metadata
      required:
        - detail
        - status
        - title
      additionalProperties: false
    SetUserLimits403ResponseBody:
      type: object
      properties:
        detail:
          type: string
          description: Human-readable error message
        status:
          type: number
          description: HTTP status code
        title:
          type: string
          description: HTTP status title
        metadata:
          type: object
          additionalProperties: {}
          description: Additional error metadata
      required:
        - detail
        - status
        - title
      additionalProperties: false
    SetUserLimits500ResponseBody:
      type: object
      properties:
        detail:
          type: string
          description: Human-readable error message
        status:
          type: number
          description: HTTP status code
        title:
          type: string
          description: HTTP status title
        metadata:
          type: object
          additionalProperties: {}
          description: Additional error metadata
      required:
        - detail
        - status
        - title
      additionalProperties: false
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: Factory API key or JWT token for authentication

````