---
title: "POST /relativity-audit/v1/workspaces/{workspaceID}/usage-time"
method: POST
path: "/relativity-audit/v1/workspaces/{workspaceID}/usage-time"
tags: ["Audit Module v1"]
---

# POST /relativity-audit/v1/workspaces/{workspaceID}/usage-time

`POST /relativity-audit/v1/workspaces/{workspaceID}/usage-time`

## Request

- Base URL: `https://platform.relativity.com/Relativity.REST/api`
- URL: `https://platform.relativity.com/Relativity.REST/api/relativity-audit/v1/workspaces/{workspaceID}/usage-time`
- Auth: none declared. Required headers: `x-csrf-header`
- TypeScript: <https://skmtc.dev/relativity/apis/relativity-audit-services-interfaces-v1/docs/relativity-audit/v1/workspaces/:workspaceID/usage-time/post.ts> (a function with typed inputs; its response is checked against the schema)

[Public] IAuditReviewerStatisticsService -

## Path parameters

- `workspaceID` integer, required

## Headers

- `x-csrf-header` string, required

## Request body

- GetUsageTimesAsyncRequestBody
  - `criteria` UsageTimeCriteria
    - `AuditActionIDs` integer[]
    - `DownTimeThresholdSeconds` integer, nullable
    - `UserIDs` integer[]
    - `StartDate` DateTimeOffset
      - `Now` DateTimeOffset (recursive)
      - `UtcNow` DateTimeOffset (recursive)
      - `DateTime` string, date-time
      - `UtcDateTime` string, date-time
      - `LocalDateTime` string, date-time
      - `Date` string, date-time
      - `Day` integer
      - `DayOfWeek` 'Sunday' | 'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday'
      - `DayOfYear` integer
      - `Hour` integer
      - `Millisecond` integer
      - `Minute` integer
      - `Month` integer
      - `Offset` TimeSpan
        - `Ticks` integer
        - `Days` integer
        - `Hours` integer
        - `Milliseconds` integer
        - `Minutes` integer
        - `Seconds` integer
        - `TotalDays` number
        - `TotalHours` number
        - `TotalMilliseconds` number
        - `TotalMinutes` number
        - `TotalSeconds` number
      - `Second` integer
      - `Ticks` integer
      - `UtcTicks` integer
      - `TimeOfDay` TimeSpan
        - `Ticks` integer
        - `Days` integer
        - `Hours` integer
        - `Milliseconds` integer
        - `Minutes` integer
        - `Seconds` integer
        - `TotalDays` number
        - `TotalHours` number
        - `TotalMilliseconds` number
        - `TotalMinutes` number
        - `TotalSeconds` number
      - `Year` integer
    - `EndDate` DateTimeOffset
      - `Now` DateTimeOffset (recursive)
      - `UtcNow` DateTimeOffset (recursive)
      - `DateTime` string, date-time
      - `UtcDateTime` string, date-time
      - `LocalDateTime` string, date-time
      - `Date` string, date-time
      - `Day` integer
      - `DayOfWeek` 'Sunday' | 'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday'
      - `DayOfYear` integer
      - `Hour` integer
      - `Millisecond` integer
      - `Minute` integer
      - `Month` integer
      - `Offset` TimeSpan
        - `Ticks` integer
        - `Days` integer
        - `Hours` integer
        - `Milliseconds` integer
        - `Minutes` integer
        - `Seconds` integer
        - `TotalDays` number
        - `TotalHours` number
        - `TotalMilliseconds` number
        - `TotalMinutes` number
        - `TotalSeconds` number
      - `Second` integer
      - `Ticks` integer
      - `UtcTicks` integer
      - `TimeOfDay` TimeSpan
        - `Ticks` integer
        - `Days` integer
        - `Hours` integer
        - `Milliseconds` integer
        - `Minutes` integer
        - `Seconds` integer
        - `TotalDays` number
        - `TotalHours` number
        - `TotalMilliseconds` number
        - `TotalMinutes` number
        - `TotalSeconds` number
      - `Year` integer
    - `TimeZone` string

## Response `200`

Successful Operation

- UsageTimeResponse
  - `ReviewerStatistics` ReviewerWithStatistics1[]
    - `UserID` integer
    - `Statistics` DocumentActionCountStatistics
      - `ActionCounts` ActionCount[]
        - `AuditActionID` integer
        - `Count` integer
        - `DistinctDocumentCount` integer

---

[API](https://skmtc.dev/relativity/apis/relativity-audit-services-interfaces-v1.md) - [All operations](https://skmtc.dev/relativity/apis/relativity-audit-services-interfaces-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/relativity/apis/relativity-audit-services-interfaces-v1/revisions/20c660b3f99a?raw)