Metadata-Version: 2.4
Name: intflow-auth-admin-sdk
Version: 0.1.1
Summary: Server-only Intflow Auth Admin API SDK.
Author: Intflow
License: Proprietary
Requires-Python: >=3.12
Requires-Dist: httpx<1,>=0.28
Provides-Extra: dev
Requires-Dist: build<2,>=1.2; extra == 'dev'
Requires-Dist: mypy<2,>=1.13; extra == 'dev'
Requires-Dist: pytest-asyncio<1,>=0.25; extra == 'dev'
Requires-Dist: pytest<9,>=8; extra == 'dev'
Requires-Dist: ruff<1,>=0.9; extra == 'dev'
Requires-Dist: twine<7,>=6; extra == 'dev'
Description-Content-Type: text/markdown

# Intflow Auth Admin SDK

Server-only Python SDK for trusted backends that call the Intflow Auth Admin
API.

This package is for backend automation and integrated management services that
already have an operator Admin API token from their own secure runtime
configuration. It does not store local operator credentials, does not perform
browser login handoff, and must not be used from browser code.

## Install

```powershell
python -m pip install intflow-auth-admin-sdk
```

## Current Status

Use a trusted runtime secret source to supply the operator Admin API token.

```python
from intflow_auth_admin_sdk import create_admin_client

with create_admin_client(token="operator-admin-token") as client:
    actor = client.whoami()
    audit_events = client.search_audit_events(
        client_id="<oauth-client-id>",
        limit=25,
    )

print(actor["user"]["email"])
print(audit_events["next_cursor"])
```

Long-running trusted backends should create one `IntflowAuthAdminClient` or
`AsyncIntflowAuthAdminClient` during startup, reuse it for Admin API calls, and
call `close()` or `aclose()` during shutdown. Caller-injected `httpx` clients
remain caller-owned.

For mocked Admin API examples, see `examples/python-sdk-consumer`.
