> ## Documentation Index > Fetch the complete documentation index at: https://docs.orgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Reduce capacity > Keep fewer added computers from the next renewal. Sets how many added computers the account keeps from its next renewal. The current period is already paid for, so the computers and the bill stay until then and drop together. Sending the current number undoes a pending reduction. ```bash theme={null} curl -X PATCH https://www.orgo.ai/api/account/capacity \ -H "Authorization: Bearer $ORGO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "added_computers": 20 }' ``` ```json theme={null} { "scheduled": { "added_computers": 20, "effective_at": "2026-11-01T00:00:00.000Z" }, "capacity": { "...": "as Get capacity" } } ``` Capacity a running computer stands on can't be given back: the answer is `409` with code `in_use` and `min_added_computers`. Delete computers first, then reduce. ## OpenAPI ````yaml PATCH /account/capacity openapi: 3.1.0 info: title: Orgo API description: >- Launch cloud computers that AI agents can control and interact with. Create workspaces, provision computers, and control them programmatically. version: 2.0.0 contact: name: Orgo Support email: spencer@orgo.ai url: https://orgo.ai servers: - url: https://www.orgo.ai/api description: Production security: - bearerAuth: [] tags: - name: Account description: >- Account capacity: how many computers an account may run, and adding or giving back more. - name: Workspaces description: Organize computers into named workspaces - name: Computers description: Provision and manage virtual computers - name: Computer Lifecycle description: Start, stop, and restart computers - name: Computer Actions description: Control mouse, keyboard, and execute commands - name: Screens description: >- More than one desktop on a single computer. Each screen is its own X server with its own cursor and window manager, so an agent working on one cannot disturb another. - name: Files description: Upload and download files - name: Templates description: Author, build, and launch reproducible computers from templates paths: /account/capacity: patch: tags: - Account summary: Reduce capacity description: >- Keeps `added_computers` added computers from the next renewal. The current period is paid for, so nothing changes until then; sending the current number undoes a pending reduction. operationId: reduceAccountCapacity requestBody: required: true content: application/json: schema: type: object required: - added_computers properties: added_computers: type: integer minimum: 0 description: How many added computers to keep. additionalProperties: false example: added_computers: 20 responses: '200': description: The scheduled reduction and the account's capacity. content: application/json: schema: type: object properties: scheduled: type: - object - 'null' properties: added_computers: type: integer effective_at: type: string format: date-time capacity: $ref: '#/components/schemas/AccountCapacity' '400': description: Invalid request. content: application/json: schema: type: object properties: error: type: string code: type: string '402': description: No subscription to change (`no_subscription`). content: application/json: schema: type: object properties: error: type: string code: type: string '409': description: >- Running computers use that capacity (`in_use`, with `min_added_computers`). Delete computers first. content: application/json: schema: type: object properties: error: type: string code: type: string components: schemas: AccountCapacity: type: object properties: plan: type: string description: The account's plan, such as `startup_v2`. computers: type: object description: >- How many computers the account may run (its plan plus what it has added) and runs. properties: limit: type: integer in_use: type: integer ram_gb: type: object description: The account-wide RAM pool and what its computers use. properties: limit: type: number in_use: type: number added: type: object properties: computers: type: integer ram_gb: type: number vcpu: type: number disk_gb: type: number description: What the account has added beyond its plan. self_serve_cap: type: object properties: computers: type: integer ram_gb: type: number vcpu: type: number disk_gb: type: number description: >- The most the account may add on its own. Past it, purchases return `403` `capacity_cap`; ask us and we raise it for the account. can_add: type: object description: >- How many more computers of each size the account may add now, under its cap. properties: small: type: integer medium: type: integer large: type: integer xl: type: integer 2xl: type: integer max_per_request: type: integer description: The most computers one purchase may add (500). sizes: type: array items: type: object properties: size: type: string enum: - small - medium - large - xl - 2xl ram_gb: type: number vcpu: type: number disk_gb: type: number monthly_usd: type: number terms: type: array items: type: string enum: - monthly - yearly windows_available: type: boolean has_subscription: type: boolean renews_at: type: - string - 'null' format: date-time scheduled_reduction: type: - object - 'null' properties: added_computers: type: integer effective_at: type: string format: date-time securitySchemes: bearerAuth: type: http scheme: bearer description: API key authentication. Get your key at orgo.ai/workspaces ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.