4.0.0 is a breaking release: the
EmploymentType, ExperienceLevel, and CompensationPeriod value sets changed, and the retired Auto Apply sub-client is gone. Pin an exact version (see Versioning) and read Upgrading to 4.0.0 before you upgrade from 3.x, or from 1.x on Node.What the 4.0.0 clients do not cover
Send these over plain HTTPS:Upgrading to 4.0.0
What the changes mean:
- The index matches both employment-type spellings, so the new values change what goes over the wire, not what you get back.
freelanceandinternexist in the data; the old enums could not express them.- The old Auto Apply sub-client’s
create_profile/start_session/set_answerscalled routes that no longer exist, so nothing on it worked. The live contract is profileless and synchronous.
Python
geocode are positional. Date arguments take datetime objects, not strings.
JoboClient(api_key, *, base_url="https://connect.jobo.world", timeout=30.0, feed_timeout=120.0, httpx_client=None) takes timeouts in seconds. A passed httpx_client is used as is: the client ignores api_key, base_url, and timeout, so set the base URL and the X-Api-Key header on it yourself.
For async code,
AsyncJoboClient takes the same arguments and method names. Open it with async with, await its methods, and use async for on the iter_* methods:
Auto-pagination
Theiter_* methods fetch pages and follow cursors for you.
Incremental sync
Passupdated_after to pick up changes after a backfill. Feed scans page by immutable creation time by default (stable_scan), so records can’t shift across page boundaries mid-read.
Errors
The client retries429 and 503 up to 3 times. It honors Retry-After, otherwise backs off exponentially, and caps each wait at 30 seconds. Every other error response, 500 included, raises an exception derived from JoboError:
code when the API supplies one, plus status_code, detail, api_version, and the raw response_body. JoboRateLimitError also carries retry_after. To retry a 500, catch JoboServerError and apply the retry strategy.
Node.js and TypeScript
fetch, so it needs Node 18+ and also runs in Bun and Deno. Use it server-side only: never ship your API key to a browser. Options are camelCase and accept a Date or an ISO 8601 string for dates; wire fields on response objects stay snake_case.
new JoboClient({ apiKey, baseUrl?, timeout?, feedTimeout?, fetch? }) takes timeouts in milliseconds (defaults 30000 and 120000).
The iterators are async generators:
429 and 503 are retried, and every other error response throws the JoboError subclass of the same name (JoboRateLimitError carries retryAfter). Error properties are camelCase: statusCode, responseBody, apiVersion.
.NET
JoboClient is IDisposable. JoboClientOptions also takes BaseUrl, Timeout (default 30 seconds), and FeedTimeout (default 120 seconds). To register a singleton with dependency injection, add using Jobo.Enterprise.Client.Extensions; and call services.AddJoboClient(o => o.ApiKey = ...).
Feed enumeration returns
IAsyncEnumerable<Job>:
HttpClient instead of JoboClientOptions, the client applies no settings to it. Set BaseAddress (https://connect.jobo.world), the X-Api-Key default header, and, if you use the feed endpoints, a Timeout of at least 120 seconds.
Exceptions live in Jobo.Enterprise.Client.Exceptions and use the Exception suffix: JoboException, JoboRateLimitException (with RetryAfterSeconds), and so on. Each carries Code, StatusCode, Detail, ResponseBody, and ApiVersion.
Auto Apply (TypeScript)
@jobo-ai/autoapply covers the whole Auto Apply API, applications and mailboxes, and drives the synchronous application loop for you. It has no runtime dependencies and runs on Node 20+, Bun, Deno, and edge runtimes. Request and response properties are snake_case, as on the wire; option objects (idempotencyKey, waitSeconds, onStep) are camelCase.
Auto Apply is coming soon. Build against the sandbox today with a sandbox key (jbe_test_…); live applications open once Jobo approves your business.
createClient({ apiKey, baseUrl?, fetch?, maxRetries?, timeoutMs? }) returns { applications, mailboxes }. Version 2 targets API contract 2026-08-31. Its field types require only the stable base properties; options, constraints, format, sensitivity, and repeating-group metadata are optional, as they are on the wire.
run() creates the application, calls onStep for each step that needs answers (correction rounds included), reconnects after 202 responses, and resolves with the terminal application. Return { cancel: true } from onStep to cancel instead.
jobo.applicationsalso exposescreate,submitAnswers,get,cancel, andlist.listauto-paginates withfor await.jobo.mailboxescovers mailboxes:create,get,list,delete,check, andretrieveVerification.- The required
Idempotency-Keyis sent for you. Pass a persistedidempotencyKeyto recover a create across process restarts. - Validation failures throw
JoboValidationErrorwith per-field errors. Other API errors throwJoboAPIError, carrying the problemcodeandretryAfterSeconds. - Network errors,
429,502, and503are retried (maxRetries, default 2), andcreatealso retries409 idempotency_key_in_flight.
Without a client library
Every endpoint is plain HTTPS with a singleX-Api-Key header, so the curl examples in these docs translate to any language:

