NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
HackerRank Work connects to a Nagent workspace with an API key. Once it is connected, agents can call 3 HackerRank Work actions: "List Companies", "Get SSO Sign-On URL" and "Consume SAML Assertion". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against HackerRank Work, with input parameters and output schema.
HACKERRANK_WORK_COMPANIES_LISTTool to list all companies and their unique identifiers. Use when you need the company_unique_id for SSO metadata retrieval.
Input parameters
Optional path hint: 'admin' to prefer /admin/api, 'x' to prefer /x/api.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HACKERRANK_WORK_SSO_ASSERTION_CONSUMER_SERVICETool to consume SAML assertions. Use when receiving SAMLResponse and RelayState from the Identity Provider for SSO sign-in.
Input parameters
Optional RelayState parameter returned by the Identity Provider.
Base64-encoded SAML assertion from the Identity Provider (SAMLResponse).
Your company's unique SSO identifier in HackerRank Work.
Whether to raise an ExecutionFailed error when the ACS responds with an HTTP status code >= 400. Set to false to always return the raw response details (status_code, headers, content) for troubleshooting.
Optional raw XML for the SAMLResponse. If provided, the action will base64-encode this value and send it as SAMLResponse, overriding the saml_response field.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HACKERRANK_WORK_SSO_SIGN_ON_URLTool to get the SP-initiated SSO sign-on URL. Use when configuring SAML SSO with your identity provider.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 3 HackerRank Work actions on Nagent: "List Companies", "Get SSO Sign-On URL" and "Consume SAML Assertion". List Companies: List all companies and their unique identifiers. Each action is listed on this page with its input parameters and its output.
HackerRank Work connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It also takes 1 optional input: path_hint. It returns data, error and successful.