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.55
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.55.tar.gz | 875.5 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| smartytalent_client-0.9.55-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.0 MB
Release files / smartytalent_client-0.9.55.tar.gz
| Download URL | smartytalent_client-0.9.55.tar.gz |
|---|---|
| Size | 875.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cafe315fda64929eda35966ea5539e016295a161fa5f7810fdd3a8ba248e4dd5
|
|
BLAKE2b-256 checksum How to use checksums |
410c9858971eb5fe034fb13462394971553c048405348059d9f896d285f9774d
|
| 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.55-py3-none-any.whl
| Download URL | smartytalent_client-0.9.55-py3-none-any.whl |
|---|---|
| Size | 2.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d43dd5f8f4424d3cc3576280c3f7bfbe798adf84a4dd12071cf78ea5a436eab5
|
|
BLAKE2b-256 checksum How to use checksums |
72acd7ac2ee5df55f1e5d59031874fb5329bebaf33efd0648e9e881ec67f2500
|
| 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.55
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.
