The HackerRank Work connector lets your AI agent act in each user's HackerRank Work account. Each user connects their own HackerRank Work access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 36 tools.
- Tools
- 36
- What they doRead · write · destructive
- 25 · 9 · 225 read9 write2 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the HackerRank Work connection
In AgentKit > Connections, create a HackerRank Work connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'hackerrankwork'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize HackerRank Work:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'hackerrankwork_list_audit_logs',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "hackerrankwork"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize HackerRank Work:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="hackerrankwork_list_audit_logs",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their HackerRank Work credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolhackerrankwork_get_candidate_report_pdfGet the PDF score report for a test candidate as a download URL.Read-onlyGet Candidate Report PDF
Get the PDF score report for a test candidate as a download URL. Returns the location of the candidate's PDF report (requested with format=url). HackerRank answers 503 while the PDF is still being generated; retry after a short wait. Use hackerrankwork_get_candidate_report_pdf once a candidate has finished; use hackerrankwork_get_test_candidate for scores as data.
Inputs
candidate_idstringrequired- ID of the candidate whose report to fetch.
test_idstringrequired- ID of the test the candidate attempted.
hackerrankwork_get_interviewRetrieve one live coding interview by id.Read-onlyGet Interview
Retrieve one live coding interview by id. Returns the interview's id, title, status, scheduled and actual times, url, owner, interviewers, candidate, notes, feedback, thumbs_up, report_url, metadata and template id. Use hackerrankwork_get_interview for one interview; use hackerrankwork_get_interview_transcript for its transcript.
Inputs
interview_idstringrequired- ID of the interview, as returned by hackerrankwork_list_interviews.
hackerrankwork_get_interview_templateRetrieve one interview template by id.Read-onlyGet Interview Template
Retrieve one interview template by id. Returns the template's id, name, status, owner, roles, questions, scorecard, sharing and editor access. Use hackerrankwork_get_interview_template for one template; use hackerrankwork_list_interview_templates to browse.
Inputs
template_idintegerrequired- ID of the interview template, as returned by hackerrankwork_list_interview_templates.
hackerrankwork_get_interview_transcriptRetrieve the transcript of a live coding interview.Read-onlyGet Interview Transcript
Retrieve the transcript of a live coding interview. Returns a messages list with the recorded conversation. Use hackerrankwork_get_interview_transcript after the interview has run; use hackerrankwork_get_interview for its metadata and feedback.
Inputs
interview_idstringrequired- ID of the interview whose transcript to fetch.
hackerrankwork_get_invite_templateRetrieve one candidate invitation email template by id.Read-onlyGet Invite Template
Retrieve one candidate invitation email template by id. Returns the template's id, name, subject, content, default flag, timestamps and owner. Use hackerrankwork_get_invite_template to view a template; use hackerrankwork_list_invite_templates to find ids.
Inputs
template_idstringrequired- ID of the invite template, as returned by hackerrankwork_list_invite_templates.
hackerrankwork_get_questionRetrieve one question from the question bank by id.Read-onlyGet Question
Retrieve one question from the question bank by id. Returns the question's id, unique_id, type, name, owner, status, languages, problem statement, recommended duration, tags, max_score, options and answer. Use hackerrankwork_get_question for the full content of one question; use hackerrankwork_list_questions to find ids.
Inputs
question_idstringrequired- ID of the question, as returned by hackerrankwork_list_questions.
hackerrankwork_get_teamRetrieve one team by id.Read-onlyGet Team
Retrieve one team by id. Returns the team's id, name, owner, created_at, recruiter and developer counts and caps, invite_as, locations and departments. Use hackerrankwork_get_team for one team; use hackerrankwork_list_teams to find ids.
Inputs
team_idstringrequired- ID of the team, as returned by hackerrankwork_list_teams.
hackerrankwork_get_team_membershipCheck whether a user belongs to a team and retrieve the membership.Read-onlyGet Team Membership
Check whether a user belongs to a team and retrieve the membership. Returns the membership record with the team and the user. Use hackerrankwork_get_team_membership to confirm one user's membership; use hackerrankwork_list_team_members for the whole roster.
Inputs
team_idstringrequired- ID of the team.
user_idstringrequired- ID of the user.
hackerrankwork_get_testRetrieve one assessment test by id, optionally with extra detail fields.Read-onlyGet Test
Retrieve one assessment test by id, optionally with extra detail fields. Returns the test's id, name, duration, start and end times, owner, state, languages, tags, questions, sections, scoring settings, login URLs and any requested additional fields. Use hackerrankwork_get_test after hackerrankwork_list_tests when you need the full settings of a single test.
Inputs
test_idstringrequired- ID of the test to retrieve, as returned by hackerrankwork_list_tests.
additional_fieldsstring- Comma-separated extra test fields to include in the response, for example languages,candidate_details,cutoff_score,test_admins. Leave empty for the default fields.
hackerrankwork_get_test_candidateRetrieve one candidate's record for a test, including scores and report links.Read-onlyGet Test Candidate
Retrieve one candidate's record for a test, including scores and report links. Returns the candidate's id, name, email, score, status, attempt times, integrity status, invite details, tags, report URLs and any requested additional fields. Use hackerrankwork_get_test_candidate for the detail of one candidate; use hackerrankwork_list_test_candidates to browse.
Inputs
candidate_idstringrequired- ID of the test candidate, as returned by hackerrankwork_list_test_candidates or hackerrankwork_invite_candidate.
test_idstringrequired- ID of the test the candidate was invited to.
additional_fieldsstring- Comma-separated extra fields to include, for example questions,scores_sections_split. Leave empty for the default fields.
hackerrankwork_get_userRetrieve one user by id.Read-onlyGet User
Retrieve one user by id. Returns the user's id, email, name, country, role, status, phone, timezone, permissions, admin flags, teams and last activity time. Use hackerrankwork_get_user for one user; use hackerrankwork_list_users or hackerrankwork_search_users to find ids.
Inputs
user_idstringrequired- ID of the user, as returned by hackerrankwork_list_users.
hackerrankwork_list_audit_logsList audit log entries describing recruiter activity in your account, optionally for one user.Read-onlyList Audit Logs
List audit log entries describing recruiter activity in your account, optionally for one user. Returns each entry's source id and type, user, action, modified fields and values, ip address and created_at, plus pagination links. Use hackerrankwork_list_audit_logs to review who changed what.
Inputs
limitinteger- Number of records to return per page. Maximum 100.default
10 offsetinteger- Number of records to skip before the first result, used for pagination. Follow the next link in the response for the following page.default
0 user_idstring- Return only entries for this user id.
hackerrankwork_list_interview_templatesList the interview templates you can access, optionally only the ones you own or ones shared with you.Read-onlyList Interview Templates
List the interview templates you can access, optionally only the ones you own or ones shared with you. Returns each template's id, name, status, owner, roles, questions, scorecard and sharing details, plus pagination links. Use hackerrankwork_list_interview_templates to browse; use hackerrankwork_get_interview_template for one template.
Inputs
filterstring- Filter by ownership: owned for templates you created, shared for templates shared with you.one of
ownedshared limitinteger- Number of records to return per page. Maximum 100.default
10 offsetinteger- Number of records to skip before the first result, used for pagination. Follow the next link in the response for the following page.default
0
hackerrankwork_list_interviewsList live coding interviews, optionally filtered by dates, owner, interviewers, access or status.Read-onlyList Interviews
List live coding interviews, optionally filtered by dates, owner, interviewers, access or status. Returns each interview's id, title, status, scheduled times, url, owner, interviewers, candidate, feedback, report_url and template id, plus pagination links. Use hackerrankwork_list_interviews to browse; use hackerrankwork_get_interview for one interview in full.
Inputs
accessstring- Filter by access rights: owned or shared.one of
ownedshared created_atstring- Range of creation datetimes in the form from..to, for example 2024-01-21T13:36:21+0000..2024-01-22T00:00:00+0000.
current_statusstring- Filter by current status code: 0 New, 1 Active, 2 Ended, 3 Paused.one of
0123 ended_atstring- Range of end datetimes in the form from..to, for example 2024-01-21T13:36:21+0000..2024-01-22T00:00:00+0000.
interviewersstring- Return only interviews that include this interviewer's user id.
limitinteger- Number of records to return per page. Maximum 100.default
10 offsetinteger- Number of records to skip before the first result, used for pagination. Follow the next link in the response for the following page.default
0 order_bystring- Sort field: title, id, created_at, ended_at, current_status or user.one of
titleidcreated_atended_atcurrent_statususer order_dirstring- Sort direction, asc or desc. Required whenever order_by is used.one of
ascdesc updated_atstring- Range of update datetimes in the form from..to, for example 2024-01-21T13:36:21+0000..2024-01-22T00:00:00+0000.
userstring- Return only interviews created by this user id.
hackerrankwork_list_invite_templatesList the candidate invitation email templates you can use, optionally only owned or shared ones.Read-onlyList Invite Templates
List the candidate invitation email templates you can use, optionally only owned or shared ones. Returns each template's id, name, subject, content, default flag, timestamps and owner, plus pagination links. Use hackerrankwork_list_invite_templates to find a template id for hackerrankwork_invite_candidate; use hackerrankwork_get_invite_template for one template.
Inputs
accessstring- Filter by access type: shared or owned.one of
sharedowned limitinteger- Number of records to return per page. Maximum 100.default
10 offsetinteger- Number of records to skip before the first result, used for pagination. Follow the next link in the response for the following page.default
0
hackerrankwork_list_questionsList questions in the question bank, optionally filtered by status, access, difficulty, type, owner, tags, skills or languages.Read-onlyList Questions
List questions in the question bank, optionally filtered by status, access, difficulty, type, owner, tags, skills or languages. Returns each question's id, unique_id, type, name, owner, status, languages, difficulty-related fields, tags, max_score and recommended duration, plus pagination links. Use hackerrankwork_list_questions to find question ids for tests and interview templates; use hackerrankwork_get_question for one question in full.
Inputs
accessstring- Comma-separated access types: library, owned, shared.
difficultystring- Comma-separated difficulty levels to include.
languagesstring- Comma-separated languages the question allows.
limitinteger- Number of records to return per page. Maximum 100.default
10 offsetinteger- Number of records to skip before the first result, used for pagination. Follow the next link in the response for the following page.default
0 ownerstring- Comma-separated user ids of question owners.
skillsstring- Comma-separated skills to match.
statusstring- Question status: active or archived.one of
activearchived tagsstring- Comma-separated tags to match.
typestring- Comma-separated question types to include, for example code,mcq.
hackerrankwork_list_team_membersList the users who belong to a team.Read-onlyList Team Members
List the users who belong to a team. Returns membership records, each with the team and the user, plus pagination links. Use hackerrankwork_list_team_members to see a team's roster; use hackerrankwork_get_team_membership to check one user.
Inputs
team_idstringrequired- ID of the team whose members to list.
limitinteger- Number of records to return per page. Maximum 100.default
10 offsetinteger- Number of records to skip before the first result, used for pagination. Follow the next link in the response for the following page.default
0
hackerrankwork_list_teamsList the teams in your HackerRank for Work company account.Read-onlyList Teams
List the teams in your HackerRank for Work company account. Returns each team's id, name, owner, created_at, recruiter and developer counts and caps, invite_as, locations and departments, plus pagination links. Use hackerrankwork_list_teams to browse; use hackerrankwork_get_team for one team and hackerrankwork_list_team_members for its members.
Inputs
limitinteger- Number of records to return per page. Maximum 100.default
10 offsetinteger- Number of records to skip before the first result, used for pagination. Follow the next link in the response for the following page.default
0
hackerrankwork_list_test_candidatesList the candidates invited to a test.Read-onlyList Test Candidates
List the candidates invited to a test. Returns each candidate's id, name, email, score, status, attempt times, invite details, tags and report URLs, plus pagination links. Use hackerrankwork_list_test_candidates to browse one test's candidates; use hackerrankwork_search_test_candidates to find by name or email, or hackerrankwork_search_candidates to search across all tests.
Inputs
test_idstringrequired- ID of the test whose candidates to list.
limitinteger- Number of records to return per page. Maximum 100.default
10 offsetinteger- Number of records to skip before the first result, used for pagination. Follow the next link in the response for the following page.default
0
hackerrankwork_list_test_invitersList the users who are allowed to invite candidates to a test.Read-onlyList Test Inviters
List the users who are allowed to invite candidates to a test. Returns each inviter's id, email, name, role, status, permissions, teams and number of candidates invited. Use hackerrankwork_list_test_inviters to see who can invite for a test; use hackerrankwork_list_users for every user in the account.
Inputs
test_idstringrequired- ID of the test whose inviters to list.
limitinteger- Number of records to return per page. Maximum 100.default
10 offsetinteger- Number of records to skip before the first result, used for pagination. Follow the next link in the response for the following page.default
0
hackerrankwork_list_testsList the assessment tests in your HackerRank for Work account, newest page first.Read-onlyList Tests
List the assessment tests in your HackerRank for Work account, newest page first. Returns, per test, its id, unique_id, name, duration, owner, state, draft and locked flags, languages, tags, role ids, questions, login URLs and pagination links. Use hackerrankwork_list_tests to browse tests; use hackerrankwork_get_test for the full settings of one test.
Inputs
limitinteger- Number of records to return per page. Maximum 100.default
10 offsetinteger- Number of records to skip before the first result, used for pagination. Follow the next link in the response for the following page.default
0
hackerrankwork_list_usersList the users in your HackerRank for Work company account.Read-onlyList Users
List the users in your HackerRank for Work company account. Returns each user's id, email, name, role, status, permissions, admin flags, teams and last activity time, plus pagination links. Use hackerrankwork_list_users to browse everyone; use hackerrankwork_search_users to find by name or email, or hackerrankwork_get_user for one user.
Inputs
limitinteger- Number of records to return per page. Maximum 100.default
10 offsetinteger- Number of records to skip before the first result, used for pagination. Follow the next link in the response for the following page.default
0
hackerrankwork_search_candidatesSearch candidates across all tests by name or email.Read-onlySearch Candidates
Search candidates across all tests by name or email. Returns each matching candidate's uuid, name, email, timestamps and the accessible test attempts with their results, plus pagination links. Use hackerrankwork_search_candidates to find a person across every test; use hackerrankwork_search_test_candidates to search inside one test.
Inputs
querystringrequired- Candidate name or email to search for.
limitinteger- Number of records to return per page. Maximum 100.default
10 offsetinteger- Number of records to skip before the first result, used for pagination. Follow the next link in the response for the following page.default
0
hackerrankwork_search_test_candidatesSearch one test's candidates by name or email.Read-onlySearch Test Candidates
Search one test's candidates by name or email. Returns matching candidates with id, name, email, score, status, attempt times, invite details and report URLs, plus pagination links. Use hackerrankwork_search_test_candidates when you know part of a name or email and the test; use hackerrankwork_search_candidates to search across every test.
Inputs
searchstringrequired- Candidate name or email, or part of one.
test_idstringrequired- ID of the test to search within.
limitinteger- Number of records to return per page. Maximum 100.default
10 offsetinteger- Number of records to skip before the first result, used for pagination. Follow the next link in the response for the following page.default
0
hackerrankwork_search_usersSearch users by name or email.Read-onlySearch Users
Search users by name or email. Returns matching users with id, email, name, role, status, permissions, teams and last activity time, plus pagination links. Use hackerrankwork_search_users when you know part of a name or email; use hackerrankwork_list_users to browse everyone.
Inputs
searchstringrequired- Name or email, or part of one, to search for.
limitinteger- Number of records to return per page. Maximum 100.default
10 offsetinteger- Number of records to skip before the first result, used for pagination. Follow the next link in the response for the following page.default
0
hackerrankwork_archive_testArchive an assessment test so it no longer appears among active tests.WriteArchive Test
Archive an assessment test so it no longer appears among active tests. Returns an empty success response (HTTP 204) when the test is archived. Use hackerrankwork_archive_test to retire a test without deleting its data.
Inputs
test_idstringrequired- ID of the test to archive.
hackerrankwork_create_interviewSchedule a new live coding interview, optionally inviting the interviewers and candidate by email.WriteCreate Interview
Schedule a new live coding interview, optionally inviting the interviewers and candidate by email. Returns the created interview with its id, title, url, scheduled times, interviewers and candidate. Use hackerrankwork_create_interview to schedule one; use hackerrankwork_update_interview to change an existing interview. Emails go out only when send_email is true.
Inputs
titlestringrequired- Title of the interview.
ai_assistant_availableboolean- Set true to make the AI assistant available. Applies only when the AI add-on and AI assistant setting are enabled for your company.
candidateobject- Candidate to invite, as an object with an email and optional name, for example {"name":"Mark Ramone","email":"mark@example.com"}.
fromstring- Scheduled start time of the interview as an ISO 8601 datetime.
interview_template_idinteger- ID of the interview template to use, from hackerrankwork_list_interview_templates.
interviewersarray- Email addresses of the interviewers to invite, for example ["hina@techcorp.com"].
metadataobject- Any additional information to store with the interview.
notesstring- Notes shown to the interviewers.
result_urlstring- Webhook URL that receives results after the interview ends or when feedback changes on a completed interview.
resume_urlstring- Link to the candidate's resume.
send_emailboolean- Set true to send or resend invitation emails to the attendees.
tostring- Scheduled end time of the interview as an ISO 8601 datetime.
hackerrankwork_create_interview_templateCreate a new interview template, optionally with starting questions.WriteCreate Interview Template
Create a new interview template, optionally with starting questions. Returns the created template with its id, name, roles and questions. Use hackerrankwork_create_interview_template to make a template; use hackerrankwork_update_interview_template to rename or re-role an existing one. Question ids must be accessible to you.
Inputs
namestringrequired- Name of the interview template.
question_idsarray- Ids of questions to add to the template, from hackerrankwork_list_questions.
role_idstring- Role unique id for the template.
hackerrankwork_create_testCreate a new assessment test in HackerRank for Work.WriteCreate Test
Create a new assessment test in HackerRank for Work. Returns the created test with its id, unique_id, name, state and settings. Use hackerrankwork_create_test to add a test; use hackerrankwork_update_test to change an existing one. Candidates can only be invited once the test is published (draft false).
Inputs
durationintegerrequired- Duration of the test in minutes.
experiencearrayrequired- Experience levels the test targets. Allowed values: Intern, New Graduate, 0-2 years, 2-5 years, >5 years, All Experience Levels.
namestringrequired- Name of the test as shown to your team.
role_idsarrayrequired- IDs of the roles associated with the test.
candidate_detailsarray- Details candidates must enter before logging in, as a list of objects such as [{"predefined_label":"full_name","required":true}]. They appear in the candidate report.
custom_acknowledge_textstring- Text candidates must agree to before logging in.
cutoff_scoreinteger- Candidates scoring at or above this value are placed in the Qualified bucket, those below in Failed.
draftboolean- True keeps the test in Draft state, false publishes it. Candidates can only be invited to published tests.
enable_acknowledgementboolean- If false, candidates are not asked to agree to the acknowledgement text.
enable_advanced_proctoringboolean- If true, webcam photos are analyzed with AI to detect suspicious activity.
enable_ml_plagiarism_analysisboolean- If true, detects whether a candidate received help from an external source. Defaults to false.
enable_photo_identificationboolean- If true, candidates must take a photo before starting. Defaults to false.
enable_proctoringboolean- If true, candidates must turn their webcam on and periodic snapshots appear in the report.
enable_secure_assessment_modeboolean- If true, enables secure mode (Integrity settings). Defaults to false.
endtimestring- ISO 8601 datetime. Candidate logins after this time are disabled; candidates already logged in can finish normally.
hide_compile_testboolean- If true, candidates cannot see the compile button for coding and approximate questions.
hide_templateboolean- If true, head and tail code templates are not shown to candidates.
ide_configstring- IDE configuration for front-end, back-end and full-stack questions: ide_and_git, ide or git. API default is ide.one of
ide_and_gitidegit instructionsstring- HTML shown to candidates on the test login page.
languagesarray- Programming languages available for coding and approximate questions, for example ["java","cpp"]. Null enables all languages.
lockedboolean- Whether the test is locked. A locked test cannot be edited, but candidates can still be invited.
master_passwordstring- If set, candidates can log in to the test with this password.
mcq_correct_scoreinteger- Score added per correct multiple-choice answer.
mcq_incorrect_scoreinteger- Score deducted per incorrect multiple-choice answer.
questionsarray- IDs of the questions in the test, as returned by hackerrankwork_list_questions.
shuffle_questionsboolean- If true, questions are shuffled for each candidate.
starttimestring- ISO 8601 datetime. Candidate logins before this time are disabled; candidates already logged in are not affected.
tagsarray- Tags to associate with the test, for example ["Java","Senior"].
test_adminsarray- Email addresses of test admins, who also receive summary mails when a candidate completes the test.
hackerrankwork_invite_candidateInvite a single candidate to a published test, optionally sending the invitation email.WriteInvite Candidate
Invite a single candidate to a published test, optionally sending the invitation email. Returns the candidate's id, email and the test_link they use to take the test. Use hackerrankwork_invite_candidate to invite one person per call. No email is sent unless send_email is true. The test must be published (not draft).
Inputs
emailstringrequired- Email address of the candidate.
test_idstringrequired- ID of the published test to invite the candidate to.
accept_result_updatesboolean- Set true to also send score and status updates to test_result_url. API default is false.
accommodationsobject- Accommodations object, for example {"additional_time_percent": 25} to add 25 percent extra time.
ats_stateinteger- Current state of the candidate application, an integer from 0 to 22.
evaluator_emailstring- Email of the evaluator, if different from the test admins and owner.
forceboolean- Set true to send the email even if the candidate was already invited.
force_reattemptboolean- Set true to re-invite even if the candidate already attempted the test.
full_namestring- Full name of the candidate.
invite_metadataobject- Custom metadata object stored with the candidate, for example {"ats_candidate_id": 1}.
invite_valid_fromstring- ISO 8601 time from which the invite is valid. Omit for no start restriction.
invite_valid_tostring- ISO 8601 time until which the invite is valid. Omit for a permanently valid invite.
messagestring- Custom message prepended to the invite email body.
send_emailboolean- Set true to send the invitation email. When false or omitted the invite is recorded but no email is sent.
subjectstring- Subject of the invite email.
tagsarray- Tags to associate with the candidate.
templatestring- ID of the invite template to use, from hackerrankwork_list_invite_templates.
test_finish_urlstring- URL candidates are redirected to when the test ends. Defaults to the feedback page.
test_result_urlstring- Webhook URL that receives the candidate report when it is processed. By default the inviter gets it by email.
webhook_authenticationobject- Authentication for the result webhook: {"type":"bearer_token","data":{"token":"..."}} or {"type":"basic_auth","data":{"username":"...","password":"..."}}.
hackerrankwork_update_interviewUpdate a live coding interview's schedule, interviewers, candidate or notes; only the fields you pass are changed.WriteUpdate Interview
Update a live coding interview's schedule, interviewers, candidate or notes; only the fields you pass are changed. Returns the updated interview with its id, title, url, scheduled times, interviewers and candidate. Use hackerrankwork_update_interview to edit an existing interview; use hackerrankwork_create_interview to schedule a new one. Pass replace_interviewers true to replace the interviewer list instead of adding to it.
- Idempotent
Inputs
interview_idstringrequired- ID of the interview to update.
ai_assistant_availableboolean- Set true to make the AI assistant available. Applies only when the AI add-on and AI assistant setting are enabled for your company.
candidateobject- Candidate to invite, as an object with an email and optional name, for example {"name":"Mark Ramone","email":"mark@example.com"}.
fromstring- Scheduled start time of the interview as an ISO 8601 datetime.
interview_template_idinteger- ID of the interview template to use, from hackerrankwork_list_interview_templates.
interviewersarray- Email addresses of the interviewers to invite, for example ["hina@techcorp.com"].
metadataobject- Any additional information to store with the interview.
notesstring- Notes shown to the interviewers.
replace_interviewersboolean- If true, the interviewers list is replaced with the interviewers provided instead of being added to.
result_urlstring- Webhook URL that receives results after the interview ends or when feedback changes on a completed interview.
resume_urlstring- Link to the candidate's resume.
send_emailboolean- Set true to send or resend invitation emails to the attendees.
titlestring- New title of the interview.
tostring- Scheduled end time of the interview as an ISO 8601 datetime.
hackerrankwork_update_interview_templateUpdate an interview template's name, role or scorecard; only the fields you pass are changed.WriteUpdate Interview Template
Update an interview template's name, role or scorecard; only the fields you pass are changed. Returns the updated template with its id, name, roles, questions and scorecard. Use hackerrankwork_update_interview_template to edit a template; use hackerrankwork_create_interview_template for a new one. Only the owner, permitted admins or editors can update.
- Idempotent
Inputs
template_idintegerrequired- ID of the interview template to update.
namestring- New name of the interview template.
role_idstring- Role unique id for the template.
scorecard_idinteger- Id of the scorecard to associate with the template.
hackerrankwork_update_testUpdate the settings of an existing assessment test; only the fields you pass are changed.WriteUpdate Test
Update the settings of an existing assessment test; only the fields you pass are changed. Returns the updated test with its id, name, state and settings. Use hackerrankwork_update_test to edit a test; use hackerrankwork_create_test to make a new one. Locked tests cannot be edited.
- Idempotent
Inputs
test_idstringrequired- ID of the test to update.
candidate_detailsarray- Details candidates must enter before logging in, as a list of objects such as [{"predefined_label":"full_name","required":true}]. They appear in the candidate report.
custom_acknowledge_textstring- Text candidates must agree to before logging in.
cutoff_scoreinteger- Candidates scoring at or above this value are placed in the Qualified bucket, those below in Failed.
draftboolean- True keeps the test in Draft state, false publishes it. Candidates can only be invited to published tests.
durationinteger- Duration of the test in minutes.
enable_acknowledgementboolean- If false, candidates are not asked to agree to the acknowledgement text.
enable_advanced_proctoringboolean- If true, webcam photos are analyzed with AI to detect suspicious activity.
enable_ml_plagiarism_analysisboolean- If true, detects whether a candidate received help from an external source. Defaults to false.
enable_photo_identificationboolean- If true, candidates must take a photo before starting. Defaults to false.
enable_proctoringboolean- If true, candidates must turn their webcam on and periodic snapshots appear in the report.
enable_secure_assessment_modeboolean- If true, enables secure mode (Integrity settings). Defaults to false.
endtimestring- ISO 8601 datetime. Candidate logins after this time are disabled; candidates already logged in can finish normally.
experiencearray- Experience levels the test targets. Allowed values: Intern, New Graduate, 0-2 years, 2-5 years, >5 years, All Experience Levels.
hide_compile_testboolean- If true, candidates cannot see the compile button for coding and approximate questions.
hide_templateboolean- If true, head and tail code templates are not shown to candidates.
ide_configstring- IDE configuration for front-end, back-end and full-stack questions: ide_and_git, ide or git. API default is ide.one of
ide_and_gitidegit instructionsstring- HTML shown to candidates on the test login page.
languagesarray- Programming languages available for coding and approximate questions, for example ["java","cpp"]. Null enables all languages.
lockedboolean- Whether the test is locked. A locked test cannot be edited, but candidates can still be invited.
master_passwordstring- If set, candidates can log in to the test with this password.
mcq_correct_scoreinteger- Score added per correct multiple-choice answer.
mcq_incorrect_scoreinteger- Score deducted per incorrect multiple-choice answer.
namestring- Name of the test as shown to your team.
questionsarray- IDs of the questions in the test, as returned by hackerrankwork_list_questions.
role_idsarray- IDs of the roles associated with the test.
shuffle_questionsboolean- If true, questions are shuffled for each candidate.
starttimestring- ISO 8601 datetime. Candidate logins before this time are disabled; candidates already logged in are not affected.
tagsarray- Tags to associate with the test, for example ["Java","Senior"].
test_adminsarray- Email addresses of test admins, who also receive summary mails when a candidate completes the test.
hackerrankwork_update_test_candidateUpdate a test candidate's invite settings, metadata or tags; only the fields you pass are changed.WriteUpdate Test Candidate
Update a test candidate's invite settings, metadata or tags; only the fields you pass are changed. Returns the updated candidate record with id, name, email, score, status and invite details. Use hackerrankwork_update_test_candidate to change an existing candidate; use hackerrankwork_invite_candidate to invite someone new.
- Idempotent
Inputs
candidate_idstringrequired- ID of the candidate to update.
test_idstringrequired- ID of the test the candidate was invited to.
accept_result_updatesboolean- Set true to also send score and status updates to test_result_url.
accommodationsobject- Accommodations object, for example {"additional_time_percent": 25}.
ats_stateinteger- Current state of the candidate application, an integer from 0 to 22.
evaluator_emailstring- Email of the evaluator, if different from the test admins and owner.
full_namestring- New full name of the candidate.
invite_metadataobject- Custom metadata object stored with the candidate.
invite_valid_fromstring- ISO 8601 time from which the invite is valid.
invite_valid_tostring- ISO 8601 time until which the invite is valid.
tagsarray- Tags to associate with the candidate.
test_finish_urlstring- URL candidates are redirected to when the test ends.
test_result_urlstring- Webhook URL that receives the candidate report when it is processed.
webhook_authenticationobject- Authentication for the result webhook: {"type":"bearer_token","data":{"token":"..."}} or {"type":"basic_auth","data":{"username":"...","password":"..."}}.
hackerrankwork_cancel_candidate_inviteCancel a candidate's invitation to a test so the invite link stops working.DestructiveCancel Candidate Invite
Cancel a candidate's invitation to a test so the invite link stops working. Returns an empty success response when the invite is cancelled. Use hackerrankwork_cancel_candidate_invite to withdraw an invitation; use hackerrankwork_update_test_candidate to change its validity window instead.
- Idempotent
Inputs
candidate_idstringrequired- ID of the candidate whose invite to cancel.
test_idstringrequired- ID of the test the candidate was invited to.
hackerrankwork_delete_interviewDelete a live coding interview.DestructiveDelete Interview
Delete a live coding interview. Returns an empty success response when the interview is deleted. Use hackerrankwork_delete_interview to remove an interview permanently; use hackerrankwork_update_interview to reschedule it instead.
- Idempotent
Inputs
interview_idstringrequired- ID of the interview to delete.
No tools match.
