This release is a pre-release and may not be stable for production use.
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.4.1.dev1
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.4.1.dev1.tar.gz | 598.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| smartytalent_client-0.4.1.dev1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.1 MB
Release files / smartytalent_client-0.4.1.dev1.tar.gz
| Download URL | smartytalent_client-0.4.1.dev1.tar.gz |
|---|---|
| Size | 598.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
111fc46019e182c1d9d720d756d1064589e5c1c2cffe79efefd8ed4708e18cd9
|
|
BLAKE2b-256 checksum How to use checksums |
fa3bc0ea3c17cd38517d788f7932e532ea0c45ee09e1f5fffc2a239b2ad4bc0e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.13
|
Release files / smartytalent_client-0.4.1.dev1-py3-none-any.whl
| Download URL | smartytalent_client-0.4.1.dev1-py3-none-any.whl |
|---|---|
| Size | 1.5 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7bc2c0e74bba5acda30b738a532db5edc1967e2472b9f5788f94df4d3dfffe64
|
|
BLAKE2b-256 checksum How to use checksums |
042f118d1a35b215431495c29ef12eadfad3085ebb81b95f3f5fc72ac3349269
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.13
|
