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.

Release files for smartytalent-client 0.3.1.dev1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for smartytalent-client 0.3.1.dev1
File	Size	Uploaded
smartytalent_client-0.3.1.dev1.tar.gz	591.8 kB	Jul 12, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for smartytalent-client 0.3.1.dev1
File	Interpreter	ABI	Platform	Reset
smartytalent_client-0.3.1.dev1-py3-none-any.whl 1.5 MB Jul 12, 2026	Python 3	none	any	Details

Total release size: 2.0 MB

Release files / smartytalent_client-0.3.1.dev1.tar.gz

Download URL	smartytalent_client-0.3.1.dev1.tar.gz
Size	591.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`8aec4ab3f09a22ea489030321783b4390bf27af64988b2e16796c8f9b433d36f`
BLAKE2b-256 checksum How to use checksums	`5f806eb8d9d5219ab19470369beb31005c489f02176255174529a0dbfa88e137`
Upload date	Jul 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.13`

Release files / smartytalent_client-0.3.1.dev1-py3-none-any.whl

Download URL	smartytalent_client-0.3.1.dev1-py3-none-any.whl
Size	1.5 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`45a322b539a61e36411d19ce2a2a2ddc7c97098382b8ddc4a7cb2bbac29db6d0`
BLAKE2b-256 checksum How to use checksums	`e8ef0ef937584ff0cbdb6e80078a4eb4bbfd7c4d0d99b6fbd4047d827095a7a6`
Upload date	Jul 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.13`