---
title: "Get workspace usage data"
method: GET
path: "/api/v1/w/{wId}/workspace-usage"
tags: ["Workspace"]
deprecated: true
---

# Get workspace usage data

`GET /api/v1/w/{wId}/workspace-usage`

> **Deprecated.**

Deprecated: this endpoint will be removed after 2026-07-01.
Use GET /api/v1/w/{wId}/analytics/export instead.

Get usage data for the workspace identified by {wId} in CSV or JSON format.

## Path parameters

- `wId` string, required

## Query parameters

- `start` string, required
- `end` string
- `mode` 'month' | 'range', required
- `format` 'csv' | 'json'
- `table` 'users' | 'assistant_messages' | 'builders' | 'assistants' | 'feedback' | 'all', required
- `includeInactive` boolean

## Response `200`

The usage data in CSV or JSON format, or a ZIP of multiple CSVs if table is equal to "all"

- object

## Other responses

- `400` — Invalid request query
- `403` — The workspace does not have access to the usage data API
- `404` — The workspace was not found

---

[API](https://skmtc.dev/dust-tt/apis/dust-api-documentation.md) · [All operations](https://skmtc.dev/dust-tt/apis/dust-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dust-tt/dust-api-documentation/revisions/2ee8d748e4e5/schema)