Skip to content
Median
Esc
↑↓navigate↵open⌘Jpreview

Read one log entry

Owners and admins only. The entry, what it touched by name, and when it is about a conversation, everything else logged about that conversation in order, capped at 50.

GET/logs/{id}
Authorization
AuthorizationBearer token · headerrequired
`MEDIAN_KEY` from Settings under API, or an MCP OAuth access token. A key acts as the organization; a token acts as the person who approved it.
Path parameters
idstringrequired
The entry's id from GET /logs.
Responses
200The entry, what it touched, and its conversation's other entries.
entryobjectrequired
Show properties
idstring
atnumber
eventstring
categorystring
outcomestring
messagestring
summarystring | null
errorstring | null
actorKindstring
actorIdstring | null
featurestring | null
durationMsnumber | null
detailsobject
conversationIdstring | null
docIdstring | null
signalIdstring | null
customerIdstring | null
relatedobject[]required
Show properties
Array of object
idstring
atnumber
eventstring
categorystring
outcomestring
messagestring
summarystring | null
errorstring | null
actorKindstring
actorIdstring | null
featurestring | null
durationMsnumber | null
detailsobject
conversationIdstring | null
docIdstring | null
signalIdstring | null
customerIdstring | null
relatedLimitedbooleanrequired
aboutobject[]required
Show properties
Array of object
kindstringrequired
Allowed:conversationdocsignalcustomer
labelstringrequired
hrefstringrequired
400The request is malformed, and the message names the field.
errorobject
Show properties
codestring
messagestring
401The bearer token is missing, revoked, or expired.
errorobject
Show properties
codestring
messagestring
403The token's person does not hold the role this needs.
errorobject
Show properties
codestring
messagestring
404Not one of yours, or not there at all.
errorobject
Show properties
codestring
messagestring
429Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See [rate limits](/api/errors-and-limits#rate-limits).
errorobject
Show properties
codestring
messagestring
Request
curl -X GET "https://api.median.sh/v1/logs/string" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "entry": {
    "id": "string",
    "at": 0,
    "event": "string",
    "category": "string",
    "outcome": "string",
    "message": "string",
    "summary": "string",
    "error": "string",
    "actorKind": "string",
    "actorId": "string",
    "feature": "string",
    "durationMs": 0,
    "details": {},
    "conversationId": "string",
    "docId": "string",
    "signalId": "string",
    "customerId": "string"
  },
  "related": [
    {
      "id": "string",
      "at": 0,
      "event": "string",
      "category": "string",
      "outcome": "string",
      "message": "string",
      "summary": "string",
      "error": "string",
      "actorKind": "string",
      "actorId": "string",
      "feature": "string",
      "durationMs": 0,
      "details": {},
      "conversationId": "string",
      "docId": "string",
      "signalId": "string",
      "customerId": "string"
    }
  ],
  "relatedLimited": true,
  "about": [
    {
      "kind": "conversation",
      "label": "string",
      "href": "string"
    }
  ]
}