> ## 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.

# Get capacity

> How many computers the account has against its limit, its RAM and vCPU pools, and how much room of each size it may still add.

Reads the account's capacity: its computer limit and its pools, what it uses, what it has added beyond its plan, its self-serve cap, and how many more computers' worth of room of each size it may add right now. Use it before a purchase to know what fits, and after one to see the new limits.

> [!NOTE]
>
> Capacity is billed to the whole account, so this endpoint needs an account-wide API key. A workspace-scoped key returns `403` with code `account_key_required`.

```bash theme={null}
curl https://www.orgo.ai/api/account/capacity \
  -H "Authorization: Bearer $ORGO_API_KEY"
```

```json theme={null}
{
  "plan": "startup_v2",
  "computers": { "limit": 50, "in_use": 5, "total": 7, "baseline": 50, "ceiling": 999, "can_raise": true, "raise_available": true },
  "ram_gb": { "limit": 48, "in_use": 40 },
  "vcpu": { "limit": 12, "in_use": 10 },
  "added": { "computers": 0, "ram_gb": 16, "vcpu": 4, "disk_gb": 0 },
  "self_serve_cap": { "computers": 100, "ram_gb": 800, "vcpu": 200, "disk_gb": 4000 },
  "can_add": { "small": 196, "medium": 98, "large": 49, "xl": 24, "2xl": 0 },
  "max_per_request": 500,
  "sizes": [
    { "size": "small", "ram_gb": 4, "vcpu": 0.5, "disk_gb": 20, "monthly_usd": 13.5 },
    { "size": "medium", "ram_gb": 8, "vcpu": 2, "disk_gb": 40, "monthly_usd": 32 },
    { "size": "large", "ram_gb": 16, "vcpu": 4, "disk_gb": 80, "monthly_usd": 64 },
    { "size": "xl", "ram_gb": 32, "vcpu": 6, "disk_gb": 150, "monthly_usd": 118 },
    { "size": "2xl", "ram_gb": 64, "vcpu": 8, "disk_gb": 300, "monthly_usd": 215 }
  ],
  "rates": {
    "monthly": { "ram_gb_usd": 2.5, "vcpu_usd": 5, "disk_20gb_usd": 1, "computer_usd": 0, "windows_usd": 15 },
    "yearly": { "ram_gb_usd": 24, "vcpu_usd": 48, "disk_20gb_usd": 9.6, "computer_usd": 0, "windows_usd": 144 }
  },
  "per_computer_max": { "ram_gb": 64, "vcpu": 8, "disk_gb": 300 },
  "past_xl_allowed": false,
  "terms": ["monthly", "yearly"],
  "windows_available": true,
  "has_subscription": true,
  "renews_at": "2026-11-01T00:00:00.000Z",
  "scheduled_reduction": null
}
```

`computers.limit` and `computers.in_use` count plan computers: how many the plan funds, and how many plan computers the account has. Beside them is the account's one computer limit, which counts plan and hourly computers together, as described in [Computers per account](https://docs.orgo.ai/guides/account-limits.md#computers-per-account):

| Field | Meaning |
| - | - |
| `total` | Every computer the account has, plan and hourly, running or stopped. |
| `baseline` | 50 on every paid plan, or the account's own number. Past it, new computers run by the hour from credit. `null` when the account has no limit. |
| `ceiling` | The most the account can have: 999, or its own number when that is higher. |
| `can_raise` | `true` when your credit covers going past the baseline now, for a Medium Linux computer by the hour. `null` when the credit could not be read. |
| `raise_available` | `false` when credit can't raise the limit at all. |

`total`, `baseline`, `ceiling` and `can_raise` are `null`, and `raise_available` is `false`, when the limit could not be read.

`vcpu.limit` is `null` when the account has no vCPU limit. Each size's `vcpu` is what a computer of that size launches with and is billed at.

`rates` are the per-part prices every shape is billed at, so you can price any computer, or memory, vCPU and storage on their own, without a dry run. `computer_usd` is `0`: computer slots are no longer sold. `per_computer_max` is the largest any one computer can be. `past_xl_allowed` is whether this account may add computers past XL (more than 6 vCPU or 32 GB) itself; otherwise they're set up on request.

`can_add` is how many more computers' worth of each size's memory, vCPU and disk fit under the self-serve cap. It is room, not computers: buying it adds none to `total`. `can_add` at `0` means the account has reached its self-serve cap for RAM, vCPU or disk, or for `2xl` that `past_xl_allowed` is `false`. [Ask us](mailto:contact@orgo.ai) and we raise the cap for the account, at the same prices.


## OpenAPI

````yaml GET /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: contact@orgo.ai
    url: https://orgo.ai
servers:
  - url: https://www.orgo.ai/api
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Support
    description: >-
      Orgo’s support agent, for programs: ask how to do something in Orgo and
      get an answer with full URLs and copyable commands.
  - name: Account
    description: >-
      Account capacity: how many computers an account may run, and adding or
      giving back more. Residential data: what the account has left for
      residential IPs, and buying more from credits.
  - name: Agent accounts
    description: >-
      Accounts an AI agent makes for itself, and the claim link a person uses to
      take one over.
  - name: Clients
    description: >-
      Run Orgo for your clients from your own app: a workspace and scoped key
      each, billed to you or to them.
  - name: Workspaces
    description: Organize computers into named workspaces
  - name: Computers
    description: Provision and manage virtual computers
  - name: Public URLs
    description: Share an app running on a computer at an https address on orgo.dev.
  - 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
  - name: Chat
    description: Run an agent on a computer through OpenAI-compatible chat completions.
  - name: Workflows
    description: >-
      Routines that run the same way every time: a start, then steps. Make them
      from plain words or lines, check them, run them and follow their runs (in
      preview).
paths:
  /account/capacity:
    get:
      tags:
        - Account
      summary: Get account capacity
      description: >-
        The account's computer limit and its RAM and vCPU pools with what it
        uses, what it has added beyond its plan, its self-serve cap, how many
        more of each size it may add, and every size with its monthly price.
        Needs an account-wide API key: a workspace-scoped key returns `403`.
      operationId: getAccountCapacity
      responses:
        '200':
          description: The account's capacity.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountCapacity'
              example:
                plan: startup_v2
                computers:
                  limit: 50
                  in_use: 3
                  total: 3
                  baseline: 50
                  ceiling: 999
                  can_raise: true
                  raise_available: true
                ram_gb:
                  limit: 64
                  in_use: 24
                vcpu:
                  limit: 212
                  in_use: 202
                added:
                  computers: 0
                  ram_gb: 0
                  vcpu: 0
                  disk_gb: 0
                self_serve_cap:
                  computers: 500
                  ram_gb: 4000
                  vcpu: 200
                  disk_gb: 20000
                can_add:
                  small: 400
                  medium: 100
                  large: 50
                  xl: 33
                  2xl: 25
                max_per_request: 500
                sizes:
                  - size: medium
                    ram_gb: 8
                    vcpu: 2
                    disk_gb: 40
                    monthly_usd: 32
                terms:
                  - monthly
                  - yearly
                windows_available: true
                has_subscription: true
                renews_at: '2026-11-01T00:00:00.000Z'
                scheduled_reduction: null
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
        '403':
          description: A workspace-scoped key (`account_key_required`).
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
        '429':
          description: Rate limited. Retry after the `Retry-After` header.
          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: >-
            `limit` and `in_use` count plan computers: how many the plan funds
            and how many plan computers the account has. Beside them is the
            account's one computer limit, plan and hourly computers together:
            `total`, `baseline`, `ceiling`, `can_raise` and `raise_available`.
          properties:
            limit:
              type: integer
              description: How many plan computers the plan funds.
            in_use:
              type: integer
              description: The plan computers the account has.
            total:
              type:
                - integer
                - 'null'
              description: >-
                Every computer the account has, plan and hourly, running or
                stopped. `null` when it could not be read.
            baseline:
              type:
                - integer
                - 'null'
              description: >-
                50 on every paid plan, or the account's own number. Past it, new
                computers run by the hour from credit. `null` when the account
                has no limit, or it could not be read.
            ceiling:
              type:
                - integer
                - 'null'
              description: >-
                The most computers the account can have: 999, or its own number
                when that is higher (up to 9999). `null` when it could not be
                read.
            can_raise:
              type:
                - boolean
                - 'null'
              description: >-
                `true` when the credit covers going past the baseline now, for a
                Medium Linux computer by the hour. `null` when the credit could
                not be read.
            raise_available:
              type: boolean
              description: >-
                `false` when credit can't raise the limit at all, or it could
                not be read.
        ram_gb:
          type: object
          description: The account-wide RAM pool and what its computers use.
          properties:
            limit:
              type: number
            in_use:
              type: number
        vcpu:
          type: object
          description: >-
            The account vCPU pool and what its computers use. `limit` is `null`
            when there is no pool limit.
          properties:
            limit:
              type:
                - number
                - 'null'
            in_use:
              type: number
        added:
          type: object
          properties:
            computers:
              type: integer
              description: >-
                Computer slots bought before slots were retired. A purchase adds
                none.
            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' worth of each size's memory, vCPU and disk
            the account may add now, under its cap. It is room, not computers.
            `0` for `2xl` unless `past_xl_allowed`.
          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' worth 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
        rates:
          type: object
          description: >-
            Per-part prices for each term: every shape, and parts on their own,
            are billed at these.
          properties:
            monthly:
              type: object
              properties:
                ram_gb_usd:
                  type: number
                vcpu_usd:
                  type: number
                disk_20gb_usd:
                  type: number
                computer_usd:
                  type: number
                  description: 'Always `0`: computer slots are no longer sold.'
                windows_usd:
                  type: number
            yearly:
              type: object
              properties:
                ram_gb_usd:
                  type: number
                vcpu_usd:
                  type: number
                disk_20gb_usd:
                  type: number
                computer_usd:
                  type: number
                  description: 'Always `0`: computer slots are no longer sold.'
                windows_usd:
                  type: number
        per_computer_max:
          type: object
          description: The largest any one computer can be.
          properties:
            ram_gb:
              type: integer
            vcpu:
              type: number
            disk_gb:
              type: integer
        past_xl_allowed:
          type: boolean
          description: >-
            Whether this account may add computers past XL (over 6 vCPU or 32
            GB) itself. Otherwise they are set up on request.
  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.