---
title: "SetOrganizationQuota"
method: POST
path: "/factify.api.v1beta.QuotaService/SetOrganizationQuota"
tags: ["Quotas"]
---

# SetOrganizationQuota

`POST /factify.api.v1beta.QuotaService/SetOrganizationQuota`

SetOrganizationQuota creates or updates quota configuration for an organization.
 Requires platform admin permission. ConnectRPC only (not exposed via REST).

## Headers

- `Connect-Protocol-Version` 1, required — Define the version of the Connect protocol
- `Connect-Timeout-Ms` number — Define the timeout, in ms

## Request body

- SetOrganizationQuotaRequest — SetOrganizationQuotaRequest is a request to set quota configuration.
  - `limit` integer, nullable — Optional limit override. If not set, uses the configured tier default. Must be > 0 when set. Use a very high value (e.g., 999999999) for unlimited.
  - `organization_id` string — The organization ID (required).
  - `tier` 'free' | 'custom'

## Response `200`

Success

- SetOrganizationQuotaResponse — SetOrganizationQuotaResponse returns the updated quota configuration.
  - `quota` OrganizationQuotaConfig — OrganizationQuotaConfig represents the stored quota configuration (not current usage).
    - `created_at` string, date-time — When the configuration was created.
    - `effective_limit` integer — The effective limit (limit if set, otherwise tier default).
    - `limit` integer, nullable — Optional limit override. If not set, uses the configured tier default.
    - `organization_id` string — The organization ID.
    - `tier` 'free' | 'custom'
    - `updated_at` string, date-time — When the configuration was last updated.

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication failed - missing or invalid API key
- `403` — Authorization failed - valid key but insufficient permissions
- `404` — Resource not found
- `429` — Too many requests
- `500` — Internal server error
- `default` — Error

## Changes

- **2026-03-16** `cb42a69ce465` — 1 breaking
  - the request property `limit` became not nullable

[Change history](https://skmtc.dev/factify-inc/apis/factify-api/changes/factify.api.v1beta.QuotaService/SetOrganizationQuota/post.md)

---

[API](https://skmtc.dev/factify-inc/apis/factify-api.md) · [All operations](https://skmtc.dev/factify-inc/apis/factify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/factify-inc/factify-api/revisions/ebe16ef03cb2/schema)