Kand Kandio

Name: Kandio API
Brand: Kandio
Availability: InStock

★ Only Publicly Available OpenAPI DocumentHR recruitingRecruiting Atsoauth218 EndpointsREST

For Agents

Create skill-test assessments, invite candidates, retrieve scored results, and manage webhook subscriptions inside a Kandio organisation. 18 endpoints covering the full assessment lifecycle.

Install Jentic One Beta

Connect the Kandio to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Kandio, 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 | sh

Step 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 instance

Jentic 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.

Capabilities

What an agent can do with Kandio API.

Create a candidate assessment for a specific test inside an organisation via POST /{organization}/tests/{test}/assessments

List and retrieve assessment results, including overall score and per-question breakdown, via /{organization}/assessments and /{organization}/assessments/{assessment}

Browse the Kandio catalogue of skill areas and tests through /skillareas and /{organization}/tests

GET STARTED

Start building with Kandio API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Kandio API for, with concrete tasks.

★ ATS Assessment Integration

Embed Kandio skills tests into an applicant tracking system so recruiters can trigger an assessment from a candidate record and pull results back into the hiring pipeline. The integration creates an assessment via the organisation-scoped endpoint, captures the candidate URL returned, and listens for webhook events when results are ready. End-to-end wiring takes roughly two days against a vendor-curated test catalogue covering hundreds of technical and language skills.

Create an assessment for test ID `python-mid` inside organisation `acme` via POST /{organization}/tests/{test}/assessments and return the candidate invitation URL.

Bulk Candidate Screening

Send standardised skills assessments to every applicant for a role and rank them by score before the human screen. The API exposes test metadata (skill area, duration, difficulty) so recruiters can pick a calibrated test, batch-create assessments, and pull a sortable result list. Saves hours per role on phone screens and removes subjective gatekeeping at the top of the funnel.

Create assessments for a list of 25 candidate emails on test `frontend-react`, then list completed assessments via GET /{organization}/assessments sorted by score.

Webhook-Driven Result Pipeline

Receive real-time notifications when a candidate completes a Kandio test and trigger downstream automation (Slack alert, ATS stage advance, calendar invite for a follow-up interview). Webhook subscriptions are managed through the API so an HR platform can register a single endpoint per organisation and receive structured event payloads without polling.

Register a webhook subscription via POST /webhooks pointing at https://hooks.example.com/kandio for the assessment-completed event.

Agent-Driven Recruiting Workflows

AI recruiting agents discover Kandio through Jentic, pick the right skill test from the catalogue, send the invite, and surface results inside a chat or email thread without the recruiter touching the Kandio UI. Jentic handles the OAuth2 flow and scopes credentials per organisation so the agent can act on behalf of a single tenant safely.

Use the Jentic search 'send a skills assessment to a candidate', load the schema, and invite candidate@example.com to the Python intermediate test inside organisation `acme`.

Key Endpoints

18 endpoints — jentic publishes the only available openapi specification for kandio, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/{organization}/tests/{test}/assessments

Create an assessment for a candidate on a given test

GET

/{organization}/assessments

List assessments inside an organisation

GET

/{organization}/assessments/{assessment}

Retrieve a single assessment with score and details

GET

/{organization}/tests

List tests available to the organisation

GET

/skillareas

List all skill areas in the Kandio catalogue

GET

/{organization}/skillareas

List skill areas configured for the organisation

POST

/{organization}/tests/{test}/assessments

Create an assessment for a candidate on a given test

GET

/{organization}/assessments

List assessments inside an organisation

GET

/{organization}/assessments/{assessment}

Retrieve a single assessment with score and details

GET

/{organization}/tests

List tests available to the organisation

GET

/skillareas

List all skill areas in the Kandio catalogue

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Kandio OAuth2 access tokens are stored encrypted in the Jentic vault. Agents receive scoped execution tokens so the raw bearer token and refresh token never enter the agent's prompt or response context.

Intent-based discovery

Agents search by intent (for example, 'send a skills test to a candidate') and Jentic returns the matching Kandio operation with its path and body schema, so the agent does not need to read Kandio's docs to construct the request.

Time to first call

Direct Kandio integration: 2-3 days for OAuth setup, organisation scoping, webhook registration, and result polling. Through Jentic: under an hour — search, load schema, execute.

FAQs

Specific to using Kandio API through Jentic.

Why is there no official OpenAPI spec for Kandio?

Kandio does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Kandio 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 Kandio API use?

The API uses OAuth2 (passport scheme) with bearer tokens issued per organisation. Each request must include `Authorization: Bearer {token}` and the organisation slug in the path. Through Jentic, OAuth tokens are stored encrypted in the vault and injected at execution time so the agent never handles raw tokens.

Can I create a skills assessment for a candidate via the Kandio API?

Yes. POST /{organization}/tests/{test}/assessments creates an assessment tied to a specific test inside an organisation. The response includes the candidate invitation URL that you forward to the applicant. The same assessment ID is later used with GET /{organization}/assessments/{assessment} to fetch the scored result.

What are the rate limits for the Kandio API?

Kandio does not publish hard rate limits in the spec; in practice the platform expects integration-level traffic from ATS and job-site partners. If you exceed the platform's burst tolerance the API responds with HTTP 429. Contact info@kand.io to negotiate higher throughput for high-volume screening.

How do I subscribe to assessment completion events through Jentic?

Run `pip install jentic` and search Jentic for 'subscribe to Kandio assessment events'. Jentic returns the schema for the /webhooks endpoint; supply your callback URL and the event types you care about, and execute the call to register the subscription.

Can I list every test available to my Kandio organisation?

Yes. GET /{organization}/tests returns the tests configured for the organisation, including each test's skill area, duration, and difficulty. Use GET /skillareas first to discover the catalogue of skill areas before filtering tests.

Is the Kandio API free?

No — Kandio is a paid skills-testing marketplace and API access is bundled with platform subscriptions. The free Jentic tier covers the integration plumbing, but the underlying assessments are billed by Kandio per test or per seat.