---
title: "Get the workspace meeting-recording usage"
method: GET
path: "/v1/meetings/usage"
tags: ["meetings"]
---

# Get the workspace meeting-recording usage

`GET /v1/meetings/usage`

## Request

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

Concurrent recording slots in use vs the cap, monthly recorded minutes, and active recordings.

## Headers

- `X-Tenant-Id` string, nullable

## Response `200`

Successful Response

- MeetingUsageView: A workspace's live meeting-bot usage: slots in use vs the cap, monthly minutes, and active calls.
  - `enabled` boolean, required: Whether meeting recording is enabled for this workspace.
  - `slots_in_use` integer, required: Concurrent recording slots currently in use (requested + recording).
  - `max_concurrent` integer, required: The most bots this workspace may record at once (the slot cap).
  - `monthly_minutes_used` integer, required: Recorded minutes metered this calendar month.
  - `monthly_minutes_budget` integer, required: The workspace's recorded-minutes budget for the month.
  - `active_recordings` ActiveRecordingView[]: The currently-active recordings, oldest first.
    - `id` string, uuid, required
    - `title` string, nullable: The meeting's title, when one was given.
    - `platform` string, required: The meeting platform (e.g. 'Zoom', 'Google Meet'), or 'the meeting'.
    - `status` string, required: Lifecycle status: 'requested' (joining) or 'recording' (in the call).
    - `started_at` string, date-time, required: When the recording was requested (bot dispatched).
    - `requested_by_run` string, uuid, nullable: The agent run that requested this recording, when known.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden. Inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, TENANT_ACCESS_REQUIRED, ROLE_UNRESOLVED)
- `404`: Not found
- `422`: Validation error

---

[API](https://skmtc.dev/patricia/apis/patricia-api.md) · [All operations](https://skmtc.dev/patricia/apis/patricia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/patricia/apis/patricia-api/revisions/0dfb44495ea1?raw)