pyfsr

A modern, typed Python client for the FortiSOAR REST API — record CRUD, a fluent query DSL, Pydantic models, and a framework-agnostic tool registry for driving FortiSOAR from an LLM agent.

pip install pyfsr
from pyfsr import FortiSOAR

client = FortiSOAR("soar.example.com", "your-api-token")
alerts = client.alerts.list()

Getting Started

Install pyfsr, connect to an appliance, and make your first calls.

Getting Started
Authentication

API keys vs. username/password, SSL options, and environment config.

Authentication
Working with Records

Generic CRUD over any module, typed models, and picklist resolution.

Working with Records
Querying

Build FortiSOAR queries fluently with the Query DSL and paginate results.

Querying
Module Administration

Create modules, add and alter fields, track pending changes, and publish.

Module Schema Administration
Field Schema Reference

Every field type, its properties, and how relationship fields wire to other modules.

Module & Field Schema Reference
Connectors

Discover, configure, execute, and install connectors; manage remote agents.

Connectors
Playbook Authoring

Author playbooks in YAML, compile them, and deploy through the API or CLI.

Playbook Authoring & Deployment
AI & Agents

Expose FortiSOAR as tools to Claude, OpenAI, or the bundled MCP server.

AI & Agents
Appliance CLI

Administer the appliance over SSH: services, DB, queues, logs, HA, certs.

Appliance Administration CLI
API Reference

The complete, auto-generated reference for every module and class.

API Reference