Python SDK

pip install cybros          # Python 3.10+

from cybros import Cybros

client = Cybros(api_key="cybros_sk_...")   # or resolved from env / config
me = client.me()
print(me.email, me.active_org_id, me.role)

Cybros(
    api_key: str | None = None,
    base_url: str | None = None,
    *,
    timeout: float = 30.0,
    http_client: httpx.Client | None = None,
)

with Cybros() as client:
    scan = client.scans.create("repo_123", ref="main")

Cybros(api_key="cybros_sk_...")            # explicit
# CYBROS_API_KEY=... in the environment    # env
# after `cybros login`                     # config file

me = client.me()
print(me.user_id, me.role, me.permissions)
for org in me.organizations:
    print(org.name, org.plan)

scan = client.scans.create("repo_123", ref="main", modules=["sast", "secrets"])
scan = client.scans.wait(scan.id)
report = client.scans.report(scan.id)
print(report.total_findings, report.risk_score, report.severity_breakdown)

for f in client.scans.findings(scan.id, severity="high"):
    print(f.severity.value, f.title, f.file_path, f.line)

analysis = client.ai.analyze(scan.id)
analysis = client.ai.wait(scan.id)
print("risk:", analysis.risk_score, "confidence:", analysis.overall_confidence)
for run in sorted(analysis.agent_runs, key=lambda r: r.sequence):
    print(run.sequence, run.agent_id, run.status, run.confidence)

job = client.remediation.create(finding_id)
job = client.remediation.wait(job.id)
if job.pr_url:
    print("PR:", job.pr_url, "branch:", job.branch)

detail = client.findings.get(finding_id)
print(detail.owasp, detail.cwe, detail.cvss_score)
if detail.fix and detail.fix.unified_diff:
    print(detail.fix.unified_diff)

overview = client.compliance.overview()
print(overview.overall_score)
soc2 = client.compliance.framework("soc2")
for c in soc2.controls:
    print(c.control_id, c.status, c.title)

posture = client.ai_security.overview()
print(posture.summary.checks_failed, "/", posture.summary.checks_total)
for chk in posture.checks:
    print(chk.name, chk.owasp_llm, chk.status)

for entry in client.audit.list(action="scan.created", limit=50):
    print(entry.created_at, entry.action, entry.actor_id)

repo = client.repositories.find_by_full_name("acme/api")
if repo:
    scan = client.scans.create(repo.id, ref=repo.default_branch)

created = client.api_keys.create("ci-token", role="member")
print(created.token)   # shown once
client.api_keys.revoke("key_1a2b...")

usage = client.billing.usage()
print(usage.remaining_credits)

def on_progress(scan):
    done = sum(1 for m in scan.modules if m.status in {"completed", "failed"})
    print(f"{scan.status} — {done}/{len(scan.modules)} modules")

scan = client.scans.wait(scan.id, timeout=600, poll_interval=2.0, on_progress=on_progress)

page = client.findings.list(severity="high", limit=50)
print(len(page), "of", page.total)
for finding in page:            # Page is directly iterable
    ...

# Manual paging:
offset = 0
while True:
    page = client.scans.list(limit=100, offset=offset)
    for scan in page.items:
        ...
    offset += page.limit
    if offset >= page.total:
        break

from cybros import Cybros, AuthError, NotFoundError, CybrosError

try:
    client.scans.get("nope")
except NotFoundError:
    ...
except AuthError as e:
    print("re-authenticate:", e)
except CybrosError as e:
    print(e.status_code, e.request_id, e.body)

import asyncio
from cybros import AsyncCybros

async def main():
    async with AsyncCybros(api_key="cybros_sk_...") as client:
        me = await client.me()
        scan = await client.scans.create("repo_123", ref="main")
        scan = await client.scans.wait(scan.id)
        page = await client.scans.findings(scan.id, severity="high")
        for f in page.items:
            print(f.title)

asyncio.run(main())