thousandeyes-sdk-usage

These usage endpoints define the following operations:

Usage: Retrieve usage data for the specified time period (default is one month).
- Users must have the View organization usage permission to access this endpoint.
- This operation offers visibility across all account groups within the organization.
- Users with View organization usage permission in multiple organizations should query the operation with the aid query string parameter (see optional parameters) for each organization.
- The agentId field in enterprise agent unit responses may be omitted when not available.
Quotas: Obtain organization and account usage quotas. Additionally, users with the appropriate permissions can create, update, or delete these quotas.
- Users must have the necessary permissions to perform quota-related actions.

Refer to the Usage API operations for detailed usage instructions and optional parameters.

This Python package is automatically generated by the OpenAPI Generator project:

API version: 7.0.104
Generator version: 7.6.0
Build package: com.thousandeyes.api.codegen.ThousandeyesPythonGenerator

Requirements.

Python 3.9+

Installation & Usage

pip install

Install directly via PyPi:

pip install thousandeyes-sdk-usage

(you may need to run pip with root permission: sudo pip install thousandeyes-sdk-usage)

Then import the package:

import thousandeyes_sdk.usage

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import thousandeyes_sdk.usage

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import thousandeyes_sdk.core
import thousandeyes_sdk.usage
from thousandeyes_sdk.core.exceptions import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://api.thousandeyes.com/v7
# See configuration.py for a list of all supported configuration parameters.
configuration = thousandeyes_sdk.core.Configuration(
    host = "https://api.thousandeyes.com/v7"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure Bearer authorization: BearerAuth
configuration = thousandeyes_sdk.core.Configuration(
    access_token = os.environ["BEARER_TOKEN"]
)


# Enter a context with an instance of the API client
with thousandeyes_sdk.core.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = thousandeyes_sdk.usage.QuotasApi(api_client)
    organizations_quotas_assign = thousandeyes_sdk.usage.OrganizationsQuotasAssign() # OrganizationsQuotasAssign |  (optional)

    try:
        # Create or update accout group quotas
        api_response = api_instance.assign_organizations_account_groups_quotas(organizations_quotas_assign=organizations_quotas_assign)
        print("The response of QuotasApi->assign_organizations_account_groups_quotas:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling QuotasApi->assign_organizations_account_groups_quotas: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://api.thousandeyes.com/v7

Class	Method	HTTP request	Description
QuotasApi	assign_organizations_account_groups_quotas	POST /quotas/account-groups/assign	Create or update accout group quotas
QuotasApi	assign_organizations_quotas	POST /quotas/assign	Create or update organizations quotas
QuotasApi	get_quotas	GET /quotas	Get organization and account group usage quota
QuotasApi	unassign_organizations_account_groups_quotas	POST /quotas/account-groups/unassign	Remove account group quotas from organizations
QuotasApi	unassign_organizations_quotas	POST /quotas/unassign	Remove organization quotas
UsageApi	get_enterprise_agents_units_usage	GET /usage/units/enterprise-agents	Get enterprise agent usage
UsageApi	get_tests_units_usage	GET /usage/units/tests	Get cloud and enterprise agents units usage
UsageApi	get_usage	GET /usage	Get usage information for the last month

Documentation For Models

Documentation For Authorization

Authentication schemes defined for the API:

BearerAuth

Type: Bearer authentication

Author

ThousandEyes API Team

Release files for thousandeyes-sdk-usage 5.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for thousandeyes-sdk-usage 5.0.0
File	Size	Uploaded
thousandeyes_sdk_usage-5.0.0.tar.gz	50.0 kB	Sep 9, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for thousandeyes-sdk-usage 5.0.0
File	Interpreter	ABI	Platform	Reset
thousandeyes_sdk_usage-5.0.0-py3-none-any.whl 84.6 kB Sep 9, 2026	Python 3	none	any	Details

Total release size: 134.6 kB

Release files / thousandeyes_sdk_usage-5.0.0.tar.gz

Download URL	thousandeyes_sdk_usage-5.0.0.tar.gz
Size	50.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`142383a62efbf06bf51f9a33d0b8f4097c74946ea3952463eabd29ebf4fddcf8`
BLAKE2b-256 checksum How to use checksums	`2223bd7c3493d55c86a2e65a59db03ad6814b3d31d37627c5d0654da5e0ec516`
Upload date	Sep 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/thousandeyes/thousandeyes-sdk-python
Publishing commit: github.com/thousandeyes/thousandeyes-sdk-python/tree/d4b7ca82b7f3047330d34be16b4542926adfb019

Workflow

Publishing configuration: github.com/thousandeyes/thousandeyes-sdk-python/blob/d4b7ca82b7f3047330d34be16b4542926adfb019/.github/workflows/release.yaml
Publishing logs: github.com/thousandeyes/thousandeyes-sdk-python/actions/runs/34372354794/attempts/1

Artifact

Subject: thousandeyes_sdk_usage-5.0.0.tar.gz
SHA-256 checksum: 142383a62efbf06bf51f9a33d0b8f4097c74946ea3952463eabd29ebf4fddcf8 Verifying attestations

Release files / thousandeyes_sdk_usage-5.0.0-py3-none-any.whl

Download URL	thousandeyes_sdk_usage-5.0.0-py3-none-any.whl
Size	84.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ee9d93d62292dfc3a20836aa2450d47eb9cbcd840316ff38d9cc4a224e76fe20`
BLAKE2b-256 checksum How to use checksums	`91ac4f99fdba1adce345fa7ba0f1337649b3f6358c563d6bc362c17a69c4b911`
Upload date	Sep 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/thousandeyes/thousandeyes-sdk-python
Publishing commit: github.com/thousandeyes/thousandeyes-sdk-python/tree/d4b7ca82b7f3047330d34be16b4542926adfb019

Workflow

Publishing configuration: github.com/thousandeyes/thousandeyes-sdk-python/blob/d4b7ca82b7f3047330d34be16b4542926adfb019/.github/workflows/release.yaml
Publishing logs: github.com/thousandeyes/thousandeyes-sdk-python/actions/runs/34372354794/attempts/1

Artifact

Subject: thousandeyes_sdk_usage-5.0.0-py3-none-any.whl
SHA-256 checksum: ee9d93d62292dfc3a20836aa2450d47eb9cbcd840316ff38d9cc4a224e76fe20 Verifying attestations