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
Release files for smartytalent-client 0.8.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 | |
|---|---|---|---|
| smartytalent_client-0.8.0.tar.gz | 640.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| smartytalent_client-0.8.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.2 MB
Release files / smartytalent_client-0.8.0.tar.gz
| Download URL | smartytalent_client-0.8.0.tar.gz |
|---|---|
| Size | 640.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a302ae87a3bd82c447ebd4e27f030911c25d2a0b74c1407bb0a59c9766cda321
|
|
BLAKE2b-256 checksum How to use checksums |
8b42ea895ead307ae052ee896fe1369ac4a7aadabedb6b6abe3aef02cda1fc23
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
Release files / smartytalent_client-0.8.0-py3-none-any.whl
| Download URL | smartytalent_client-0.8.0-py3-none-any.whl |
|---|---|
| Size | 1.6 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
459249f0db735859441783f0525d7618f7e91a42547eab190c59b2e89bcd85b2
|
|
BLAKE2b-256 checksum How to use checksums |
4b22449dffd906cf49a3142e40e29917b7f3fb4d1b150337668a88c0abb6e4f6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
