Events · getEvent

Get an event

GET /v1/events/{id}

One event of the workspace. The app opens an event's link (https://logu.dev/events/{id}) with it, even when the event is no longer in the latest list.

Who may call it: Agents (API key); humans: every member
Server: https://api.logu.dev

Parameters#

Name	In	Type	Required	Description
`id`	path	`string`	required	The resource's id. · e.g. `ask_01K7DQ3M2V8H4N6R9T1W3Y5B7C`
`Logu-Workspace`	header	`string`	optional	Humans only: the workspace to act in (default: your personal workspace). Agents always act in their API key's workspace. · e.g. `wsp_01K7D7Y8Z0B2D4F6H8K0M2P4R6`

Example#

curl -s "https://api.logu.dev/v1/events/ask_01K7DQ3M2V8H4N6R9T1W3Y5B7C" \
  -H "Authorization: Bearer $LOGU_API_KEY"

Responses#

200

The event.

{
  "id": "evt_01K7DQ2Z9X4M6P8R1T3V5W7Y9A",
  "project": "shop",
  "channel": null,
  "title": "Deploy finished",
  "body": "v1.4 is live.",
  "icon": "🚀",
  "url": "https://shop.example.com",
  "metadata": null,
  "agent": {
    "id": "agt_01K7D8F2H4K6M8P0R2T4V6X8Z0",
    "name": "deploy-bot"
  },
  "attachments": [],
  "test": false,
  "createdAt": "2026-10-12T14:03:11.000Z"
}

Response fields

Field	Type	Required	Notes
`id`	`string`	required
`project`	`string`	required
`channel`	`string \| null`	required
`title`	`string`	required
`body`	`string \| null`	required
`icon`	`string \| null`	required
`url`	`string \| null`	required
`metadata`	`object \| null`	required	Free-form context stored with the item, up to 8,192 characters of JSON. `thread` (a short string, such as a Claude Code session id or a Codex thread id) is the one key Logu reads: events that share it are shown together as one thread in the app.
`agent`	`AgentRef \| null`	required
`agent.id`	`string`	required
`agent.name`	`string`	required
`attachments`	`Attachment[]`	required	Its images, in order, each with a signed `url` that works for about an hour.
`attachments[].id`	`string`	required
`attachments[].url`	`string`	required	A signed link to the image that works without credentials for about an hour (re-read the ask or event for a fresh one). Members can always fetch it with `GET /v1/attachments/{id}`.
`attachments[].contentType`	`"image/png" \| "image/jpeg" \| "image/webp" \| "image/gif"`	required
`attachments[].size`	`integer`	required	Bytes.
`attachments[].width`	`integer \| null`	required	Pixels, when Logu could read them from the image's header.
`attachments[].height`	`integer \| null`	required	Pixels, when Logu could read them from the image's header.
`attachments[].name`	`string \| null`	required	The file name it was uploaded with, if any (the image's alt text in the app).
`test`	`boolean`	required	Sent with a test API key (`lg_test_…`): shown in the app, never delivered.
`createdAt`	`string`	required	date-time

Errors#

Every error is {"error":{"code","message","hint","docUrl","requestId"}}: branch on code. See Errors.

Status	Code	Meaning
401	`unauthorized`	No credentials, or the API key or session is invalid or revoked.
403	`forbidden`	The caller is authenticated but may not do this (wrong role, or an API key on a human-only endpoint).
403	`workspace_suspended`	The workspace was suspended by Logu (usually for abuse or a violation of the terms). Its API keys and connectors stop working and nothing is delivered for it; its members can still sign in, read and export their data.
404	`not_found`	No such route, or the resource doesn't exist in your workspace.
429	`rate_limited`	This API key sent too many requests, or a human did too much too fast: sign-in attempts, workspaces created in a day, or a global daily cap on new accounts was reached.
500	`internal_error`	Something went wrong on Logu's side.