API

Klevian's unavailable partner API development surfaces.

Partner Evidence routes are live self-serve for Growth and Enterprise workspaces. ATS routes remain disabled while their trust boundaries are completed.

Unavailable development surface

Proposed packet, review, and audit read models remain internal development artifacts. Their routes return not found.

  • No evidence packet route
  • No human review route
  • No audit metadata route
  • No external evaluation writes

Required replacement boundary

Any future beta must enforce exact tenant and resource scope, finalized review integrity, fail-closed audit, and bounded partner responses.

  • Exact tenant scope
  • Exact job and rubric scope
  • Finalized formal review
  • Fail-closed access audit
  • Policy-safe response fields

Delivery and reliability

Partner Evidence routes are live self-serve for workspaces on an active Growth or Enterprise plan; admins provision scoped credentials from Settings. ATS, rubric submission, status, and legacy webhook implementations are hard-disabled; no deployment flag reactivates those.

  • No external scored-evaluation writes
  • No evaluation status workflow
  • No completion webhook
  • Idempotency key behavior is not a production contract
  • No production-readiness claim

What to confirm before rollout

Treat these objects as planning material only until Klevian announces a separately verified beta.

  • Do not send candidate data
  • Do not provision credentials
  • Do not plan ATS writes
  • Confirm future availability

Evidence packet retrieval and ledger verification

Self-serve: packet, review, audit metadata, signed-ledger verification, and interview-invitation routes are available to workspaces on an active Growth or Enterprise plan, with scoped credentials provisioned from Settings.

Rubric evaluation submission

Not available: the legacy external scored-evaluation writer is hard-disabled.

Evaluation status and webhooks

Not available: the legacy evaluation status and completion-webhook surface is hard-disabled.

ATS integrations

Not available: ATS routes and transport registration are disabled, and no provider is production-verified.

Partner evidence-packet object

This is the real evidence-packet shape returned by the partner API. Access is private-beta; confirm current entitlements with Klevian.

Evidence-packet response shape

// Proposed shape only; no endpoint is available.
// Transcript quotes are intentionally excluded.
type EvidencePacket = {
  evidencePacketId: string;
  schemaVersion: "klevian.platform_evidence_packet.v1";
  candidateRef: string;
  jobRef: string;
  status: string;
  roleContext: Record<string, unknown> | null;
  consentStatus: {
    status: string;
    consentVersion: string;
    policyVersion: string;
    jurisdiction: string;
  } | null;
  modelSummary: Record<string, unknown> | null;
  competencies: Array<{
    competencyName: string;
    score: number | null;
    evidenceStrength: string;
    evidenceCount: number;
  }>;
  evidence: Array<{
    evidenceId: string;
    competencyName: string;
    evidenceKind: string;
    evidenceClaim: string;
    evidenceStrength: string;
    reviewStatus: string;
  }>;
  risks: string[];
  missingEvidence: string[];
  recommendedFollowUps: string[];
  humanReviewRequired: boolean;
  reviewSummary: Record<string, unknown> | null;
  auditRefs: string[];
};

External rubric evaluation writes are unavailable

Evaluation submission, status, and webhook routes are hard-disabled. They are not part of a production or private-beta API.

This is not a published self-serve API contract. The separate embed/read experiment remains default-off and unverified.

  • Scoped partner credentials are exchanged server-side for short-lived browser sessions.
  • Embed configuration exposes sanitized review-only metadata.
  • External rubric evaluation writes and status routes are hard-disabled.
  • The embed/read experiment requires a separate default-off gate.
Implemented governed rubric evaluation routes
MethodImplemented pathPurpose
POST/api/rubrics/:id/embed-sessionsCreate a short-lived, rubric-scoped browser session for an approved embed.
GET/api/rubrics/:id/embed-configRetrieve sanitized review-only rubric metadata for an approved embed.

Conceptual embed markup using the shipped browser asset

<script src="https://klevian.com/embed/rubric.js" async></script>
<div
  data-klevian-rubric-embed
  data-rubric-id="rubric_approved_123"
  data-job-id="job_456"
  data-mode="review-only"
></div>
This static fallback is provided for search engines, accessibility tools, security scanners, procurement reviewers, and users when JavaScript is unavailable.