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

# Change price

> Change what a client pays. It applies from their next invoice.

Send `price_usd`, `ai_usd`, or both. A paying client moves to the new amount on their next invoice, with no proration. A link not paid yet is replaced at the new price.

Use your account-wide API key. A client’s own key gets `403` here. See [Invoicing](/guides/invoicing).

## Path parameters

<ParamField path="id" type="string" required>
  The client’s `id`.
</ParamField>

## Body

<ParamField body="price_usd" type="number">
  The new monthly price.
</ParamField>

<ParamField body="ai_usd" type="number">
  The new monthly AI amount. `0` removes it.
</ParamField>

## Response

<ResponseField name="billing" type="object">
  As [Get billing](/api-reference/clients/get-billing).
</ResponseField>

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -X PATCH https://www.orgo.ai/api/v1/accounts/$CLIENT_ID/billing \
    -H "Authorization: Bearer $ORGO_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"price_usd": 300}'
  ```

  ```python Python theme={null}
  import os
  import requests

  client_id = os.environ["CLIENT_ID"]

  res = requests.patch(
      f"https://www.orgo.ai/api/v1/accounts/{client_id}/billing",
      headers={"Authorization": f"Bearer {os.environ['ORGO_API_KEY']}"},
      json={"price_usd": 300},
  )
  print(res.json())
  ```

  ```javascript JavaScript theme={null}
  const clientId = process.env.CLIENT_ID;

  const res = await fetch(`https://www.orgo.ai/api/v1/accounts/${clientId}/billing`, {
    method: 'PATCH',
    headers: { Authorization: `Bearer ${process.env.ORGO_API_KEY}`, 'Content-Type': 'application/json' },
    body: JSON.stringify({"price_usd": 300}),
  });
  console.log(await res.json());
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "billing": {
    "status": "active",
    "email": "billing@acme.com",
    "price_usd": 300,
    "setup_fee_usd": 0,
    "ai_usd": 40,
    "payment_link_url": null,
    "current_period_end": "2026-11-01T09:00:00Z",
    "ends_at_period_end": false
  }
}
```

## Errors

| Status | Body | Meaning |
| - | - | - |
| `401` | `{ "error": "Invalid API key" }` | No key, or not one of yours. |
| `403` | `{ "error": "Use your account-wide API key to manage accounts. Workspace keys can’t." }` | A client’s own key, or any key scoped to one workspace. |
| `403` | `{ "error": "Invoicing is on every paid plan. Upgrade to use it." }` | You’re on the Free plan. `code` is `UPGRADE_REQUIRED`. |
| `400` | `{ "error": "Send price_usd, ai_usd, or both." }` | Nothing to change. |
| `409` | `{ "error": "This client isn’t being billed. Send them a link first." }` | You pay for this client. |
| `404` | `{ "error": "Account not found." }` | No client with this id is yours. |
| `409` | `{ "error": "This account is closed." }` | The client is closed. `code` is `ACCOUNT_CLOSED`. |
| `409` | `{ "error": "This account was transferred to your client." }` | The client accepted a transfer and owns it now. `code` is `ACCOUNT_TRANSFERRED`. |


## OpenAPI

````yaml PATCH /v1/accounts/{id}/billing
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: 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: 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:
  /v1/accounts/{id}/billing:
    patch:
      tags:
        - Clients
      summary: Change price
      description: Change what a client pays. It applies from their next invoice.
      operationId: updateClientBilling
      parameters:
        - name: id
          in: path
          required: true
          description: The client’s `id`.
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                price_usd:
                  type: number
                  description: The new monthly price.
                ai_usd:
                  type: number
                  description: The new monthly AI amount. `0` removes it.
            example:
              price_usd: 300
      responses:
        '200':
          description: OK
          content:
            application/json:
              example:
                billing:
                  status: active
                  email: billing@acme.com
                  price_usd: 300
                  setup_fee_usd: 0
                  ai_usd: 40
                  payment_link_url: null
                  current_period_end: '2026-11-01T09:00:00Z'
                  ends_at_period_end: false
              schema:
                $ref: '#/components/schemas/BillingEnvelope'
        '400':
          description: Nothing to change.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                e1:
                  summary: Nothing to change
                  value:
                    error: Send price_usd, ai_usd, or both.
        '401':
          description: No key, or not one of yours.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                e1:
                  summary: No key, or not one of yours
                  value:
                    error: Invalid API key
        '403':
          description: >-
            A client’s own key, or any key scoped to one workspace. You’re on
            the Free plan. `code` is `UPGRADE_REQUIRED`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                e1:
                  summary: A client’s own key, or any key scoped to one workspace
                  value:
                    error: >-
                      Use your account-wide API key to manage accounts.
                      Workspace keys can’t.
                e2:
                  summary: You’re on the Free plan
                  value:
                    error: Invoicing is on every paid plan. Upgrade to use it.
        '404':
          description: No client with this id is yours.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                e1:
                  summary: No client with this id is yours
                  value:
                    error: Account not found.
        '409':
          description: >-
            You pay for this client. The client is closed. `code` is
            `ACCOUNT_CLOSED`. The client accepted a transfer and owns it now.
            `code` is `ACCOUNT_TRANSFERRED`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                e1:
                  summary: You pay for this client
                  value:
                    error: This client isn’t being billed. Send them a link first.
                e2:
                  summary: The client is closed
                  value:
                    error: This account is closed.
                e3:
                  summary: The client accepted a transfer and owns it now
                  value:
                    error: This account was transferred to your client.
components:
  schemas:
    BillingEnvelope:
      type: object
      properties:
        billing:
          type: object
          nullable: true
          properties:
            status:
              type: string
              enum:
                - sent
                - active
                - past_due
            email:
              type: string
            price_usd:
              type: number
            setup_fee_usd:
              type: number
            ai_usd:
              type: number
            payment_link_url:
              type: string
              nullable: true
            current_period_end:
              type: string
              format: date-time
              nullable: true
            ends_at_period_end:
              type: boolean
    Error:
      type: object
      description: >-
        The base error body. Every failure carries `error`; individual endpoints
        add the fields named in the schemas below.
      required:
        - error
      properties:
        error:
          type: string
          description: Human-readable message.
          example: Access denied
        code:
          type: string
          description: >-
            Machine-readable reason. Present on the failures that define one,
            absent otherwise.
  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.