Eventum Logo

Eventum

Overview

Eventum API reference

Login

Authenticate user via basic auth and create a server-side session with a HttpOnly cookie

Get Current User

Get current user

Logout

Clear user session

Get Info

Information about app and host

Get Settings

Get settings

Update Settings

Update settings. Note that this only updates file. For changes to take effect u have to restart instance.

Stop

Stop instance

Restart

Restart instance

List Generator Dirs

List all generator directory names inside `path.generators_dir` with generator configs.

Get Generator Config

Get generator configuration in the directory with specified name.

Create Generator Config

Create generator configuration in the directory with specified name.

Delete Generator Config

Delete whole generator configuration directory with specified name.

Update Generator Config

Update generator configuration in the directory with specified name.

Rename Generator Config

Rename generator configuration directory. Instances that use the configuration are repointed at the new directory and must be stopped beforehand.

Export Generator Config

Export generator directory with specified name as a ZIP archive. Entries named in `exclude` are left out with everything under them.

Import Generator Config

Import generator directory with specified name from a ZIP archive. The archive must hold a generator configuration, and the directory holding it becomes the root of the imported generator.

Get Generator Config Path

Get generator configuration path in the directory with specified name.

Get Generator File Tree

Get file tree of the generator directory with specified name.

Get Generator File

Read file from specified path inside generator directory with specified name. Set `download` to receive the file as an attachment instead of inline content.

Upload Generator File

Upload file to specified path inside generator directory with specified name.

Delete Generator File

Delete file in specified path inside generator directory with specified name.

Put Generator File

Put file to specified path inside generator directory with specified name.

Create Generator Directory

Create directory inside generator directory in specified path.

Move Generator File

Move file from source to destination location inside generator directory with specified name.

Copy Generator File

Copy file from source to destination location inside generator directory with specified name.

Generate Timestamps

Generate timestamps using input plugins

Initialize Event Plugin

Initialize event plugin

Release Event Plugin

Release event plugin with freeing acquired resource

Produce Events

Produce events using initialized event plugin

Get Template Event Plugin Local State

Get local state of template event plugin for the specified template by its alias

Update Template Event Plugin Local State

Patch local state of template event plugin for the specified template by its alias

Clear Template Event Plugin Local State

Clear local state of template event plugin for the specified template by its alias

Delete Template Event Plugin Local State Key

Delete a key from local state of template event plugin for the specified template by its alias

Get Template Event Plugin Shared State

Get shared state of template event plugin

Update Template Event Plugin Shared State

Patch shared state of template event plugin

Clear Template Event Plugin Shared State

Clear shared state of template event plugin

Delete Template Event Plugin Shared State Key

Delete a key from shared state of template event plugin

Get Event Plugin Global State

Get global state shared across all event plugins

Update Event Plugin Global State

Patch global state shared across all event plugins

Clear Event Plugin Global State

Clear global state shared across all event plugins

Delete Event Plugin Global State Key

Delete a key from global state shared across all event plugins

Format Events

Format events using specified formatter

Normalize Versatile Datetime

Normalize versatile date time expression

List Generators

List ids of all generators

Get Generator

Get generator parameters

Add Generator

Add generator. Note that `id` path parameter takes precedence over `id` field in the body.

Delete Generator

Remove generator by its id. Stop it in case it is running.

Update Generator

Update generator with provided parameters. Note that `id` path parameter takes precedence over `id` field in the body.

Get Generator Status

Get generator status

Rename Generator

Rename generator. The definition in the startup file is renamed along with the generator, and scenario membership is kept.

Start Generator

Start generator by its id

Stop Generator

Stop generator by its id

Get Generator Stats

Get stats of running generator

Get Running Generators Stats

Get stats of all running generators

Bulk Start Generators

Bulk start several generators

Bulk Stop Generators

Bulk stop several generators

Bulk Delete Generators

Bulk delete several generators

Get Generators In Startup

Get list of generator definitions in the startup file

Get Generator From Startup

Get generator definition from list in the startup file

Add Generator To Startup

Add generator definition to list in the startup file

Delete Generator From Startup

Delete generator definition from list in the startup file

Update Generator In Startup

Update generator definition in list in the startup file

Bulk Delete Generators From Startup

Bulk delete several generator definitions from list in the startup file

List Scenarios

List all scenarios

Get Scenario

Get scenario details

Delete Scenario

Delete scenario (remove tag from all generators)

Rename Scenario

Rename scenario (rewrite tag in all generators that carry it)

Add Generator To Scenario

Add generator to scenario

Remove Generator From Scenario

Remove generator from scenario

Get globals usage for a generator in a scenario

Detect globals usage in Jinja2 templates and Python scripts via AST analysis.

Get Scenario Global State Key

Get a specific global state key value

Delete Scenario Global State Key

Delete a key from global state

Get Scenario Global State

Get global state shared across all event plugins

Update Scenario Global State

Update global state shared across all event plugins

Clear Scenario Global State

Clear global state shared across all event plugins

Get Secret Value

Get secret with specified name from keyring

Delete Secret Value

Delete secret with specified name to keyring

Set Secret Value

Put secret with specified name to keyring. The name is what a configuration references as `${secrets.<name>}`, so it must be words of lowercase letters, digits and `_`, separated by `.`.

List Secret Names

List all secrets names

List Secret References

List what refers to the secret - the projects whose configuration reads it as `${secrets.<name>}`, and the connected repositories authenticating with it

Rename Secret Value

Rename secret in keyring. The new name must be words of lowercase letters, digits and `_`, separated by `.`, since a configuration references it as `${secrets.<name>}`. Everything referring to the secret follows: the token is rewritten in the configuration of every project reading it, and every connected repository authenticating with it is repointed at the new name.

List Repositories

List connected generator repositories, each with the result of the last check made in this process. A password naming a keyring secret is answered as written, while one holding the credential itself is answered redacted.

Add Repository

Connect a generator repository. The repository is checked before it is connected, and the catalog it publishes is read on the first request for it.

Discover Repositories

Search the repositories that publish generators in the open. A repository appears in the list by carrying the topic that defines it, and the content of a listed repository is not reviewed.

Check Repository

Check that the repository with specified name answers and publishes the branch or tag it names.

Remove Repository

Disconnect the repository with specified name. Generators installed from it are left in place.

Get Catalog

Get the catalog of generators published by the repository with specified name. The repository is fetched when it has not been fetched yet.

Refresh Catalog

Fetch the repository with specified name and read its catalog anew.

Install Generator

Install the published generator with specified name as a generator directory of the workspace.