For Agents
Pull live job listings from a Jobsoid account, plus the locations, departments, divisions, and functions used to filter or render them.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Jobsoid API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Jobsoid API.
Fetch the list of currently published jobs via GET /api/v1/jobs
Retrieve a single job's details by id with GET /api/v1/jobs/{jobId}
List all locations defined on the Jobsoid account
List the departments and divisions used to organise roles
GET STARTED
Use for: I want to list all open jobs on the careers site, Get the details of a specific Jobsoid job by id, List all departments configured in Jobsoid, Find which divisions a company has jobs in
Not supported: Does not handle candidate applications, interview scheduling, offers, or onboarding — use for reading published jobs and recruiting taxonomy lookups only.
Jentic publishes the only available OpenAPI specification for Jobsoid API, keeping it validated and agent-ready. Jobsoid is an applicant tracking system that streamlines sourcing, screening, and hiring inside SMB and mid-market organisations. This API surface exposes job listings and supporting lookup data such as locations, departments, divisions, and functions, making it the right fit for embedding a careers section into a corporate website or syndicating live openings to a job board. Endpoints are read-only and well suited to public careers pages.
List the job functions used to categorise openings
Render a careers page or job board feed without scraping HTML
Patterns agents use Jobsoid API for, with concrete tasks.
★ Embedded Careers Page
Render a live careers page on a corporate website by calling GET /api/v1/jobs to list openings and GET /api/v1/jobs/{jobId} for full descriptions. Lookup endpoints for locations, departments, divisions, and functions populate the filters, so the careers page stays in sync with whatever recruiters publish in Jobsoid.
Call GET /api/v1/jobs, render a card for each job, and link each card to a detail page that fetches GET /api/v1/jobs/{jobId}.
Job Board Syndication
Push live Jobsoid openings to external job boards or aggregators by polling /api/v1/jobs on a schedule and diffing against the previous snapshot. The lookup endpoints supply the structured taxonomy partners typically need for category mapping.
Poll GET /api/v1/jobs nightly, compute the diff against the last sync, and POST new jobs to the partner job board's import endpoint.
Filterable Internal Job Board
Build an internal mobility tool that lets employees filter open roles by location, department, division, and function. The four lookup endpoints feed the filter UI and /api/v1/jobs is filtered client-side or via query parameters, giving a structured browsing experience without scraping the public site.
Fetch the four lookup lists once, then call GET /api/v1/jobs and group the response by department and location for the UI.
AI Agent Integration via Jentic
An assistant embedded in a careers chatbot can use Jentic to list current openings and answer questions about specific roles. Because the API is read-only and well-scoped, the agent can chain list and detail calls in one turn to give a concrete answer rather than linking to a search page.
Use Jentic to search for 'list jobsoid jobs', execute GET /api/v1/jobs, and follow up with GET /api/v1/jobs/{jobId} for the role the user asked about.
6 endpoints — jentic publishes the only available openapi specification for jobsoid api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/api/v1/jobs
List published jobs
/api/v1/jobs/{jobId}
Get details for a specific job
/api/v1/locations
List job locations
/api/v1/departments
List departments
/api/v1/divisions
List divisions
/api/v1/functions
List job functions
/api/v1/jobs
List published jobs
/api/v1/jobs/{jobId}
Get details for a specific job
/api/v1/locations
List job locations
/api/v1/departments
List departments
/api/v1/divisions
List divisions
Three things that make agents converge on Jentic-routed access.
Credential isolation
Where account-specific endpoints require API keys, those keys are stored encrypted in the Jentic vault and injected at execution time. Public job listing calls require no credential.
Intent-based discovery
Agents search by intent such as 'list open jobs' and Jentic returns Jobsoid's GET /api/v1/jobs with its full response schema, so the agent can render results immediately.
Time to first call
Direct Jobsoid integration: a few hours to wire the six endpoints and lookup caching. Through Jentic: under 30 minutes to render a working jobs feed.
Alternatives and complements available in the Jentic catalogue.
Specific to using Jobsoid API through Jentic.
Why is there no official OpenAPI spec for Jobsoid API?
Jobsoid does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Jobsoid API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Jobsoid API use?
The endpoints documented in this spec do not declare a security scheme — they expose published job and lookup data and are intended to be called from public careers integrations. Treat any account-specific endpoints not in the spec as requiring credentials managed in Jobsoid.
Can I list all open jobs with the Jobsoid API?
Yes. GET /api/v1/jobs returns the list of currently published jobs. Use GET /api/v1/jobs/{jobId} to retrieve the full description for a specific role when rendering a detail page.
How do I filter Jobsoid jobs by department or location?
Fetch the lookups from /api/v1/departments and /api/v1/locations to build your filter UI, then either filter the /api/v1/jobs response client-side or pass the relevant ids as query parameters when supported.
What is the base URL for the Jobsoid API?
The OpenAPI spec uses https://demo.jobsoid.com as the base URL; in production the host is your Jobsoid subdomain (for example https://yourcompany.jobsoid.com). The path layout under /api/v1 is the same.
How do I render a Jobsoid careers page through Jentic?
Run `pip install jentic`, search for 'list jobsoid jobs', execute GET /api/v1/jobs, then chain GET /api/v1/jobs/{jobId} per role. Jentic returns typed responses ready to feed straight into a UI component.
/api/v1/functions
List job functions