Schema Reference

Table of Contents

• Query
  • developerCandidates
  • developerAssessments
  • developerReportStatus
  • developerCertificationCatalog
  • developerCertificationResult
  • developerCertificationBadges
• Mutation
  • developerCreateCertificationInvite
  • developerCreateCandidate
  • developerAssignCandidateToAssessment
• Objects
  • DeveloperAssessment
  • DeveloperAssessmentResult
  • DeveloperAssessmentSearchResult
  • DeveloperAssignmentResult
  • DeveloperCandidate
  • DeveloperCandidateSearchResult
  • DeveloperCertificationBadge
  • DeveloperCertificationBadgeLookupResult
  • DeveloperCertificationCatalogItem
  • DeveloperCertificationCatalogLevel
  • DeveloperCertificationInvite
  • DeveloperCertificationResult
  • DeveloperReportStatus
  • DeveloperScoreItem
  • DeveloperSkillScore
• Inputs
  • DeveloperAssignCandidateInput
  • DeveloperCertificationCandidateInput
  • DeveloperCreateCandidateInput
  • DeveloperCreateCertificationInviteInput
• Enums
  • DeveloperAssessmentSearchField
  • DeveloperCandidateSearchField
  • ProficiencyLevel
• Scalars
  • Boolean
  • Float
  • Int
  • String

Query

Field	Argument	Type	Description
developerCandidates		DeveloperCandidateSearchResult!	Search candidates for developer integrations
search		String
field		DeveloperCandidateSearchField
page		Int
limit		Int
developerAssessments		DeveloperAssessmentSearchResult!	Search assessments for developer integrations
search		String
field		DeveloperAssessmentSearchField
page		Int
limit		Int
developerReportStatus		[DeveloperReportStatus!]!	Get report/session status and URLs for a candidate or session
assessmentSessionId		String
candidateEmail		String
assessmentId		String
developerCertificationCatalog		[DeveloperCertificationCatalogItem!]!
search		String
developerCertificationResult		DeveloperCertificationResult
inviteId		String!
developerCertificationBadges		DeveloperCertificationBadgeLookupResult!
email		String!

Mutation

Field	Argument	Type	Description
developerCreateCertificationInvite		DeveloperCertificationInvite!
input		DeveloperCreateCertificationInviteInput!
developerCreateCandidate		DeveloperCandidate!	Create candidate for integrations
input		DeveloperCreateCandidateInput!
developerAssignCandidateToAssessment		DeveloperAssignmentResult!	Assign candidate to assessment and optionally send email
input		DeveloperAssignCandidateInput!

Objects

DeveloperAssessment

Field	Argument	Type	Description
id		String!
jobTitle		String!
companyName		String
status		String!
totalDurationMinutes		Int!

DeveloperAssessmentResult

Assessment result fields, populated once reportStatus is READY. Shared shape between DeveloperReportStatus.result and the assessment.completed webhook payload's result field.

Field	Argument	Type	Description
assessmentSessionId		String!
overallScore		Float!
skillWiseScores		[DeveloperSkillScore!]!
communicationScores		[DeveloperScoreItem!]!

DeveloperAssessmentSearchResult

Field	Argument	Type	Description
data		[DeveloperAssessment!]!
total		Int!
page		Int!
limit		Int!

DeveloperAssignmentResult

Field	Argument	Type	Description
assessmentSessionId		String!
interviewUrl		String!
token		String!
tokenExpiresAt		String!
emailSent		Boolean!

DeveloperCandidate

Field	Argument	Type	Description
handle		String!
id		String!
name		String!
email		String!
phone		String
resumeUrl		String
createdAt		String!

DeveloperCandidateSearchResult

Field	Argument	Type	Description
data		[DeveloperCandidate!]!
total		Int!
page		Int!
limit		Int!

DeveloperCertificationBadge

Field	Argument	Type	Description
skillName		String!
level		ProficiencyLevel!
conceptsTested		[String!]!

DeveloperCertificationBadgeLookupResult

Field	Argument	Type	Description
validCandidate		Boolean!
message		String
badges		[DeveloperCertificationBadge!]!

DeveloperCertificationCatalogItem

Field	Argument	Type	Description
skillName		String!
levels		[DeveloperCertificationCatalogLevel!]!

DeveloperCertificationCatalogLevel

Field	Argument	Type	Description
quizId		String!
level		ProficiencyLevel!
durationMinutes		Int!
enabledLanguages		[String!]!
conceptsTested		[String!]!

DeveloperCertificationInvite

Field	Argument	Type	Description
inviteId		String!
status		String!
challengeUrl		String!
expiresAt		String!
emailSent		Boolean!

DeveloperCertificationResult

Field	Argument	Type	Description
inviteId		String!
status		String!
skillName		String!
level		ProficiencyLevel!
completedAt		String
resultBand		String
score		Int
proctoringStatus		String!
resultReleaseStatus		String!
certificateUrl		String
verificationStatus		String
feedbackAreas		[String!]
reportUrl		String
skillWiseScores		[DeveloperSkillScore!]
communicationScores		[DeveloperScoreItem!]
badgeImageUrl		String	URL of the badge image for the achieved level. Null unless the candidate achieved a certification (EXCELLENT/GOOD band).

DeveloperReportStatus

Field	Argument	Type	Description
assessmentSessionId		String!
status		String!
candidateId		String!
candidateName		String!
candidateEmail		String!
assessmentId		String
assessmentTitle		String
reportId		String
reportStatus		String!	READY, PROCESSING, NOT_READY, or FAILED (report generation failed).
dashboardReportUrl		String
interviewUrl		String!
result		DeveloperAssessmentResult	Populated when reportStatus is READY.

DeveloperScoreItem

A single score/label pair used across skill, concept, and communication breakdowns. Only the score value and label are exposed - not the underlying analysis text.

Field	Argument	Type	Description
label		String!
score		Float!

DeveloperSkillScore

A per-skill score with its nested concept-level breakdown.

Field	Argument	Type	Description
label		String!
score		Float!
concepts		[DeveloperScoreItem!]!

Inputs

DeveloperAssignCandidateInput

Field		Type	Description
candidateId		String!
assessmentId		String!
sendEmail		Boolean
expiryDays		Int
callbackUrl		String	Optional webhook URL called when the assessment report is ready (or fails). Requires API-key authentication - rejected for org-admin session callers, since the webhook signing secret is tied to the API key.
externalReference		String	Opaque value echoed back in the assessment.completed/assessment.failed webhook payload for correlating with your own records.

DeveloperCertificationCandidateInput

Field		Type	Description
name		String!
email		String!

DeveloperCreateCandidateInput

Field		Type	Description
name		String!
email		String!
phone		String
resumeUrl		String
resumeText		String

DeveloperCreateCertificationInviteInput

Field		Type	Description
quizId		String!
candidate		DeveloperCertificationCandidateInput!
sendInviteEmail		Boolean
externalReference		String
callbackUrl		String

Enums

DeveloperAssessmentSearchField

Field selector for developer assessment search

Value	Description
ANY
JOB_TITLE
COMPANY_NAME

DeveloperCandidateSearchField

Field selector for developer candidate search

Value	Description
ANY
NAME
EMAIL

ProficiencyLevel

Proficiency level for an assessment skill

Value	Description
Beginner
Intermediate
Advanced
Expert

Scalars

Boolean

The Boolean scalar type represents true or false.

Float

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.

Int

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

String

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.