GET /logs
Updated Oct 1, 20261 minute read
Read the activity log
Owners and admins only. AI runs with their tokens and credits, tool calls, knowledge syncs and imports, team and settings changes, and whatever failed, newest first. Background work and API calls are only logged when they go wrong. Keep the same snapshot and filters while paging. Reading the log writes nothing to it.
Part of Billing.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
from | query | number | No | Inclusive Unix timestamp in milliseconds; defaults to 30 days before the end. |
to | query | number | No | Inclusive Unix timestamp in milliseconds; defaults to now. |
snapshot | query | number | No | Fixed recording cutoff in Unix milliseconds; defaults to now. |
limit | query | integer | No | Records per page. |
cursor | query | string | No | Continuation cursor. An empty filtered page may still have a continuation. |
search | query | string | No | Matches the entry's line, its error and tool names. |
category | query | string | No | One area, like ai, tools, knowledge or team. |
actorId | query | string | No | One member's user id. |
conversationId | query | string | No | Only entries about one conversation. |
usage | query | boolean | No | Only entries that used something billed: tokens, emails or pages. |
actorKind | query | "member" | "agent" | "assistant" | "customer" | "api" | "system" | No | Who did it: a member, the support agent, the assistant, a customer, the API or the system. |
outcome | query | "success" | "failed" | "denied" | "pending" | "canceled" | No | Event outcome. |
Responses
| Status | Description |
|---|---|
200 | A page of entries. |
401 | Invalid or missing credentials. |
403 | The authenticated role cannot read these records. |
429 | Shared organization API allowance or temporary fair-use protection reached. Retry-After states the delay. |
200 body
| Field | Type | Required | Description |
|---|---|---|---|
page | object[] | Yes | |
isDone | boolean | Yes | |
continueCursor | string | Yes |
Example request
curl https://api.median.sh/v1/logs \
-H "Authorization: Bearer $BEARER_AUTH"