Skip to content
Mako Docs

Usage breakdown by user

GET
/api/workspaces/{workspaceId}/usage/by-user
curl --request GET \
  --url http://localhost:8080/api/workspaces/example/usage/by-user \
  --cookie auth_session=<auth_session>

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
workspaceId
required
string

Query Parameters

Section titled “Query Parameters”
from
string
to
string

Responses

Section titled “Responses”

200

Section titled “200”

Per-user usage breakdown.

Media typeapplication/json
object
users
required
Array
object
totalInputTokens
required
number
totalOutputTokens
required
number
totalCacheReadTokens
required
number
totalCacheWriteTokens
required
number
totalReasoningTokens
required
number
totalTokens
required
number
totalCostUsd
required
number
invocationCount
required
number
userId
required
string | null

Example generated

{
  "users": [
    {
      "totalInputTokens": 1,
      "totalOutputTokens": 1,
      "totalCacheReadTokens": 1,
      "totalCacheWriteTokens": 1,
      "totalReasoningTokens": 1,
      "totalTokens": 1,
      "totalCostUsd": 1,
      "invocationCount": 1,
      "userId": "example"
    }
  ]
}

400

Section titled “400”

Invalid request

Media typeapplication/json
object
success
boolean
error
required
string

Example 

{
  "error": "Human-readable error message"
}

401

Section titled “401”

Authentication required

Media typeapplication/json
object
success
boolean
error
required
string

Example 

{
  "error": "Human-readable error message"
}

403

Section titled “403”

Forbidden

Media typeapplication/json
object
success
boolean
error
required
string

Example 

{
  "error": "Human-readable error message"
}

404

Section titled “404”

Not found

Media typeapplication/json
object
success
boolean
error
required
string

Example 

{
  "error": "Human-readable error message"
}

409

Section titled “409”

Conflict

Media typeapplication/json
object
success
boolean
error
required
string

Example 

{
  "error": "Human-readable error message"
}

500

Section titled “500”

Internal server error

Media typeapplication/json
object
success
boolean
error
required
string

Example 

{
  "error": "Human-readable error message"
}