Taegis SDK for Python

The Taegis SDK is a Python library for interfacing with the GraphQL APIs in Taegis.

Prerequisites

Python 3.8 or higher.

Authentication

Set CLIENT_ID and CLIENT_SECRET environment variables as described in the Taegis XDR Documenation.

Device Code SSO

Installation

python -m pip install taegis-sdk-python

Using the SDK

To use the SDK, you must first import the GraphQLService

from taegis_sdk_python import GraphQLService
from pprint import pprint as pp

service = GraphQLService()

Now that you have the GraphQLService, you can make requests and process responses for Taegis XDR Services. The following example uses the Investigations Service to send a query to get all available investigations

result = service.investigations.query.investigations_search(
    page=1, per_page=3, query="WHERE deleted_at IS NOT NULL EARLIEST=-90d"
)
pp(result)

result = service.tenants.query.tenants(
    tenants_query=TenantsQuery(
        max_results=10,
        page_num=1,
    )
)
pp(result)

results = service.events.subscription.event_query(
    query="FROM process EARLIEST=-1d",
    options=EventQueryOptions(
        max_rows=20,
        page_size=10,
        skip_cache=True,
    ),
)
pp(results)
print()
try:
    next_page = next(iter({result.next for result in results if result.next}))
except StopIteration:
    next_page = None

if next_page:
    results = service.events.subscription.event_page(page_id=next_page)
    pp(results)

Getting Started Exploring the Schema

from taegis_sdk_python import GraphQLService

service = GraphQLService()
schema = service.core.get_sync_schema()

For more in depth analysis see: Exploring the Schema

For more information see the Getting Started

Metadata

Release files for taegis-sdk-python 2.0.2

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

Source distribution (sdist)

Source distribution for taegis-sdk-python 2.0.2
File	Size	Uploaded
taegis_sdk_python-2.0.2.tar.gz	262.9 kB	Sep 4, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for taegis-sdk-python 2.0.2
File	Interpreter	ABI	Platform	Reset
taegis_sdk_python-2.0.2-py3-none-any.whl 456.1 kB Sep 4, 2026	Python 3	none	any	Details

Total release size: 719.0 kB

Release files / taegis_sdk_python-2.0.2.tar.gz

Download URL	taegis_sdk_python-2.0.2.tar.gz
Size	262.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`4adc1da35ceffbed3d823b399b4e3f3cf504a0be1c069930aabcd101cea48645`
BLAKE2b-256 checksum How to use checksums	`066f8725ce69df027dab4c703e7a361e8ebfa6156b2138c050f191434a4e218d`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`Hatch/1.16.4 cpython/3.11.9 HTTPX/0.28.1`

Release files / taegis_sdk_python-2.0.2-py3-none-any.whl

Download URL	taegis_sdk_python-2.0.2-py3-none-any.whl
Size	456.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c2ba3d99d852fa7f688596a6a4157213a409f1f6749e859e42339122cb64b1a9`
BLAKE2b-256 checksum How to use checksums	`c7f2995c1d1d4b92e898cc1269e8ebee1aac2ac5664f35928c65215e3e064095`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`Hatch/1.16.4 cpython/3.11.9 HTTPX/0.28.1`