argus-alm 0.15.6__tar.gz → 0.15.8__tar.gz

argus_alm-0.15.8/AGENTS.md

@@ -0,0 +1,27 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+Backend services live in `argus/backend` with Flask entry points defined in `argus_backend.py`; shared helpers sit in `argus/common`, while CLI tooling and client integrations are under `argus/client`. Frontend assets are in `frontend/`, compiled into `public/dist`, and HTML templates stay in `templates/`. Test suites are grouped in `argus/backend/tests`, `argus/client/tests`, and `pytest-argus-reporter/tests`.
+
+## Build, Test, and Development Commands
+Install dependencies with `uv sync --all-extras` and `yarn install`. Rebuild the Svelte-based UI with `ROLLUP_ENV=development yarn rollup -c --watch`. Start the API locally via `FLASK_ENV=development FLASK_APP=argus_backend:start_server CQLENG_ALLOW_SCHEMA_MANAGEMENT=1 uv run flask run`. For linting, run `uv run ruff check`. Run server-side tests with `uv run pytest argus/backend/tests` and client utilities through `uv run pytest argus/client/tests`.
+
+## Coding Style & Naming Conventions
+Python code targets 3.12, uses 4-space indentation, and a 120-character line width enforced by Ruff and Autopep8 (see `pyproject.toml`). Prefer descriptive snake_case for Python modules and functions; keep Svelte/JS components in PascalCase folders aligned with entry files (e.g., `frontend/AdminPanel/`). Organize Flask blueprints by feature under `argus/backend` and export public APIs through `__init__.py`.
+
+## Svelte 5 Frontend Patterns
+- Favor the rune APIs (`$props`, `$state`, `$derived`, `run`) for component state and avoid legacy `$:` reactivity when a rune captures intent better.
+- Reach into the DOM through Svelte bindings or actions (`bind:this`, `use:…`) rather than global selectors; never call `Node.querySelector*` inside components—track nodes via bindings and stores instead.
+- Prefer component composition, snippets, and `@const/@render` blocks over imperative DOM updates; lean on `await tick()` when you must wait for the DOM after state changes.
+- Keep data transformations in script context and pass plain data to the markup; don’t derive clipboard or export payloads by scraping rendered HTML.
+- Encapsulate escape-hatch logic (Bootstrap collapse, portals, external widgets) inside reusable actions/helpers so behavior is testable and discoverable.
+- Use TypeScript-friendly patterns (typed props, `import type …`) whenever you bind component instances or DOM nodes, and co-locate UI-specific helpers next to their components.
+
+## Testing Guidelines
+Tests follow `test_*.py` naming and Pytest markers such as `@pytest.mark.docker_required` for Docker-heavy suites. Keep unit tests close to their modules (e.g., `results_service` tests). Execute full coverage with `uv run pytest --cov=argus backend/tests client/tests`. Add fixtures under `argus/backend/tests/conftest.py` when sharing setup.
+
+## Commit & Pull Request Guidelines
+Adopt the Conventional Commits style observed in history (`fix(scope): message`, `feature(app): ...`). Compose commits around a single logical change and run lint/tests before pushing. Pull requests should describe intent, outline manual validation steps, and link tracking issues; include screenshots or API payload snippets when UI or API responses change.
+
+## Configuration & Security Notes
+Never commit secrets: When testing against Cassandra, use the Docker compose setup in `dev-db/` and tear it down after use. Keep sample data archives outside the repository to avoid leaking production artifacts.

{argus_alm-0.15.6 → argus_alm-0.15.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: argus-alm
-Version: 0.15.6
+Version: 0.15.8
 Summary: Argus
 Author-email: Alexey Kartashov <alexey.kartashov@scylladb.com>, Łukasz Sójka <lukasz.sojka@scylladb.com>
 License-Expression: Apache-2.0
@@ -24,6 +24,7 @@ Requires-Dist: python-jenkins>=1.7.0; extra == "web-backend"
 Requires-Dist: python-slugify~=6.1.1; extra == "web-backend"
 Requires-Dist: pygithub>=2.6.1; extra == "web-backend"
 Requires-Dist: boto3~=1.38.9; extra == "web-backend"
+Requires-Dist: prometheus-flask-exporter>=0.23.2; extra == "web-backend"
 Provides-Extra: docker-image
 Requires-Dist: supervisor~=4.2.4; extra == "docker-image"
 Provides-Extra: dev
@@ -50,6 +51,10 @@ Dynamic: license-file
 
 Argus is a test tracking system intended to provide observability into automated test pipelines which use long-running resources. It allows observation of a test status, its events and its allocated resources. It also allows easy comparison between particular runs of a specific test.
 
+## Contributing
+
+Review the [Repository Guidelines](AGENTS.md) for project structure, tooling expectations, and pull request practices before submitting changes.
+
 ## Installation notes
 
 ### Development

{argus_alm-0.15.6 → argus_alm-0.15.8}/README.md

@@ -5,6 +5,10 @@
 
 Argus is a test tracking system intended to provide observability into automated test pipelines which use long-running resources. It allows observation of a test status, its events and its allocated resources. It also allows easy comparison between particular runs of a specific test.
 
+## Contributing
+
+Review the [Repository Guidelines](AGENTS.md) for project structure, tooling expectations, and pull request practices before submitting changes.
+
 ## Installation notes
 
 ### Development

{argus_alm-0.15.6 → argus_alm-0.15.8}/argus/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.15.6'
-__version_tuple__ = version_tuple = (0, 15, 6)
+__version__ = version = '0.15.8'
+__version_tuple__ = version_tuple = (0, 15, 8)
 
-__commit_id__ = commit_id = 'g46c898c68'
+__commit_id__ = commit_id = 'geb08ab7cf'

{argus_alm-0.15.6 → argus_alm-0.15.8}/argus/client/base.py

@@ -37,16 +37,14 @@ class ArgusClient:
         self._auth_token = auth_token
         self._base_url = base_url
         self._api_ver = api_version
-        self._extra_headers = extra_headers or {}
+        self.session = requests.Session()
+        if extra_headers:
+            self.session.headers.update(extra_headers)
 
     @property
     def auth_token(self) -> str:
         return self._auth_token
 
-    @property
-    def extra_headers(self) -> dict:
-        return self._extra_headers
-
     def verify_location_params(self, endpoint: str, location_params: dict[str, str]) -> bool:
         required_params: list[str] = re.findall(r"\$[\w_]+", endpoint)
         for param in required_params:
@@ -92,7 +90,6 @@ class ArgusClient:
             "Authorization": f"token {self.auth_token}",
             "Accept": "application/json",
             "Content-Type": "application/json",
-            **self.extra_headers,
         }
 
     def get(self, endpoint: str, location_params: dict[str, str] = None, params: dict = None) -> requests.Response:
@@ -101,7 +98,7 @@ class ArgusClient:
             location_params=location_params
         )
         LOGGER.debug("GET Request: %s, params: %s", url, params)
-        response = requests.get(
+        response = self.session.get(
             url=url,
             params=params,
             headers=self.request_headers
@@ -122,7 +119,7 @@ class ArgusClient:
             location_params=location_params
         )
         LOGGER.debug("POST Request: %s, params: %s, body: %s", url, params, body)
-        response = requests.post(
+        response = self.session.post(
             url=url,
             params=params,
             json=body,

{argus_alm-0.15.6 → argus_alm-0.15.8}/argus/client/sct/client.py

@@ -2,6 +2,7 @@ import base64
 from typing import Any
 from uuid import UUID
 from dataclasses import asdict
+from argus.common.email import RawAttachment, ReportSection, ReportSectionShortHand
 from argus.common.sct_types import GeminiResultsRequest, PerformanceResultsRequest, RawEventPayload
 from argus.common.enums import ResourceState, TestStatus
 from argus.client.base import ArgusClient
@@ -27,6 +28,7 @@ class ArgusSCTClient(ArgusClient):
         SUBMIT_EVENTS = "/sct/$id/events/submit"
         SUBMIT_EVENT = "/sct/$id/event/submit"
         SUBMIT_JUNIT_REPORT = "/sct/$id/junit/submit"
+        SUBMIT_EMAIL = "/testrun/report"
 
     def __init__(self, run_id: UUID, auth_token: str, base_url: str, api_version="v1", extra_headers: dict | None = None) -> None:
         super().__init__(auth_token, base_url, api_version, extra_headers=extra_headers)
@@ -136,6 +138,25 @@ class ArgusSCTClient(ArgusClient):
         )
         self.check_response(response)
 
+    def send_email(self, recipients: list[str], title: str = "#auto", sections: list[ReportSection | ReportSectionShortHand] = None, attachments: list[RawAttachment] | None = None) -> None:
+        """
+            Send a testrun report email using Argus.
+            Documentation: https://github.com/scylladb/argus/blob/master/docs/api_usage.md#L124
+        """
+        response = self.post(
+            endpoint=self.Routes.SUBMIT_EMAIL,
+            location_params={},
+            body={
+                **self.generic_body,
+                "run_id": self.run_id,
+                "title": title,
+                "recipients": recipients,
+                "sections": sections or [],
+                "attachments": attachments or [],
+            }
+        )
+        self.check_response(response)
+
     def submit_gemini_results(self, gemini_data: GeminiResultsRequest) -> None:
         """
             Submits gemini results such as oracle node information and gemini command & its results

argus_alm-0.15.8/argus/common/email.py

@@ -0,0 +1,33 @@
+
+from typing import Any, Literal, TypedDict
+
+
+class ReportSection(TypedDict):
+    type: str
+    options: dict[str, Any]
+
+
+ReportSectionShortHand = Literal["main",
+                                 "header",
+                                 "packages",
+                                 "logs",
+                                 "cloud",
+                                 "nemesis",
+                                 "events",
+                                 "screenshots",
+                                 "custom_table",
+                                 "custom_html",]
+
+
+class RawAttachment(TypedDict):
+    filename: str
+    data: str # Base64 string
+
+
+class RawReportSendRequest(TypedDict):
+    schema_version: str
+    run_id: str
+    title: str
+    recipients: list[str]
+    sections: list[ReportSection]
+    attachments: list[RawAttachment]

{argus_alm-0.15.6 → argus_alm-0.15.8}/argus/common/enums.py

@@ -39,6 +39,7 @@ class PytestStatus(str, Enum):
 
 
 class TestInvestigationStatus(str, Enum):
+    __test__ = False  # prevent pytest from collecting this Enum as a test class
     NOT_INVESTIGATED = "not_investigated"
     IN_PROGRESS = "in_progress"
     INVESTIGATED = "investigated"

{argus_alm-0.15.6 → argus_alm-0.15.8}/argus_alm.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: argus-alm
-Version: 0.15.6
+Version: 0.15.8
 Summary: Argus
 Author-email: Alexey Kartashov <alexey.kartashov@scylladb.com>, Łukasz Sójka <lukasz.sojka@scylladb.com>
 License-Expression: Apache-2.0
@@ -24,6 +24,7 @@ Requires-Dist: python-jenkins>=1.7.0; extra == "web-backend"
 Requires-Dist: python-slugify~=6.1.1; extra == "web-backend"
 Requires-Dist: pygithub>=2.6.1; extra == "web-backend"
 Requires-Dist: boto3~=1.38.9; extra == "web-backend"
+Requires-Dist: prometheus-flask-exporter>=0.23.2; extra == "web-backend"
 Provides-Extra: docker-image
 Requires-Dist: supervisor~=4.2.4; extra == "docker-image"
 Provides-Extra: dev
@@ -50,6 +51,10 @@ Dynamic: license-file
 
 Argus is a test tracking system intended to provide observability into automated test pipelines which use long-running resources. It allows observation of a test status, its events and its allocated resources. It also allows easy comparison between particular runs of a specific test.
 
+## Contributing
+
+Review the [Repository Guidelines](AGENTS.md) for project structure, tooling expectations, and pull request practices before submitting changes.
+
 ## Installation notes
 
 ### Development

{argus_alm-0.15.6 → argus_alm-0.15.8}/argus_alm.egg-info/SOURCES.txt

@@ -4,6 +4,7 @@
 .gitignore
 .pre-commit-config.yaml
 .prettierrc.js
+AGENTS.md
 Dockerfile
 LICENSE
 MANIFEST.in
@@ -39,6 +40,7 @@ argus/client/sct/client.py
 argus/client/sct/types.py
 argus/client/sirenada/client.py
 argus/common/__init__.py
+argus/common/email.py
 argus/common/enums.py
 argus/common/sct_types.py
 argus/common/sirenada_types.py
@@ -275,6 +277,9 @@ frontend/TestRun/Pytest/PytestRun.svelte
 frontend/TestRun/Pytest/PytestTab.svelte
 frontend/TestRun/Pytest/index.js
 frontend/TestRun/Pytest/types.ts
+frontend/TestRun/SCT/SctEvent.svelte
+frontend/TestRun/SCT/SctEvents.svelte
+frontend/TestRun/SCT/SctNemesis.svelte
 frontend/TestRun/SCTSubTests/Subtest.js
 frontend/TestRun/SCTSubTests/Gemini/GeminiTabBodyComponent.svelte
 frontend/TestRun/SCTSubTests/Gemini/GeminiTabComponent.svelte
@@ -390,6 +395,19 @@ templates/admin/base.html.j2
 templates/admin/index.html.j2
 templates/auth/login.html.j2
 templates/auth/register.html.j2
+templates/email/base.html.j2
+templates/email/css/styles.css
+templates/email/partials/cloud.html.j2
+templates/email/partials/custom_html.html.j2
+templates/email/partials/custom_table.html.j2
+templates/email/partials/events.html.j2
+templates/email/partials/header.html.j2
+templates/email/partials/logs.html.j2
+templates/email/partials/main.html.j2
+templates/email/partials/nemesis.html.j2
+templates/email/partials/packages.html.j2
+templates/email/partials/screenshots.html.j2
+templates/email/partials/unsupported.html.j2
 templates/notifications/assigned.html.j2
 templates/notifications/assigned_email.html.j2
 templates/notifications/email_mention.html.j2

{argus_alm-0.15.6 → argus_alm-0.15.8}/argus_alm.egg-info/requires.txt

@@ -33,3 +33,4 @@ python-jenkins>=1.7.0
 python-slugify~=6.1.1
 pygithub>=2.6.1
 boto3~=1.38.9
+prometheus-flask-exporter>=0.23.2

{argus_alm-0.15.6 → argus_alm-0.15.8}/argus_backend.py

@@ -1,5 +1,8 @@
 import logging
-from flask import Flask
+import os
+from flask import Flask, request
+from prometheus_flask_exporter import NO_PREFIX
+from argus.backend.metrics import METRICS
 from argus.backend.template_filters import export_filters
 from argus.backend.controller import admin, api, main
 from argus.backend.cli import cli_bp
@@ -12,8 +15,27 @@ from argus.backend.util.config import Config
 LOGGER = logging.getLogger(__name__)
 
 
+def register_metrics():
+    METRICS.export_defaults(group_by="endpoint", prefix=NO_PREFIX)
+    METRICS.register_default(
+        METRICS.counter(
+            "http_request_by_endpoint_total",
+            "Total Requests made",
+            labels={
+                "endpoint": lambda: request.endpoint,
+                "method": lambda: request.method,
+                "status": lambda response: response.status,
+            },
+        )
+    )
+
+
 def start_server(config=None) -> Flask:
     app = Flask(__name__, static_url_path="/s/", static_folder="public")
+    METRICS.init_app(app)
+    if os.environ.get("PROMETHEUS_MULTIPROC_DIR"):
+        with app.app_context():
+            METRICS.register_endpoint("/metrics")
     app.json_provider_class = ArgusJSONProvider
     app.json = ArgusJSONProvider(app)
     app.jinja_env.policies["json.dumps_kwargs"]["default"] = app.json.default
@@ -35,6 +57,11 @@ def start_server(config=None) -> Flask:
     app.register_blueprint(api.bp)
     app.register_blueprint(admin.bp)
     app.register_blueprint(cli_bp)
+    with app.app_context():
+        try:
+            register_metrics()
+        except ValueError:
+            pass
 
     app.logger.info("Ready.")
     return app

{argus_alm-0.15.6 → argus_alm-0.15.8}/argus_web.example.yaml

@@ -40,7 +40,7 @@ AWS_CLIENT_SECRET: YourSecretKey
 # Client ID of a github oauth application
 GITHUB_CLIENT_ID: YOUR_GITHUB_CLIENT_ID
 # Scopes used for Github Application:
-# GITHUB_SCOPES: 'user:email read:user read:org repo'
+# GITHUB_SCOPES: 'user:email read:user read:org'
 # Client secret of a github oauth application
 GITHUB_CLIENT_SECRET: YOUR_GITHUB_CLIENT_SECRET
 # Github personal access token

argus_alm-0.15.8/docs/api_usage.md

@@ -0,0 +1,280 @@
+# Argus API
+
+To use argus API the user first should generate an API token. To do so, proceed to the Profile Page inside the application and locate the button to generate the token. WARNING: The token will be shown only once, so be sure to save it after copying. For each API call, the token should be provided as part of Authorization header, example:
+
+```sh
+curl --request GET \
+ --url https://argus.scylladb.com/api/v1/client/driver_matrix/test_report?buildId=example/driver-matrix/test \
+ --header "Authorization: token YourTokenHere"
+```
+
+## Current endpoints
+
+```http
+GET /api/v1/client/driver_matrix/test_report
+```
+
+Accepts following parameters:
+
+| Parameter | Type | Description |
+| --------- | ---- | ------------|
+| buildId          | string     | build id of the test to query            |
+
+```json
+{
+  "response": {
+    "build_id": "example/driver-matrix/test",
+    "release": "xxxxxxxx",
+    "test": "testing-driver-matrix",
+    "versions": {
+      "datastax": [
+        "pytest.datastax.v3.3.24.0",
+        "pytest.datastax.v3.3.25.0",
+        "pytest.datastax.v4.3.24.0",
+        "pytest.datastax.v4.3.25.0"
+      ],
+      "scylla": [
+        "pytest.scylla.v3.3.24.8",
+        "pytest.scylla.v3.3.25.5",
+        "pytest.scylla.v4.3.24.8",
+        "pytest.scylla.v4.3.25.5"
+      ]
+    }
+  },
+  "status": "ok"
+}
+```
+
+```http
+POST /api/v1/planning/plan/trigger
+```
+
+Accepts following payload:
+
+Type: application/json
+
+| Parameter | Type | Description |
+| --------- | ---- | ------------|
+| release          | string     | Release name to trigger plans in (can be mixed vith version to narrow filter)            |
+| plan_id          | string     | Specific plan id to trigger            |
+| version          | string     | Target scylla version of plans to trigger             |
+| common_params          | object{ param_name: value }     | Common parameters, such as backend            |
+| params          | object{ param_name: value }[]     | specific job parameters            |
+
+Example payload:
+
+```json
+{
+  {
+  "version": "2024.3.1~rc0",
+  "release": "scylla-master",
+  "plan_id": "some-plan-uuid",
+  "common_params": {
+      "instance_provision": "spot",
+  },
+  "params": [
+      {
+          "test": "longevity",
+          "backend": "aws",
+          "region": "eu-west-1",
+          "scylla_ami_id": "ami-abcd"
+      },
+      {
+          "test": "longevity",
+          "backend": "azure",
+          "region": "us-east1",
+          "azure_image_id": "/subscriptions…",
+      }
+  ]
+  }
+
+}
+```
+
+```json
+{
+  "response": {
+    "jobs": [
+      "http://jenkins/path/job/one/1",
+      "http://jenkins/path/job/two/3",
+      "http://jenkins/path/job/three/5",
+      "http://jenkins/path/job/four/9"
+    ],
+    "failed_to_execute": [
+      "path/job/one",
+      "path/job/two",
+      "path/job/three",
+      "path/job/four"
+    ]
+  },
+  "status": "ok"
+}
+```
+
+Additionally, this endpoint is available inside `argus-client-generic` executable, as follows:
+
+```bash
+argus-client-generic trigger-jobs --api-key $key --version $version --plan_id $id --release $release --job-info-file $file_path
+```
+
+`--job-info-file` is a .json file containing `common_params` and `params` parts of the payload, everything else is specified on the command line.
+
+
+
+## Email reporting API
+
+```http
+POST /api/v1/client/testrun/report/email
+```
+
+### Payload
+
+|Key|Type|Description|
+|---|----|-----------|
+|recepients|array of string| List of email report recepients |
+|title|string| Title of the email. Use `#auto` for automatically generated title |
+|run_id|string| UUID of the run to report |
+|attachments| Attachment[] | list of attachments to send |
+|sections | mixed(string, Section)[] | list of mixed strings of section names or Section object |
+
+#### Attachment
+
+|Field|Type|Description|
+|-----|----|-----------|
+|filename|string| Filename of the attachment |
+|data|string| Base64 encoded payload |
+
+#### Section
+
+|Field|Type|Description|
+|-----|----|-----------|
+|type|string| Section type [Required]|
+|options| Options | Options object with supported option keys |
+
+Supported sections are:
+
+| Name|Description|
+|-----|-----------|
+| header| Topmost header of the email. Contains the link to the Argus run and a status icon |
+| main| Info block similar to the Info tab on the Argus run page. Contains info about the run such as runtime, used scylla version and sct branch and others. |
+| packages| Table with package name and version information |
+| logs| List of links to the log files stored on S3 for this run |
+| cloud| Contains active remaining resources running at the end the test. Table |
+| nemesis| Table of nemeses in the run with their status and durations |
+| events| Event block of most recent events sorted by timestamp |
+| screenshots| Grafana screenshot gallery |
+| custom_table| Custom table element. Can be used to display arbitrary tables. HTML in cells is **not** supported |
+| custom_html| Arbitrary HTML |
+
+If a section is unrecognized, it will be rendered as a special "Unsupported" section which will print all the options sent to that section.
+
+If a section is passed but data for it in Argus is empty, the section won't be rendered. Some sections are always attempted to be rendered.
+
+The `section` block can be provided as empty array to use the default template.
+
+##### Section options
+
+###### Events
+
+|Option|Type|Description|
+|------|----|-----------|
+|amount_per_severity| number | Amount of events per severity to display (default 10)|
+|severity_filter| string[] | Names of severities to include in the email (default [CRITICAL, ERROR]). Available severities: CRITICAL, ERROR, WARNING, NORMAL, DEBUG  (case-sensitive)|
+
+###### Nemesis
+
+|Option|Type|Description|
+|------|----|-----------|
+|sort_order| tuple of key of NemesisRunInfo, direction | Default (start_time, desc). Direction can be: asc, desc. `NemesisRunInfo` can be viewed [here](https://github.com/scylladb/argus/blob/master/argus/backend/plugins/sct/udt.py#L78) |
+|status_filter| string[] | Names of nemesis status to include in the email (default [failed, succeeded]). Available statuses: started, running, failed, skipped, succeeded, terminated (case-sensitive)|
+
+###### Custom Table
+
+|Option|Type|Description|
+|------|----|-----------|
+|table_name| string | Table title|
+|headers| any[] | Table header columns (Required) |
+|rows| any[][] | Array of table cell arrays. |
+
+###### Custom HTML
+
+|Option|Type|Description|
+|------|----|-----------|
+|section_name| string | Section Title |
+|html| string | Section HTML Content |
+
+Example:
+
+```json
+{
+  "section_name": "Additional Info",
+  "html": "<h1 title='lorem' style='background-color: red'>loremLorem, ipsum dolor.</h1><p>Lorem ipsum dolor sit amet consectetur adipisicing elit. Nisi maiores, eius nemo veritatis dolorem blanditiis nam magni dicta laborum iste!</p>"
+}
+```
+
+
+### Example payload
+
+```json
+{
+    "recepients": [
+        "john.smith@scylladb.com"
+    ],
+    "run_id": "17351a94-3aba-41de-aba5-cda123dff0bb",
+    "title": "#auto",
+    "attachments": [
+    ],
+    "sections": [
+        "header",
+        "main",
+        "packages",
+        "screenshots",
+        "cloud",
+        {
+            "type": "events",
+            "options": {
+                "amount_per_severity": 10,
+                "severity_filter": [
+                    "CRITICAL",
+                    "ERROR"
+                ]
+            }
+        },
+        {
+            "type": "nemesis",
+            "options": {
+                "sort_order": [
+                    "start_time",
+                    "desc"
+                ],
+                "status_filter": [
+                    "failed",
+                    "succeeded"
+                ]
+            }
+        },
+        "logs",
+        {
+            "type": "custom_table",
+            "options": {
+                "table_name": "My Table",
+                "headers": ["hello", "one", "two"],
+                "rows": [
+                    [1,2,3],
+                    ["four", "five", "six"]
+                ]
+            }
+        }
+    ]
+}
+
+```
+
+### Response
+
+```json
+{
+  "response": true,
+  "status": "ok"
+}
+```