---
title: "Event detail"
method: GET
path: "/v2/storage/events/{eventId}"
tags: ["Events"]
---

# Event detail

`GET /v2/storage/events/{eventId}`

## Request

- Base URL: `https://connection.keboola.com`
- URL: `https://connection.keboola.com/v2/storage/events/{eventId}`
- Auth: one of:
  - API key in header `X-StorageApi-Token`
  - API key in header `X-KBC-ManageApiToken`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/keboola/apis/keboola-storage-api/docs/v2/storage/events/:eventId/get.ts> (a function with typed inputs; its response is checked against the schema)

Obtains information about a event in the project. The branch variant returns the event of the given
[Development Branch](#tag/Development-Branches).

For non-admin tokens, events bound to a bucket are only returned when the token has access to that bucket.

## Path parameters

- `eventId` string, required

## Response `200`

Event detail.

- EventResponse
  - `uuid` string, required: Event UUID v7 identifier.
  - `event` string, required: Event identifier such as `storage.tableImportDone` or `storage.tableDetail`. External events are named `ext.{component}.{configurationId}`.
  - `component` string, required: Name of the component that logged the event. Events can be logged by the `storage` component or any other registered component.
  - `message` string, required: Human readable description of the event.
  - `description` string, required: Additional description of the event, such as a detailed error description.
  - `type` 'info' | 'success' | 'warn' | 'error', required: Type of the event.
  - `runId` string, nullable, required: Id of the associated job.
  - `created` string, required: When the event was created, ISO 8601 with a `+hhmm` offset; `""` when none was recorded.
  - `configurationId` string, nullable, required: Id of a configuration used by an external component.
  - `objectId` union, required: Id of the target object of the event, e.g. table id for `storage.tableImportDone`. An integer for objects with numeric ids, such as files, workspaces, branches and admins.
    - string
    - integer
  - `objectName` string, required: Name of the target object, e.g. table name for `storage.tableImportDone`.
  - `objectType` string, required: Type of the target object, e.g. `table` for `storage.tableImportDone`.
  - `context` union, required: Details about the origin of the API call that triggered the event; an empty array `[]` when the event has no context.
    - object
      - `remoteAddr` string, nullable
      - `httpReferer` string, nullable
      - `httpUserAgent` string, nullable
      - `httpUserAgentOriginal` string, nullable
      - `authorization` string, nullable
      - `apiVersion` string, nullable
    - unknown[]
      - unknown
  - `params` object, required: Arbitrary parameters associated with the event, e.g. CSV file settings for table import.
  - `results` object, required: Arbitrary results of the event.
  - `performance` object, required: Arbitrary performance metrics associated with the event.
  - `token` object, required: Creator of the event.
    - `id` integer, required: Id of the token.
    - `name` string, nullable, required: Token owner.
  - `idBranch` integer, nullable, required: Id of the branch the event belongs to, including the default branch; `null` when the event is not tied to a branch.
  - `uri` string, required: Event URI.
  - `attachments` EventAttachmentResponse[], required: Files attached to the event, e.g. backups for table import events.
    - `id` integer, required: Id of the attached file.
    - `isSliced` boolean, required: Whether the file is sliced.
    - `uploadType` string, required: Upload type of the file.
    - `isExpired` boolean, required: Whether the file has already expired.
    - `created` string, required: When the file was created, ISO 8601 with a `+hhmm` offset.
    - `name` string, required: File name.
    - `url` string, required: Download URL of the file.
    - `sizeBytes` integer, nullable, required: File size in bytes.

## Other responses

- `400`: Event Id is neither an integer nor a valid UUID v7 (`storage.storage.events.invalidId`), or the events backend rejected the request (`storage.events.error`).
- `403`: The token has no access to the bucket the event belongs to (`accessDenied`).
- `404`: Event not found (`storage.storage.events.notFound`).

---

[API](https://skmtc.dev/keboola/apis/keboola-storage-api.md) - [All operations](https://skmtc.dev/keboola/apis/keboola-storage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/keboola/apis/keboola-storage-api/revisions/34b5ceac0317?raw)
