Integration API (A2A)
Integration API (A2A)
One interview-lifecycle service, exposed as JSON-RPC 2.0 (A2A) and REST — pick whichever fits your stack.
The Integration API is Teamcast's agent-to-agent surface: it lets a partner system (an ATS, an HRIS, or an AI recruiting agent) create and drive an interview run without touching the recruiter dashboard. Both surfaces below call the identical underlying service — a run created via one can be read, approved, or cancelled via the other.
| Surface | Endpoint | Best for |
|---|---|---|
| JSON-RPC (A2A) | POST /a2a/task | Agent frameworks and tooling that already speak JSON-RPC 2.0 (alias: POST /a2a) |
| REST (Integration API) | /integration/* | Conventional HTTP clients, webhooks-first pipelines |
Lifecycle at a glance
- Create — submit role + candidate. Missing required fields short-circuit into
INFO_NEEDEDinstead of failing outright. - Plan gate — Teamcast generates an interview plan; a human (or an auto-approve policy) approves, rejects, or requests a revision.
- Interview — the candidate is invited and completes the live, adaptive interview with Maya.
- Assessment gate — Teamcast generates a coverage-only assessment; a human approves or rejects before it's delivered.
- Delivery — the run reaches
ASSESSMENT_READY/COMPLETEDand a signed webhook (or a status poll) hands you the coverage summary.
JSON-RPC
A2A method reference: interview.create, .status, .approve, and more.
REST
The /integration/* REST endpoint reference.
HITL Workflow
The plan and assessment approval gates in detail.
Webhooks
Event catalog, signing, retries, and verification.
Privacy & Data
PII minimization, GDPR purge, and the coverage-only guarantee.
coverage_summary only. No score, no hire/no-hire recommendation, no emotion inference ever crosses the wire.