pythonik
A complete, generated Python SDK for the iconik media management API.
- 15 services, one subpackage each:
pythonik.acls,pythonik.assets,pythonik.auth,pythonik.automations,pythonik.files,pythonik.jobs,pythonik.metadata,pythonik.ml,pythonik.notifications,pythonik.search,pythonik.settings,pythonik.stats,pythonik.transcode,pythonik.users,pythonik.usersnotifications - Every operation in every service — generated from iconik's published OpenAPI specs with openapi-python-client. Fully typed (attrs models,
py.typed), sync and async for every endpoint (httpx). - 2.0 is a rewrite with a 1.x compatibility layer: 1.x was hand-written and covered a subset of the API; 2.0 is generated and covers the complete API surface (953 endpoints). The full 1.x interface (
pythonik.client.PythonikClient,pythonik.specs.*,pythonik.models.*) still ships and works unchanged — see COMPAT.md for the short list of deviations.
Install
pip install pythonik
Requires Python >= 3.10.
Usage
Set your App-ID / Auth-Token credentials once, on the client; every call through that client is authenticated. Each service has its own base URL, https://app.iconik.io/API/<service>:
import os
from pythonik.assets import Client
from pythonik.assets.api.assets import get_assets_by_asset_id
client = Client(
base_url="https://app.iconik.io/API/assets",
headers={
"App-ID": os.environ["ICONIK_APP_ID"],
"Auth-Token": os.environ["ICONIK_AUTH_TOKEN"],
},
)
asset = get_assets_by_asset_id.sync(asset_id="some-asset-uuid", client=client)
print(asset)
Every endpoint module offers sync, sync_detailed, asyncio, and asyncio_detailed. The *_detailed variants return a Response with status code, headers, and the parsed body.
API function paths mirror the REST API: GET /v1/assets/{asset_id}/versions/ on the assets service is pythonik.assets.api.assets.get_assets_by_asset_id_versions. If you know the endpoint, you know the function.
All subpackages share one client implementation (pythonik._base) — a Client built for one service works for another by swapping base_url, and cross-service isinstance checks on errors/types behave as expected.
Upgrading from 1.x
Nothing to change: 2.0 vendors the 1.x implementation, so existing code keeps working —
from pythonik.client import PythonikClient
client = PythonikClient(app_id=app_id, auth_token=auth_token, timeout=10)
asset = client.assets().get(asset_id) # pythonik.models.base.Response(.response, .data)
The 1.x test suite runs against this package on every regeneration. The compat layer is frozen at the 1.x surface (~100 methods across 6 spec classes); use the generated subpackages for everything 1.x didn't cover. Deviations from 1.x (debug prints removed, loguru dropped): COMPAT.md.
How it's built
This package is generated — don't edit it by hand. It is emitted by NorthShoreAutomation/iconik-sdk-generator, which fetches iconik's live OpenAPI specs, applies lossless overlay fixes (deterministic operationIds, client-level auth via injected security schemes, enum/oneOf/content-type repairs — all bigint-safe), runs openapi-python-client per service, and merges the 15 clients into this one package. The full pipeline and the iconik spec quirks knowledge base live in that repo.
1 maintainer
Release files for nsa-pythonik 2.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nsa_pythonik-2.0.0.tar.gz | 1.3 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nsa_pythonik-2.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 5.7 MB
Release files / nsa_pythonik-2.0.0.tar.gz
| Download URL | nsa_pythonik-2.0.0.tar.gz |
|---|---|
| Size | 1.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6bae57e4dcd7c5ca8a4a250d9b036af35228dc1172587ac1c806895cf7cff1d9
|
|
BLAKE2b-256 checksum How to use checksums |
21410847188d4e70ab640090d74ad195c9a360e976760603931654a4f5918dd5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Aug 7, 2026.
Transparency logRelease files / nsa_pythonik-2.0.0-py3-none-any.whl
| Download URL | nsa_pythonik-2.0.0-py3-none-any.whl |
|---|---|
| Size | 4.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7ffb1f2e3cc681647d0685e44ac1097908b48137fd568ead1891dfd2171d116d
|
|
BLAKE2b-256 checksum How to use checksums |
7642220193e7fdd59af67ce39d915175cf7390ea5ff17697ec57f59e5f3cfc0e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Aug 7, 2026.
Transparency log
