Skip to main content

DEPRECATED -- This project has been merged into xsoar-cli and will receive no further updates.

xsoar-client

Python client library for Palo Alto XSOAR (formerly Demisto). Provides programmatic access to XSOAR servers for content pack management, case operations, and artifact handling.

This library is the foundation for xsoar-cli. Use xsoar-client directly when building custom integrations or automation scripts. For command-line usage, use xsoar-cli instead.

Installation

pip install xsoar-client

Requirements

  • Python 3.10 or higher
  • XSOAR/XSIAM server (version 6 or 8)
  • Valid API credentials

Configuration

Environment Variables

Authentication credentials are read from environment variables:

  • DEMISTO_API_KEY - XSOAR API key
  • DEMISTO_BASE_URL - XSOAR server URL (e.g., https://xsoar.example.com)
  • XSIAM_AUTH_ID - XSIAM authentication ID (XSOAR 8 only)

ClientConfig Parameters

  • server_version (required) - XSOAR server version (6 or 8)
  • custom_pack_authors - List of custom pack authors (default: [])
  • api_token - API token (default: from DEMISTO_API_KEY environment variable)
  • server_url - Server URL (default: from DEMISTO_BASE_URL environment variable)
  • xsiam_auth_id - XSIAM auth ID (default: from XSIAM_AUTH_ID environment variable)
  • verify_ssl - SSL verification, boolean or path to CA bundle (default: False)

Artifact Providers

Artifact providers handle storage and retrieval of custom content packs from cloud storage.

AWS S3

Requires AWS credentials configured via AWS CLI or standard AWS environment variables.

Azure Blob Storage

Requires AZURE_STORAGE_SAS_TOKEN environment variable.

Use Cases

  • Custom automation scripts for XSOAR operations
  • CI/CD pipeline integration for content deployment
  • Bulk operations across multiple XSOAR instances
  • Custom tooling built on top of XSOAR APIs

For CLI-based workflows and usage examples, see xsoar-cli.

License

Distributed under the MIT license.

Metadata

Release files for xsoar-client 2.2.1

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

Source distribution (sdist)

Source distribution for xsoar-client 2.2.1
File Size Uploaded
xsoar_client-2.2.1.tar.gz 38.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for xsoar-client 2.2.1
File Interpreter ABI Platform
xsoar_client-2.2.1-py3-none-any.whl Python 3 none any Details

Total release size: 52.8 kB

Release files / xsoar_client-2.2.1.tar.gz

Download URL xsoar_client-2.2.1.tar.gz
Size 38.4 kB
Tags Source
SHA-256 checksum
How to use checksums
ff8efd98f55a8af53ca7c6ffaac8a7a653d85bd9a0663c0e5e2111c6bbfeb770
BLAKE2b-256 checksum
How to use checksums
7c8433f4ebf302e62cf64690b0b7424ad2a09cb3c52f0faa3eb86d5f3442492f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 30, 2026.

Transparency log

Release files / xsoar_client-2.2.1-py3-none-any.whl

Download URL xsoar_client-2.2.1-py3-none-any.whl
Size 14.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b70743b25d209362072a897e5737cd413cb3cfa1b70bcdf77ee9bbb4a576e243
BLAKE2b-256 checksum
How to use checksums
26490551ba99cc1edf16e8e2a33235bc26bf50593ff864f8fc404962d3cef7ee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 30, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

2.2.1 This release

2 release files

2.2.0

2 release files

2.1.0

2 release files

2.0.9

2 release files

2.0.8

2 release files

2.0.7

2 release files

2.0.6

2 release files

2.0.5

2 release files

2.0.4

2 release files

2.0.3

2 release files

2.0.2

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page