---
title: "Set Plan"
method: PUT
path: "/v1/usage/plan"
tags: ["usage-billing"]
---

# Set Plan

`PUT /v1/usage/plan`

## Request

- Base URL: `https://api.cybret.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cybret.ai/v1/usage/plan`
- Auth: HTTP bearer

## Request body

- SetPlanRequest
  - `plan_code` string, required
  - `limits` BudgetLimits, required
    - `concurrent_runs` integer
    - `provider_concurrency` object
    - `requests` integer, nullable
    - `browser_milliseconds` integer, nullable
    - `llm_microusd` integer, nullable
    - `storage_bytes` integer, nullable
    - `agent_tokens` integer, nullable
    - `fuzzer_executions` integer, nullable
    - `artifact_storage_bytes` integer, nullable
    - `retention_byte_days` integer, nullable
    - `worker_milliseconds` integer, nullable
    - `spending_ceiling_microusd` integer, nullable
  - `spending_ceiling_microusd` integer, nullable
  - `retention_days` integer
  - `billing_enabled` boolean

## Response `200`

Successful Response

- UsageDashboard
  - `tenant_id` string, required
  - `plan` UsagePlan, required
    - `tenant_id` string, required
    - `plan_code` string, required
    - `limits` BudgetLimits, required
      - `concurrent_runs` integer
      - `provider_concurrency` object
      - `requests` integer, nullable
      - `browser_milliseconds` integer, nullable
      - `llm_microusd` integer, nullable
      - `storage_bytes` integer, nullable
      - `agent_tokens` integer, nullable
      - `fuzzer_executions` integer, nullable
      - `artifact_storage_bytes` integer, nullable
      - `retention_byte_days` integer, nullable
      - `worker_milliseconds` integer, nullable
      - `spending_ceiling_microusd` integer, nullable
    - `spending_ceiling_microusd` integer, nullable
    - `retention_days` integer
    - `billing_enabled` boolean
    - `updated_at` string, date-time, required
    - `updated_by` string, required
  - `usage` BudgetUsage, required
    - `requests` integer
    - `browser_milliseconds` integer
    - `llm_microusd` integer
    - `storage_bytes` integer
    - `agent_tokens` integer
    - `fuzzer_executions` integer
    - `artifact_storage_bytes` integer
    - `retention_byte_days` integer
    - `worker_milliseconds` integer
    - `spent_microusd` integer
  - `spent_microusd` integer, required
  - `ceiling_microusd` integer, nullable
  - `billing_healthy` boolean, required
  - `active_override` BillingOverride
    - `override_id` string, required
    - `tenant_id` string, required
    - `actor_subject` string, required
    - `reason` string, required
    - `limits_patch` object
    - `spending_ceiling_microusd` integer, nullable
    - `expires_at` string, date-time, nullable
    - `created_at` string, date-time, required
    - `revoked_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cybret/apis/api-scanner-control-plane.md) · [All operations](https://skmtc.dev/cybret/apis/api-scanner-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/cybret/apis/api-scanner-control-plane/revisions/4c9b522246af?raw)