{"id":19653556,"url":"https://github.com/sematext/sematext-api-client-python","last_synced_at":"2026-01-05T15:07:25.007Z","repository":{"id":45296632,"uuid":"260439639","full_name":"sematext/sematext-api-client-python","owner":"sematext","description":"Sematext API Client for Python","archived":false,"fork":false,"pushed_at":"2024-07-22T14:33:54.000Z","size":294,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-03-13T08:59:59.386Z","etag":null,"topics":["alerting","api-client","cloud","log-shipping","monitoring","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sematext.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-05-01T11:08:15.000Z","updated_at":"2021-12-23T10:46:29.000Z","dependencies_parsed_at":"2022-09-13T13:40:30.630Z","dependency_job_id":null,"html_url":"https://github.com/sematext/sematext-api-client-python","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sematext%2Fsematext-api-client-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sematext%2Fsematext-api-client-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sematext%2Fsematext-api-client-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sematext%2Fsematext-api-client-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sematext","download_url":"https://codeload.github.com/sematext/sematext-api-client-python/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245240828,"owners_count":20583102,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alerting","api-client","cloud","log-shipping","monitoring","python"],"created_at":"2024-11-11T15:14:29.741Z","updated_at":"2026-01-05T15:07:24.974Z","avatar_url":"https://github.com/sematext.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# \u003cimg src=\"https://sematext.com/wp-content/uploads/2020/09/just-octi-blue.png\" valign=\"bottom\" width=\"60px\"/\u003e**\u0026nbsp;\u0026nbsp;sematext-api-client-python**\n\n\u003cbr\u003e\n\n\u003e*A [Sematext Cloud](https://sematext.com/cloud/) API client, for interaction with Sematext Cloud solution monitoring, alerting and log shipping.*\n\n\u003cbr\u003e\n\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n\n\u003cbr\u003e\nOne of a family of clients in following flavours:\n\u003cbr\u003e\n\u003cbr\u003e\n\n* [sematext-api-client-javascript](https://github.com/sematext/sematext-api-client-javascript \"Javascript\")\n* [sematext-api-client-rust](https://github.com/sematext/sematext-api-client-rust \"Rust\")\n* [sematext-api-client-ruby](https://github.com/sematext/sematext-api-client-ruby \"Ruby\")\n* [sematext-api-client-python](https://github.com/sematext/sematext-api-client-python \"Python\")\n* [sematext-api-client-php](https://github.com/sematext/sematext-api-client-php \"PHP\")\n* [sematext-api-client-java](https://github.com/sematext/sematext-api-client-java \"Java\")\n* [sematext-api-client-go](https://github.com/sematext/sematext-api-client-go \"Go/Golang\")\n\n\u003cbr\u003e\nRefer to below link for deeper information on the API itself.\n\u003cbr\u003e\n\u003cbr\u003e\n\n* [Sematext Cloud API Reference](https://sematext.com/docs/api/ \"API Reference\")\n\n\u003cbr\u003e\n\n## Contents\n\n- [\u003cimg src=\"https://sematext.com/wp-content/uploads/2020/09/just-octi-blue.png\" valign=\"bottom\" width=\"60px\"/\u003e**\u0026nbsp;\u0026nbsp;sematext-api-client-python**](#sematext-api-client-python)\n  - [Contents](#contents)\n  - [Getting Started](#getting-started)\n  - [Authentication](#authentication)\n  - [Requirements.](#requirements)\n  - [Installation](#installation)\n    - [pip install](#pip-install)\n    - [Testing](#testing)\n    - [Setuptools](#setuptools)\n  - [Getting Started](#getting-started-1)\n  - [Reference](#reference)\n  - [Documentation For Models](#documentation-for-models)\n\n\u003cbr\u003e\n\n\n## Getting Started\n\nThese instructions will get you a copy of the project up and running on your local machine for development and testing purposes.\n\n## Authentication\n\nThis client code requires a Sematext API Access token to function. You can find this by logging into your [Sematext Cloud Account](https://apps.sematext.com/ui/account/api)\n\n\n## Requirements.\n\nPython 2.7 and 3.4+\n\n## Installation\n### pip install\n\nIf the python package is hosted on Github, you can install directly from Github\n\n```sh\npip install git+https://github.com/sematext/sematext-api-client-python.git\n```\n(you may need to run `pip` with root permission: `sudo pip install git+https://github.com/sematext-api-client-python.git`)\n\nThen import the package:\n```python\nimport stcloud\n```\n\n### Testing\n\n```bash\npython -m unittest discover\n```\n\n### Setuptools\n\nInstall via [Setuptools](http://pypi.python.org/pypi/setuptools).\n\n```sh\npython setup.py install --user\n```\n(or `sudo python setup.py install` to install the package for all users)\n\nThen import the package:\n```python\nimport stcloud\n```\n\n## Getting Started\n\nPlease follow the [installation procedure](#installation--usage) and then run the following:\n\n```python\nfrom __future__ import print_function\nimport time\nimport stcloud\nfrom stcloud.rest import ApiException\nfrom pprint import pprint\n\n# Configure API key authorization: api_key\nconfiguration = stcloud.Configuration()\nconfiguration.api_key['Authorization'] = 'YOUR_API_KEY'\n# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed\n# configuration.api_key_prefix['Authorization'] = 'Bearer'\n\n# create an instance of the API class\napi_instance = stcloud.AlertNotificationsApi(stcloud.ApiClient(configuration))\napp_id = 789 # int | appId\ntime_interval = stcloud.AlertNotificationRequest() # AlertNotificationRequest | Time Interval\n\ntry:\n    # Get alert notifications for an app\n    api_response = api_instance.get_alert_notifications_for_app_using_post(app_id, time_interval)\n    pprint(api_response)\nexcept ApiException as e:\n    print(\"Exception when calling AlertNotificationsApi-\u003eget_alert_notifications_for_app_using_post: %s\\n\" % e)\n\n```\n\n## Reference\n\nAll URIs are relative to *https://localhost*\n\n| Class                      | Method                                                                                                                         | HTTP request                                                          | Description                                                                                             |\n| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |\n| *AlertNotificationsApi*    | [**get_alert_notifications_for_app_using_post**](docs/AlertNotificationsApi.md#get_alert_notifications_for_app_using_post)     | **POST** /users-web/api/v3/apps/{appId}/notifications/alerts          | Get alert notifications for an app                                                                      |\n| *AlertNotificationsApi*    | [**get_alert_notifications_for_user_using_post1**](docs/AlertNotificationsApi.md#get_alert_notifications_for_user_using_post1) | **POST** /users-web/api/v3/notifications/alerts                       | Get alert notifications for a user                                                                      |\n| *AlertsApi*                | [**create_alert_using_post**](docs/AlertsApi.md#create_alert_using_post)                                                       | **POST** /users-web/api/v3/alerts                                     | Create alert rule                                                                                       |\n| *AlertsApi*                | [**delete_alert_rule_using_delete1**](docs/AlertsApi.md#delete_alert_rule_using_delete1)                                       | **DELETE** /users-web/api/v3/alerts/{updateableAlertId}               | Delete alert rule                                                                                       |\n| *AlertsApi*                | [**disable_alert_rule_using_put1**](docs/AlertsApi.md#disable_alert_rule_using_put1)                                           | **PUT** /users-web/api/v3/alerts/{updateableAlertId}/disable          | Disable alert rule                                                                                      |\n| *AlertsApi*                | [**enable_alert_rule_using_put1**](docs/AlertsApi.md#enable_alert_rule_using_put1)                                             | **PUT** /users-web/api/v3/alerts/{updateableAlertId}/enable           | Enable alert rule                                                                                       |\n| *AlertsApi*                | [**get_alert_rules_for_app_using_get1**](docs/AlertsApi.md#get_alert_rules_for_app_using_get1)                                 | **GET** /users-web/api/v3/apps/{appId}/alerts                         | Get alert rules for an app                                                                              |\n| *AppsApi*                  | [**delete_using_delete1**](docs/AppsApi.md#delete_using_delete1)                                                               | **DELETE** /users-web/api/v3/apps/{anyStateAppId}                     | delete                                                                                                  |\n| *AppsApi*                  | [**get_app_types_using_get**](docs/AppsApi.md#get_app_types_using_get)                                                         | **GET** /users-web/api/v3/apps/types                                  | Get all App types supported for the account identified with apiKey                                      |\n| *AppsApi*                  | [**get_using_get1**](docs/AppsApi.md#get_using_get1)                                                                           | **GET** /users-web/api/v3/apps/{anyStateAppId}                        | Gets defails for one particular App                                                                     |\n| *AppsApi*                  | [**invite_app_guests_using_post1**](docs/AppsApi.md#invite_app_guests_using_post1)                                             | **POST** /users-web/api/v3/apps/guests                                | Invite guests to an app                                                                                 |\n| *AppsApi*                  | [**list_apps_users_using_get1**](docs/AppsApi.md#list_apps_users_using_get1)                                                   | **GET** /users-web/api/v3/apps/users                                  | Get all users of apps accessible to this account                                                        |\n| *AppsApi*                  | [**list_using_get**](docs/AppsApi.md#list_using_get)                                                                           | **GET** /users-web/api/v3/apps                                        | Get all apps accessible by account identified with apiKey                                               |\n| *AppsApi*                  | [**update_description_using_put**](docs/AppsApi.md#update_description_using_put)                                               | **PUT** /users-web/api/v3/apps/{anyStateAppId}/description            | Update description of the app                                                                           |\n| *AppsApi*                  | [**update_using_put2**](docs/AppsApi.md#update_using_put2)                                                                     | **PUT** /users-web/api/v3/apps/{anyStateAppId}                        | Update app                                                                                              |\n| *BillingApi*               | [**get_detailed_invoice_using_get1**](docs/BillingApi.md#get_detailed_invoice_using_get1)                                      | **GET** /users-web/api/v3/billing/invoice/{service}/{year}/{month}    | Get invoice details                                                                                     |\n| *BillingApi*               | [**list_available_plans_using_get**](docs/BillingApi.md#list_available_plans_using_get)                                        | **GET** /users-web/api/v3/billing/availablePlans                      | Get available plans                                                                                     |\n| *BillingApi*               | [**update_plan_using_put**](docs/BillingApi.md#update_plan_using_put)                                                          | **PUT** /users-web/api/v3/billing/info/{appId}                        | Update plan for an app                                                                                  |\n| *LogsAppApi*               | [**create_logsene_application**](docs/LogsAppApi.md#create_logsene_application)                                                | **POST** /logsene-reports/api/v3/apps                                 | Create Logs App                                                                                         |\n| *MonitoringAppApi*         | [**create_spm_application1**](docs/MonitoringAppApi.md#create_spm_application1)                                                | **POST** /spm-reports/api/v3/apps                                     | Create Monitoring App                                                                                   |\n| *ResetPasswordApi*         | [**reset_password_using_post1**](docs/ResetPasswordApi.md#reset_password_using_post1)                                          | **POST** /users-web/api/v3/account/password/reset                     | Reset Password                                                                                          |\n| *SubscriptionsApi*         | [**create_for_app_using_post1**](docs/SubscriptionsApi.md#create_for_app_using_post1)                                          | **POST** /users-web/api/v3/apps/{appId}/subscription                  | Create App subscription                                                                                 |\n| *SubscriptionsApi*         | [**create_for_dash_using_post1**](docs/SubscriptionsApi.md#create_for_dash_using_post1)                                        | **POST** /users-web/api/v3/dashboards/{dashId}/subscription           | Create dashboard subscription                                                                           |\n| *SubscriptionsApi*         | [**delete_using_delete3**](docs/SubscriptionsApi.md#delete_using_delete3)                                                      | **DELETE** /users-web/api/v3/subscriptions/{updateableSubscriptionId} | Delete subscription                                                                                     |\n| *SubscriptionsApi*         | [**list_using_get3**](docs/SubscriptionsApi.md#list_using_get3)                                                                | **GET** /users-web/api/v3/apps/{appId}/subscriptions                  | Get subscriptions for an App                                                                            |\n| *SubscriptionsApi*         | [**list_using_get4**](docs/SubscriptionsApi.md#list_using_get4)                                                                | **GET** /users-web/api/v3/subscriptions                               | Get current account\u0026#39;s subscriptions                                                                 |\n| *SubscriptionsApi*         | [**send_app_report_using_post1**](docs/SubscriptionsApi.md#send_app_report_using_post1)                                        | **POST** /users-web/api/v3/apps/{appId}/report/send                   | Email an App report                                                                                     |\n| *SubscriptionsApi*         | [**send_dash_report_using_post1**](docs/SubscriptionsApi.md#send_dash_report_using_post1)                                      | **POST** /users-web/api/v3/dashboards/{dashId}/report/send            | Email a dashboard report                                                                                |\n| *SubscriptionsApi*         | [**toggle_enabled_using_put1**](docs/SubscriptionsApi.md#toggle_enabled_using_put1)                                            | **PUT** /users-web/api/v3/subscriptions/{updateableSubscriptionId}    | Toggle subscription status                                                                              |\n| *SubscriptionsApi*         | [**update_for_app_using_put**](docs/SubscriptionsApi.md#update_for_app_using_put)                                              | **PUT** /users-web/api/v3/apps/{appId}/subscription                   | Update App subscription                                                                                 |\n| *SubscriptionsApi*         | [**update_for_dash_using_put1**](docs/SubscriptionsApi.md#update_for_dash_using_put1)                                          | **PUT** /users-web/api/v3/dashboards/{dashId}/subscription            | Update dashboard subscription                                                                           |\n| *AwsSettingsControllerApi* | [**update_using_put**](docs/AwsSettingsControllerApi.md#update_using_put)                                                      | **PUT** /users-web/api/v3/apps/{appId}/aws                            | Update App\u0026#39;s AWS CloudWatch settings                                                                |\n| *TagApiControllerApi*      | [**get_tag_names_using_get1**](docs/TagApiControllerApi.md#get_tag_names_using_get1)                                           | **GET** /spm-reports/api/v3/apps/{appIds}/tagNames                    | Gets tag names for the given application identifiers appearing in the given time frame.                 |\n| *TagApiControllerApi*      | [**get_using_get1**](docs/TagApiControllerApi.md#get_using_get1)                                                               | **GET** /spm-reports/api/v3/apps/{appIds}/tags                        | Gets values for specified tags for the given application identifiers appearing in the given time frame. |\n| *TagApiControllerApi*      | [**get_using_get2**](docs/TagApiControllerApi.md#get_using_get2)                                                               | **GET** /spm-reports/api/v3/apps/{appIds}/metrics/filters             | Gets values for specified tags for the given application identifiers appearing in the given time frame. |\n| *TokensApiControllerApi*   | [**create_app_token1**](docs/TokensApiControllerApi.md#create_app_token1)                                                      | **POST** /users-web/api/v3/apps/{appId}/tokens                        | Create new app token                                                                                    |\n| *TokensApiControllerApi*   | [**delete_app_token1**](docs/TokensApiControllerApi.md#delete_app_token1)                                                      | **DELETE** /users-web/api/v3/apps/{appId}/tokens/{tokenId}            | Delete app token                                                                                        |\n| *TokensApiControllerApi*   | [**get_app_tokens**](docs/TokensApiControllerApi.md#get_app_tokens)                                                            | **GET** /users-web/api/v3/apps/{appId}/tokens                         | Get app available tokens                                                                                |\n| *TokensApiControllerApi*   | [**regenerate_app_token1**](docs/TokensApiControllerApi.md#regenerate_app_token1)                                              | **POST** /users-web/api/v3/apps/{appId}/tokens/{tokenId}/regenerate   | Regenerate app token)                                                                                   |\n| *TokensApiControllerApi*   | [**update_app_token**](docs/TokensApiControllerApi.md#update_app_token)                                                        | **PUT** /users-web/api/v3/apps/{appId}/tokens/{tokenId}               | Update app token (enable/disable or name)                                                               |\n\n\n## Documentation For Models\n\n - [AlertNotificationRequest](docs/AlertNotificationRequest.md)\n - [AlertRule](docs/AlertRule.md)\n - [AlertRuleScheduleTimeRangeDto](docs/AlertRuleScheduleTimeRangeDto.md)\n - [AlertRuleScheduleWeekdayDto](docs/AlertRuleScheduleWeekdayDto.md)\n - [App](docs/App.md)\n - [AppDescription](docs/AppDescription.md)\n - [AppMetadata](docs/AppMetadata.md)\n - [BasicAuthMethodDto](docs/BasicAuthMethodDto.md)\n - [BasicOrganizationDto](docs/BasicOrganizationDto.md)\n - [BillingInfo](docs/BillingInfo.md)\n - [CloudWatchSettings](docs/CloudWatchSettings.md)\n - [CreateAppInfo](docs/CreateAppInfo.md)\n - [CreateTokenDto](docs/CreateTokenDto.md)\n - [Error](docs/Error.md)\n - [FilterValue](docs/FilterValue.md)\n - [GenericApiResponse](docs/GenericApiResponse.md)\n - [Invitation](docs/Invitation.md)\n - [NotificationIntegration](docs/NotificationIntegration.md)\n - [Plan](docs/Plan.md)\n - [ReportInfo](docs/ReportInfo.md)\n - [ServiceIntegration](docs/ServiceIntegration.md)\n - [SubscriptionDashboardDto](docs/SubscriptionDashboardDto.md)\n - [SubscriptionDto](docs/SubscriptionDto.md)\n - [UpdateAppInfo](docs/UpdateAppInfo.md)\n - [UpdateSubscriptionDto](docs/UpdateSubscriptionDto.md)\n - [UpdateTokenDto](docs/UpdateTokenDto.md)\n - [UserInfo](docs/UserInfo.md)\n - [UserPermissions](docs/UserPermissions.md)\n - [UserRole](docs/UserRole.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsematext%2Fsematext-api-client-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsematext%2Fsematext-api-client-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsematext%2Fsematext-api-client-python/lists"}