Sign inGet Started
Inizia ora
Guide
Riferimento API
SDK
CLI
Knowledge Base
Changelog

List workspace quotas

GET
/v1/workspace/quotas
const { data } = await bird.workspace.quotas.list();
for (const quota of data) {
  console.log(quota.key, quota.limit, quota.organization_limit);
}
Risposta200
{
  "data": [
    {
      "key": "email_mailboxes_max",
      "unit": "mailboxes",
      "kind": "counted",
      "enforcement": "create",
      "organization_source": "default",
      "workspace_limit": {
        "status": "active"
      },
      "usage": {
        "status": "available"
      }
    }
  ],
  "configuration": "available"
}

Returns each resource and value quota as it applies to the current workspace: the organization limit shared by all workspaces, the workspace's own limit when one is set, and this workspace's current usage. Organization usage and shared remaining capacity are withheld: organization_used, organization_remaining and remaining are always null on this endpoint.

A workspace limit is a ceiling, not reserved capacity. Each quota's enforcement says how both limits apply: create refuses a creation that would pass either one, outbound_send refuses outbound sends once the bytes already held reach either one, and value bounds a setting when it is chosen. usage is null for a value quota. When usage cannot be read, usage.status is unavailable and the counts are null.

Payload di risposta

data
array of object
obbligatorio
Mostra attributi secondari
data.key
string
obbligatorio

Stable key of the quota.

data.name
string
obbligatorio
data.description
string
obbligatorio
data.unit
string
obbligatorio

What the limit counts, such as mailboxes, bytes or days.

data.kind
string
obbligatorio

What the quota limits.

  • counted: an amount the workspace accumulates, such as mailboxes or stored bytes. Usage is reported.
  • value: the largest setting a resource may be given, such as a retention period. No usage is counted.

Possible values: counted, value

data.enforcement
string
obbligatorio

When the limits are applied.

  • create: a request that would add more than the limits allow is refused, and nothing is created.
  • outbound_send: sending is refused once the bytes already stored reach a limit. The size of the message being sent is not counted in advance, and incoming mail is still accepted.
  • value: a setting above the limit is refused when it is chosen. Existing resources keep their settings.

Possible values: create, outbound_send, value

data.maximum_value
integer
obbligatorio

The largest workspace limit this quota accepts, in its unit.

data.organization_limit
integer
obbligatorio

The organization's limit, shared by all its workspaces.

data.organization_source
string
obbligatorio

Where the organization limit comes from.

  • default: Bird's standard limit.
  • plan: the organization's plan.
  • override: a limit Bird set for the organization.

Possible values (may grow over time): default, plan, override

data.workspace_limit
nullable object
obbligatorio

The workspace's own limit. null when the workspace has none and uses only the shared organization limit.

Mostra attributi secondari
data.limit
integer
obbligatorio

The lower of the organization limit currently applied to requests and any active workspace limit. The applied organization limit can briefly differ from the configured organization_limit after a change. A request can still be refused below this value when other workspaces use the shared organization limit.

data.usage
nullable object
obbligatorio

Current usage. null for a value quota, which counts nothing.

Mostra attributi secondari
data.usage.status
string
obbligatorio

Whether current usage could be read.

  • available: the counts reflect usage at observed_at.
  • unavailable: usage could not be read. The counts are unknown, not zero.

Possible values: available, unavailable

data.usage.observed_at
string
obbligatorio

When usage was read.

data.usage.organization_limit
integer
obbligatorio

The organization limit requests were checked against when usage was read.

data.usage.organization_used
nullable integer
obbligatorio

The organization's total usage across all its workspaces. null on the current-workspace endpoint or when usage is unavailable.

data.usage.workspace_used
nullable integer
obbligatorio

This workspace's usage. null when usage is unavailable.

data.usage.organization_remaining
nullable integer
obbligatorio

How much more the whole organization can add, shared by all its workspaces. null on the current-workspace endpoint or when usage is unavailable.

data.usage.workspace_remaining
nullable integer
obbligatorio

How much more this workspace can add under its own limit. null when no workspace limit applies or usage is unavailable.

data.usage.remaining
nullable integer
obbligatorio

How much more this workspace can add now, the lower of organization_remaining and any workspace_remaining. null on the current-workspace endpoint or when usage is unavailable.

configuration
string
obbligatorio

Whether workspace limits can be set.

  • available: workspace limits can be set and changed.
  • unavailable: new workspace limits cannot be set in this region yet. Existing workspace limits still apply and can be removed.

Possible values: available, unavailable

Risorse correlate

Continua con la documentazione, le guide e gli esempi per questo argomento.

Ottieni un brief di implementazione