Skip to content
Mako Docs

Usage detail for a chat

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

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
workspaceId
required
string
chatId
required
string

Responses

Section titled “Responses”

200

Section titled “200”

Per-chat usage detail.

Media typeapplication/json
object
chatId
required
string
totals
required
object
inputTokens
required
number
outputTokens
required
number
cacheReadTokens
required
number
cacheWriteTokens
required
number
reasoningTokens
required
number
totalTokens
required
number
costUsd
required
number
invocations
required
Array<object>
object
key
additional properties

Example generated

{
  "chatId": "example",
  "totals": {
    "inputTokens": 1,
    "outputTokens": 1,
    "cacheReadTokens": 1,
    "cacheWriteTokens": 1,
    "reasoningTokens": 1,
    "totalTokens": 1,
    "costUsd": 1
  },
  "invocations": [
    {
      "additionalProperty": "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"
}