> ## Documentation Index > Fetch the complete documentation index at: https://runcrate.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Update auto-recharge > Turns auto-recharge on or off and sets its threshold and target, with the dashboard's rules. Needs the billing permission on the key or sign-in, and the person behind it must be a workspace owner or manager. `threshold_usd` and `target_usd` are required even to turn it off. ## OpenAPI ````yaml /api-reference/openapi.json put /billing/auto-recharge openapi: 3.1.0 info: title: Runcrate API version: 1.0.0 summary: OpenAI-compatible inference API + GPU infrastructure API. description: >- Runcrate exposes two API surfaces. The inference API at `https://api.runcrate.ai/v1` is OpenAI-compatible: it accepts the standard OpenAI SDK with the base URL changed. The infrastructure API at `https://www.runcrate.ai/api/v1` manages GPU instances, jobs, persistent volumes, environments, SSH keys, templates, and billing. Both share a single `rc_live_*` API key. Pricing is per-token, per-image, per-second, or per-minute on the inference API (varies by model; see https://www.runcrate.ai/api/models/catalog for live rates) and per-second on GPU rentals (see https://www.runcrate.ai/pricing for hourly rates per GPU class). All infrastructure API responses are wrapped in `{ "data": ... }`. List responses also include a `meta` object with pagination cursors. Error responses use `{ "error": { "code": "...", "message": "..." } }`. termsOfService: https://www.runcrate.ai/terms contact: name: Runcrate url: https://www.runcrate.ai/contact license: name: Proprietary url: https://www.runcrate.ai/terms servers: - url: https://api.runcrate.ai/v1 description: Inference API (OpenAI-compatible) - url: https://www.runcrate.ai/api/v1 description: >- Infrastructure API (instances, jobs, storage, environments, ssh-keys, templates, billing) security: - ApiKeyAuth: [] tags: - name: Chat description: OpenAI-compatible chat completions. - name: Messages description: Anthropic-compatible Messages API, for Claude Code and the Anthropic SDKs. - name: Responses description: >- OpenAI-compatible Responses API, for Codex and responses.create. Nothing is stored. - name: Images description: Text-to-image generation. - name: Videos description: Async text-to-video and image-to-video generation. - name: Audio description: Text-to-speech and speech-to-text. - name: Embeddings description: Vector embeddings for RAG and search. - name: Models description: Model catalog discovery. - name: Instances description: GPU instance lifecycle. - name: Jobs description: >- Run one command on its own GPU machine. The machine stops, and billing ends, when the command exits. - name: Schedules description: >- Start an instance or a job later: once at a set time, or on a repeating cron schedule in your timezone. - name: Clusters description: >- Multi-machine GPU clusters on a private network, with Slurm, Kubernetes or Ray, bought by the machine. All or nothing: every machine starts or none does, billed from when every machine is up. - name: Storage description: Persistent volume management. - name: Environments description: Resource isolation containers within a workspace. - name: Secrets description: >- Names of the secrets an environment's machines get. Values are set in the dashboard and never returned. - name: SSH Keys description: SSH key management for instance access. - name: Templates description: Pre-built instance images and configurations. - name: Billing description: >- Credit balance and runway, top-ups, auto-recharge, payment methods, transactions, usage metrics. - name: Model calls description: >- The log of calls to the inference API, kept 30 days: outcome, timing, tokens, cost, end user, session and tags. Never the prompt or the answer. paths: /billing/auto-recharge: servers: - url: https://www.runcrate.ai/api/v1 put: tags: - Billing summary: Update auto-recharge description: >- Turns auto-recharge on or off and sets its threshold and target, with the dashboard's rules. Needs the billing permission on the key or sign-in, and the person behind it must be a workspace owner or manager. `threshold_usd` and `target_usd` are required even to turn it off. operationId: updateAutoRecharge requestBody: required: true content: application/json: schema: type: object required: - enabled - threshold_usd - target_usd properties: enabled: type: boolean example: true threshold_usd: type: number minimum: 20 maximum: 5000 description: Top up when the balance falls below this, in USD. example: 25 target_usd: type: number minimum: 50 maximum: 10000 description: >- Top up to this balance, in USD. Above `threshold_usd`, and at most the key's daily top-up cap. example: 100 example: enabled: true threshold_usd: 25 target_usd: 100 responses: '200': description: The saved settings. content: application/json: schema: type: object required: - data properties: data: $ref: '#/components/schemas/AutoRecharge' example: data: enabled: true threshold_usd: 25 target_usd: 100 last_failure_reason: null last_failure_at: null '401': $ref: '#/components/responses/Unauthorized' '402': description: >- `TOPUP_CAP_REACHED`: `target_usd` is above the key's daily top-up cap (`details.cap_usd`). `NO_PAYMENT_METHOD`: there is no saved default card to turn it on with. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: TOPUP_CAP_REACHED message: >- target_usd can be at most this key's daily top-up cap, $250.00. An owner or manager can raise the cap on the API keys page. details: cap: daily cap_usd: 250 '403': description: >- `BILLING_PERMISSION_REQUIRED`: this key or sign-in does not have the billing permission. `forbidden`: the person behind it is not an owner or manager. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: forbidden message: >- Only an owner or manager of the workspace can change auto-recharge, and this key or sign-in belongs to a member. '422': $ref: '#/components/responses/ValidationError' components: schemas: AutoRecharge: type: object required: - enabled - threshold_usd - target_usd - last_failure_reason - last_failure_at properties: enabled: type: boolean example: true threshold_usd: type: number nullable: true description: A top-up starts when the balance falls below this, in USD. example: 25 target_usd: type: number nullable: true description: The balance a top-up brings it back up to, in USD. example: 100 last_failure_reason: type: string nullable: true description: >- Why the last automatic top-up failed (for example `card_declined`), until the settings are saved again. example: null last_failure_at: type: string format: date-time nullable: true example: null Error: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string description: >- Machine-readable error code (e.g. `validation_error`, `unauthorized`, `not_found`, `insufficient_credits`, `rate_limited`, `internal_error`). message: type: string description: Human-readable error message. details: type: object additionalProperties: true description: Optional structured error context. responses: Unauthorized: description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/Error' ValidationError: description: Request shape or values failed validation. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: ApiKeyAuth: type: http scheme: bearer description: >- Use a Runcrate API key with the `rc_live_*` prefix as the bearer token. Create one at https://www.runcrate.ai/dashboard/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.