smartytalent-client
Python client for the SmartyTalent recruitment API, auto-generated from the OpenAPI spec using openapi-generator-cli with the python template.
Fully typed with Pydantic v2 models. Requires Python 3.9+.
Install
pip install smartytalent-client
Quick start
from smartytalent_client import ApiClient, Configuration
from smartytalent_client.api import TenantsApi
config = Configuration(
host="https://api.smartytalent.example.com",
access_token="<your-access-token>",
)
with ApiClient(config) as client:
tenants_api = TenantsApi(client)
tenants = tenants_api.list_tenants(filter_status="active")
for t in tenants:
print(t.id, t.name)
Authentication
The API uses Bearer token auth. Pass the raw token (no Bearer prefix) as access_token:
config = Configuration(
host="https://api.smartytalent.example.com",
access_token=access_token,
)
Async usage
Each API method has an _async variant built on asyncio:
import asyncio
from smartytalent_client import ApiClient, Configuration
from smartytalent_client.api import TenantsApi
async def main():
config = Configuration(host="...", access_token="...")
async with ApiClient(config) as client:
api = TenantsApi(client)
tenants = await api.list_tenants_async(filter_status="active")
print(tenants)
asyncio.run(main())
API surface
The client exposes one class per API tag, importable from smartytalent_client.api:
ActionsApi, AdsApi, ApikeysApi, AssessmentsApi, BrowsersApi, CallsApi, CandidatesApi, ChatsApi, ConversationsApi, EmailsApi, FilesApi, FindersApi, FormsApi, JobsApi, LinksApi, MeetingsApi, NotesApi, NotificationsApi, OperationsApi, PersonasApi, ReportsApi, RolesApi, RunsApi, TalentsApi, TenantsApi, TranslationsApi, TriggersApi, UsersApi, WebhooksApi, WorkflowsApi.
All request/response DTOs are Pydantic models in smartytalent_client.models.
Configuration options
Configuration accepts:
| Option | Type | Description |
|---|---|---|
host |
str |
API base URL |
access_token |
str |
OAuth2 bearer token |
api_key |
dict[str, str] |
Header-based API keys (by security scheme) |
username / password |
str |
HTTP basic auth |
verify_ssl |
bool |
Toggle TLS verification (default True) |
ssl_ca_cert |
str |
Path to a custom CA bundle |
proxy |
str |
HTTP/HTTPS proxy URL |
retries |
int |
Retry count for transient failures |
connection_pool_maxsize |
int |
urllib3 pool size |
Error handling
Non-2xx responses raise subclasses of smartytalent_client.ApiException:
from smartytalent_client import ApiException
from smartytalent_client.exceptions import NotFoundException, UnauthorizedException
try:
tenants_api.get_tenant(id="missing-id")
except NotFoundException:
...
except UnauthorizedException:
...
except ApiException as e:
print(e.status, e.reason, e.body)
Type safety
Every API method returns a Pydantic model — use .model_dump() to serialize, .model_validate() to parse. IDEs with type support (VS Code / PyCharm) provide full autocompletion on request parameters and response fields.
Versioning
This package is auto-published on every update to the OpenAPI spec. Version numbers are synchronized with the @smartytalent/* npm packages.
License
Licensed under the Apache License, Version 2.0.
Copyright © 2026 SmartyTalent (SmartyMeet sp. z o.o.)
1 maintainer
Metadata
1 maintainer
Release files for smartytalent-client 0.9.44
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| smartytalent_client-0.9.44.tar.gz | 833.0 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| smartytalent_client-0.9.44-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.8 MB
Release files / smartytalent_client-0.9.44.tar.gz
| Download URL | smartytalent_client-0.9.44.tar.gz |
|---|---|
| Size | 833.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3234de976de3178def7378db70222c88a10c77b859ea40d9e13ae4f7e021bfbb
|
|
BLAKE2b-256 checksum How to use checksums |
2775609b9732b2c441b69d9511886bb9727eb8f524a05f8b3b12a29786d2c48e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
Release files / smartytalent_client-0.9.44-py3-none-any.whl
| Download URL | smartytalent_client-0.9.44-py3-none-any.whl |
|---|---|
| Size | 2.0 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0337262260352238e7a28e72424641b2e5737332dc9b5368cbd2298438a52130
|
|
BLAKE2b-256 checksum How to use checksums |
84001557912a127aef91482cd10a28b3877958f5ae6855c56064bd9e90d22abe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
Security for smartytalent-client 0.9.44
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
