Request logs

Server

Request logs across all users. Prompt and response content are never stored.

List request logs

GET

https://ai.brandkamu.id/api/admin

/logs

AI requests across every user, newest first. The period defaults to the 24 hours before to (default now) and can span at most 366 days. counts cover every filter except status.

List request logs › query Parameters

from

string · date-time

Start of the period (inclusive), RFC 3339.

to

string · date-time

End of the period (exclusive), RFC 3339. Defaults to now.

user

string · uuid

User id.

key

An API key id, or playground for requests made from the dashboard playground.

model

string

Exact model slug.

provider

string

Exact provider slug.

status

string · enum

success (HTTP status < 400) or error (>= 400). All when absent or all.

Enum values:

all

success

error

error_type

string

Exact error type (see GET /logs/filters).

q

string

Case-insensitive substring of the user's email or name, the key name or prefix; or exactly a request id or upstream id.

limit

integer · min: 1 · max: 200

Page size (clamped to 1-200).

Default: 50

offset

integer · min: 0

Rows to skip.

Default: 0

List request logs › Responses

A page of requests.

RequestLog[] · required

total

integer · required

Matches for all filters including status.

object · required

For every filter except status.

GET/logs

curl https://ai.brandkamu.id/api/admin/logs \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "user_id": "00000000-0000-0000-0000-000000000000",
      "user_email": "user_email",
      "model_slug": "model_slug",
      "provider_slug": "provider_slug",
      "api_key_id": "00000000-0000-0000-0000-000000000000",
      "api_key_name": "api_key_name",
      "api_key_prefix": "api_key_prefix",
      "prompt_tokens": 0,
      "completion_tokens": 0,
      "cached_tokens": 0,
      "cost_nano": 0,
      "latency_ms": 0,
      "ttft_ms": 0,
      "tps": 0,
      "status_code": 0,
      "streamed": true,
      "source": "api",
      "error_type": "error_type",
      "error_message": "error_message",
      "created_at": "2024-08-25T15:00:00Z"
    }
  ],
  "total": 0,
  "counts": {
    "all": 0,
    "success": 0,
    "error": 0
  }
}

json

application/json

GET

https://ai.brandkamu.id/api/admin

/logs/filters

Models, providers and error types seen in the period (default the 24 hours before to; clamped to 366 days), plus the filtered user with their keys and the filtered key, for filter dropdowns.

from

string · date-time

Start of the period (inclusive), RFC 3339.

to

string · date-time

End of the period (exclusive), RFC 3339. Defaults to now.

user

string · uuid

key

string

An API key id (playground is accepted and ignored).

Filter options.

LogFilterOptions

models

string[] · required

Model slugs seen in the period.

providers

string[] · required

error_types

string[] · required

object | null · required

The filtered user, if any.

KeyRef[] · required

The filtered user's keys (revoked included); empty without a user filter.

KeyRef | null · required

The filtered key, if any.

GET/logs/filters

curl https://ai.brandkamu.id/api/admin/logs/filters \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "models": [
    "string"
  ],
  "providers": [
    "string"
  ],
  "error_types": [
    "string"
  ],
  "user": {
    "id": "00000000-0000-0000-0000-000000000000",
    "email": "email",
    "name": "name"
  },
  "keys": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "name": "name",
      "key_prefix": "key_prefix",
      "user_id": "00000000-0000-0000-0000-000000000000",
      "user_email": "user_email",
      "revoked": true
    }
  ],
  "key": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "name",
    "key_prefix": "key_prefix",
    "user_id": "00000000-0000-0000-0000-000000000000",
    "user_email": "user_email",
    "revoked": true
  }
}

json

application/json

Get a request

GET

https://ai.brandkamu.id/api/admin

/logs/{id}

One request with owner, key, tokens, cost and upstream cost, timing, parameters, error and client details.

Get a request › path Parameters

id

string · uuid · required

Request id.

Get a request › Responses

The request.

RequestLogDetail

id

string · uuid · required

user_id

string · uuid · required

user_email

string · required

upstream_id

string | null · required

The provider's response id.

model_slug

string · required

provider_slug

string · required

api_key_id

string | null · uuid · required

api_key_name

string | null · required

api_key_prefix

string | null · required

source

RequestSource · enum · required

Enum values:

api

playground

streamed

boolean · required

status_code

integer · required

finish_reason

string | null · required

prompt_tokens

integer · required

completion_tokens

integer · required

cached_tokens

integer · required

cache_write_tokens

integer · required

reasoning_tokens

integer · required

cost_nano

integer · int64 · required

Billed cost, nano-USD.

upstream_cost_nano

integer | null · int64 · required

What Sumopod charged, nano-USD, when recorded.

cost_breakdown

required

Per-component cost details (JSON), when recorded.

latency_ms

integer · required

ttft_ms

integer | null · required

tps

number | null · required

request_params

required

Request parameters (JSON, e.g. temperature, max_tokens); never prompt content. May be cleared by retention.

error_type

string | null · required

error_message

string | null · required

client_ip

string | null · required

user_agent

string | null · required

started_at

string · date-time · required

created_at minus the latency.

created_at

string · date-time · required

GET/logs/{id}

curl https://ai.brandkamu.id/api/admin/logs/:id \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": "00000000-0000-0000-0000-000000000000",
  "user_id": "00000000-0000-0000-0000-000000000000",
  "user_email": "user_email",
  "upstream_id": "upstream_id",
  "model_slug": "model_slug",
  "provider_slug": "provider_slug",
  "api_key_id": "00000000-0000-0000-0000-000000000000",
  "api_key_name": "api_key_name",
  "api_key_prefix": "api_key_prefix",
  "source": "api",
  "streamed": true,
  "status_code": 0,
  "finish_reason": "finish_reason",
  "prompt_tokens": 0,
  "completion_tokens": 0,
  "cached_tokens": 0,
  "cache_write_tokens": 0,
  "reasoning_tokens": 0,
  "cost_nano": 0,
  "upstream_cost_nano": 0,
  "cost_breakdown": {},
  "latency_ms": 0,
  "ttft_ms": 0,
  "tps": 0,
  "request_params": {},
  "error_type": "error_type",
  "error_message": "error_message",
  "client_ip": "client_ip",
  "user_agent": "user_agent",
  "started_at": "2024-08-25T15:00:00Z",
  "created_at": "2024-08-25T15:00:00Z"
}

json

application/json

Virtual keys Models

Request logs

List request logs

List request logs › query Parameters

List request logs › Responses

Get filter options

Get filter options › query Parameters

Get filter options › Responses

Get a request

Get a request › path Parameters

Get a request › Responses