{ "id": 2, "jsonrpc": "2.0", "result": { "_comment": "Reference catalog. A tools/list response includes only tools currently available to the authorized member.", "tools": [ { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Return the current Jointl workspace and the access granted to the member. Use when: Call once at the start of a task that depends on workspace identity, company scope, or permissions; do not use it to discover domain records. Returns: workspace ID, workspace name, member identity, accessible companies, and granted permission keys. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "jointl_workspace_get", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "companyScope": { "additionalProperties": true, "type": "object" }, "grantedPermissions": { "items": { "type": "string" }, "type": "array" }, "member": { "additionalProperties": true, "properties": { "id": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "roleId": { "type": [ "string", "null" ] } }, "type": "object" }, "name": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "name", "member", "companyScope", "grantedPermissions" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "Get workspace access" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Quickly search the connected workspace across authorized people, emails, attributes, companies, tags, job titles, and Flows using the same permissions and relevance ranking as the Jointl UI. An optional source-type filter is applied before ranking. Returns at most 30 top matches and is not an exhaustive list. Use when: Use for quick entity lookup from a name, email, attribute, company, tag, job title, or Flow phrase; optionally restrict source types before ranking, and use a domain list or analytics operation for complete cohorts. Returns: ranked matches in `sourceRecords`, suggested next operations in `followUpOperations`, result counts, the applied limit, and `exhaustive: false`. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "entityTypes": { "description": "Optional source-type filter applied before ranking. Omit it to search every global-search type.", "items": { "enum": [ "applicant", "employee", "talent", "reference", "flow", "member" ], "type": "string" }, "maxItems": 6, "minItems": 1, "type": "array" }, "limit": { "default": 30, "maximum": 30, "minimum": 1, "type": "integer" }, "query": { "description": "Search people, emails, attributes, companies, tags, job titles, and Flows.", "maxLength": 120, "minLength": 2, "type": "string" } }, "required": [ "query" ], "type": "object" }, "name": "jointl_workspace_search", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "exhaustive": { "type": "boolean" }, "items": { "items": { "additionalProperties": true, "properties": { "entityId": { "type": [ "string", "null" ] }, "entityType": { "type": "string" }, "followUpOperations": { "items": { "additionalProperties": true, "properties": { "input": { "additionalProperties": true, "type": "object" }, "operationId": { "type": "string" } }, "required": [ "operationId", "input" ], "type": "object" }, "type": "array" }, "label": { "type": "string" }, "sourceRecords": { "items": { "additionalProperties": true, "properties": { "applicantId": { "type": [ "string", "null" ] }, "companyName": { "type": [ "string", "null" ] }, "entityId": { "type": "string" }, "entityType": { "type": "string" }, "label": { "type": "string" }, "primary": { "type": [ "string", "null" ] }, "route": { "type": [ "string", "null" ] }, "statusLabels": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" } }, "required": [ "entityType", "entityId" ], "type": "object" }, "type": "array" } }, "type": "object" }, "type": "array" }, "query": { "type": "string" }, "resultLimit": { "type": "number" }, "returnedCount": { "type": "number" } }, "required": [ "query", "items", "returnedCount", "resultLimit", "exhaustive" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "Search Jointl" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "List Jointl companies visible through the member’s current company scope. Use when: Use before a scoped Flow, Employee import, or other action needs an exact Jointl company ID. Returns: a cursor-paginated list of company IDs, names, statuses, and creation timestamps. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "cursor": { "additionalProperties": false, "properties": { "createdAt": { "anyOf": [ { "format": "date-time", "type": "string" }, { "format": "date-time", "type": "string" } ] }, "id": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "createdAt", "id" ], "type": "object" }, "includeArchived": { "default": false, "description": "Include archived companies; active companies are returned by default.", "type": "boolean" }, "limit": { "default": 100, "maximum": 200, "minimum": 1, "type": "integer" } }, "type": "object" }, "name": "jointl_companies_list", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "hasMore": { "type": "boolean" }, "items": { "items": { "additionalProperties": true, "properties": { "_id": { "type": "string" }, "name": { "type": "string" }, "status": { "type": [ "string", "null" ] } }, "type": "object" }, "type": "array" }, "nextCursor": { "additionalProperties": true, "type": [ "object", "null" ] } }, "required": [ "items", "hasMore", "nextCursor" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "List companies" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "List Flows available through the member’s role, sharing, ownership, and company access. Use when: Use to browse or filter a Flow cohort; use flows.get for one Flow or flows.blueprint.get only for authoring a revision. Returns: a cursor-paginated list of Flow summaries with activity, company, tags, type, status, and IDs. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "activeOnly": { "default": false, "description": "Return only active Flows when true.", "type": "boolean" }, "cursor": { "additionalProperties": false, "properties": { "createdAt": { "anyOf": [ { "format": "date-time", "type": "string" }, { "format": "date-time", "type": "string" } ] }, "id": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "createdAt", "id" ], "type": "object" }, "includeActivity": { "default": true, "description": "Include aggregate activity counts. Disable for lightweight selectors and dropdowns.", "type": "boolean" }, "includeUnscopedCompanies": { "default": false, "description": "When company filters are supplied, also include authorized Flows with no company.", "type": "boolean" }, "limit": { "default": 100, "maximum": 200, "minimum": 1, "type": "integer" }, "selectedCompanies": { "default": [], "description": "Exact Jointl company IDs from companies.list; empty means every authorized company.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 100, "type": "array" }, "selectedFlowStatus": { "default": [], "description": "Exact Flow statuses; empty means every authorized status.", "items": { "enum": [ "ACTIVE", "DRAFT", "ARCHIVED" ], "type": "string" }, "maxItems": 100, "type": "array" }, "selectedTags": { "default": [], "description": "Exact Jointl tag IDs; empty means every tag.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 100, "type": "array" }, "type": { "description": "Optionally return one exact enabled Flow type.", "enum": [ "HIRING_REVIEW", "PERFORMANCE", "EXIT_INTELLIGENCE" ], "type": "string" } }, "type": "object" }, "name": "jointl_flows_list", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "hasMore": { "type": "boolean" }, "items": { "items": { "additionalProperties": true, "properties": { "_id": { "type": "string" }, "status": { "type": [ "string", "null" ] }, "title": { "type": "string" }, "type": { "type": [ "string", "null" ] } }, "type": "object" }, "type": "array" }, "nextCursor": { "additionalProperties": true, "type": [ "object", "null" ] } }, "required": [ "items", "hasMore", "nextCursor" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "List Flows" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Get one visible Flow. Sensitive automation tokens are never returned. Use when: Use for the operational details of one Flow; use flows.blueprint.get instead when preparing a draft revision. Returns: the authorized Flow details, related company, job role, tags, sharing members, and automation status summaries. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "flowId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "flowId" ], "type": "object" }, "name": "jointl_flows_get", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "_id": { "type": "string" }, "status": { "type": [ "string", "null" ] }, "title": { "type": "string" }, "type": { "type": [ "string", "null" ] } }, "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "Get Flow" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Read supported Flow types, sections, question types, valid section ordering, current authoring permissions, and protected actions before proposing a Flow. Use when: Call before creating or substantially redesigning a Flow so the proposed design uses only supported sections and question types. Returns: supported types and sections, authoring limits, current write access, the authoring protocol, and protected actions. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "jointl_flows_capabilities_get", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "authoringProtocol": { "items": { "type": "string" }, "type": "array" }, "decisionSupport": { "additionalProperties": true, "type": "object" }, "draftWriteSupport": { "additionalProperties": true, "type": "object" }, "flowTypes": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, "liveAccess": { "additionalProperties": true, "type": "object" }, "protectedActions": { "items": { "type": "string" }, "type": "array" }, "sections": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, "structuredReferenceQuestionTypes": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, "supportedAuthoredQuestionTypes": { "additionalProperties": true, "type": "object" } }, "required": [ "flowTypes", "sections", "supportedAuthoredQuestionTypes", "structuredReferenceQuestionTypes", "draftWriteSupport", "liveAccess", "decisionSupport", "authoringProtocol", "protectedActions" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "Get Flow authoring capabilities" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "List visible Private and Public Jointl Library templates in one category, including their questions, so an assistant can reuse workspace content and valid IDs. Use when: Use to browse one exact template category or inspect all questions in matching templates; use flows.questions.search for cross-category relevance search. Returns: template IDs and titles with complete question blocks for the returned templates, plus indicators telling the assistant to increase the limit or narrow the query when results were truncated. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "kind": { "description": "One exact template category to browse.", "enum": [ "preScreening", "assessmentQuestions", "assessmentTests", "references", "exitIntelligence", "teamPulse" ], "type": "string" }, "limit": { "default": 50, "maximum": 100, "minimum": 1, "type": "integer" }, "query": { "maxLength": 120, "minLength": 1, "type": "string" } }, "required": [ "kind" ], "type": "object" }, "name": "jointl_flows_templates_list", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "catalogScanTruncated": { "type": "boolean" }, "hasMore": { "type": "boolean" }, "items": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, "kind": { "type": "string" }, "totalMatchedInScan": { "type": "number" } }, "required": [ "kind", "items", "totalMatchedInScan", "catalogScanTruncated", "hasMore" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "List Flow templates" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Search relevant questions across visible pre-screening, assessment, test, reference, exit, and Team Pulse templates without loading entire catalogs into the assistant context. Use when: Use first when finding reusable questions for a use case across one or more categories; do not load entire template catalogs just to search. Returns: relevance-ranked question and template IDs, prompts, types, options, matched terms, and search coverage details. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "kinds": { "default": [ "preScreening", "assessmentQuestions", "assessmentTests", "references", "exitIntelligence", "teamPulse" ], "description": "Categories to search. Restrict this list when the requested Flow uses only specific sections.", "items": { "enum": [ "preScreening", "assessmentQuestions", "assessmentTests", "references", "exitIntelligence", "teamPulse" ], "type": "string" }, "maxItems": 6, "type": "array" }, "limit": { "default": 25, "maximum": 100, "minimum": 1, "type": "integer" }, "query": { "description": "The job-related capability or use case to find in question prompts, attributes, template titles, types, and options.", "maxLength": 160, "minLength": 2, "type": "string" } }, "required": [ "query" ], "type": "object" }, "name": "jointl_flows_questions_search", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "catalogScanTruncated": { "type": "boolean" }, "hasMore": { "type": "boolean" }, "items": { "items": { "additionalProperties": true, "properties": { "aiFollowUpEnabled": { "type": "boolean" }, "attribute": { "type": [ "string", "null" ] }, "insightsExtractionEnabled": { "type": "boolean" }, "kind": { "type": "string" }, "matchedTerms": { "items": { "type": "string" }, "type": "array" }, "prompt": { "type": [ "string", "null" ] }, "questionId": { "type": [ "string", "null" ] }, "relevance": { "type": "number" }, "templateId": { "type": "string" }, "templateSource": { "type": "string" }, "templateTitle": { "type": "string" }, "type": { "type": [ "string", "null" ] } }, "type": "object" }, "type": "array" }, "searchedQuestionCount": { "type": "number" }, "searchedTemplateCount": { "type": "number" }, "totalMatchedInScan": { "type": "number" }, "truncatedKinds": { "items": { "type": "string" }, "type": "array" } }, "required": [ "items", "totalMatchedInScan", "searchedTemplateCount", "searchedQuestionCount", "catalogScanTruncated", "truncatedKinds", "hasMore" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "Search Flow questions" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "List the exact reference forms configured for manual collection on one visible Flow. Use when: Use before requesting a reference so the action receives a valid template ID configured on the selected Check’s Flow. Returns: ordered reference template IDs, titles, icons, and types configured on the Flow. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "flowId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "flowId" ], "type": "object" }, "name": "jointl_flows_reference_templates_list", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "items": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" } }, "required": [ "items" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "List manual reference templates for a Flow" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Read one visible Flow’s latest editable configuration and expanded question/template design. Sensitive automation tokens and protected automation settings are excluded. Use when: Use only before flows.draft.revise so the latest revision token and complete supported design can be preserved. Returns: the editable Flow metadata, expanded design, revision token, and indicators for settings that must be managed separately. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "flowId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "flowId" ], "type": "object" }, "name": "jointl_flows_blueprint_get", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "design": { "additionalProperties": true, "type": "object" }, "editableDesign": { "additionalProperties": true, "type": "object" }, "flow": { "additionalProperties": true, "type": "object" }, "revision": { "type": "string" }, "safety": { "additionalProperties": true, "type": "object" } }, "required": [ "flow", "design", "editableDesign", "revision", "safety" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "Get complete Flow blueprint" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Read one visible Performance Flow’s participants, cadence, recent Glow Moments and Team Pulse cycles, and completion state. Shareable participant and scoreboard links are returned only when explicitly requested. Use when: Use after flows.get for a Performance Flow when the user needs cycle progress, a cycle ID, or an explicitly requested participant/scoreboard link. Returns: the Performance configuration and recent cycles visible to the member; optional participant and scoreboard links include an explicit sharing warning. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "cycleLimit": { "default": 5, "description": "Number of recent Glow Moments and Team Pulse cycles to return per feature.", "maximum": 10, "minimum": 1, "type": "integer" }, "flowId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "includeLinks": { "default": false, "description": "Include participant access links and the Glow scoreboard link only when the user explicitly needs them.", "type": "boolean" } }, "required": [ "flowId" ], "type": "object" }, "name": "jointl_performance_operations_get", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "capabilityWarning": { "type": [ "string", "null" ] }, "flow": { "additionalProperties": true, "type": "object" }, "glowMoments": { "additionalProperties": true, "type": "object" }, "teamPulse": { "additionalProperties": true, "type": "object" } }, "required": [ "flow", "glowMoments", "teamPulse" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "Get Glow Moments and Team Pulse operations" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "List Checks visible through the member’s role, sharing, creator, manager, and company permissions. Use when: Use to browse or filter Checks and obtain applicant IDs; use checks.analytics for comparisons and checks.get for one person. Returns: a cursor-paginated list of authorized Check summaries, Flow context, statuses, progress, and IDs. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "cursor": { "additionalProperties": false, "properties": { "createdAt": { "anyOf": [ { "format": "date-time", "type": "string" }, { "format": "date-time", "type": "string" } ] }, "id": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "createdAt", "id" ], "type": "object" }, "limit": { "default": 100, "maximum": 200, "minimum": 1, "type": "integer" }, "selectedApplicantStatus": { "default": [ "new", "inProgress", "shortlisted" ], "description": "Defaults to current Checks. Pass an empty array to include every authorized Check status.", "items": { "enum": [ "new", "archived", "inProgress", "shortlisted", "rejected", "selected" ], "type": "string" }, "maxItems": 100, "type": "array" }, "selectedFlows": { "default": [], "description": "Exact Flow IDs. A non-empty list automatically enables the Flow filter.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 100, "type": "array" } }, "type": "object" }, "name": "jointl_checks_list", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "hasMore": { "type": "boolean" }, "items": { "items": { "additionalProperties": true, "properties": { "_id": { "type": "string" }, "firstName": { "type": [ "string", "null" ] }, "flowId": { "type": [ "string", "null" ] }, "lastName": { "type": [ "string", "null" ] }, "status": { "type": [ "string", "null" ] } }, "type": "object" }, "type": "array" }, "nextCursor": { "additionalProperties": true, "type": [ "object", "null" ] } }, "required": [ "items", "hasMore", "nextCursor" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "List Checks" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Return a paginated, evidence-based ranking within each visible Flow, including matching scores, measured high and low evidence, evidence coverage, and verification state. It never recommends an employment decision. Use when: Use first for top-candidate, ranking, strengths, weaknesses, or cohort-comparison requests; follow nextOffset until null when the complete filtered cohort is required. Returns: per-Flow factual ranks, scores, evidence summaries, coverage and verification signals, cohort counts, pagination, and guidance for human review. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "limit": { "default": 25, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 999, "minimum": 0, "type": "integer" }, "selectedApplicantStatus": { "default": [ "new", "inProgress", "shortlisted" ], "description": "Defaults to current Checks. Pass an empty array to include every authorized Check status.", "items": { "enum": [ "new", "archived", "inProgress", "shortlisted", "rejected", "selected" ], "type": "string" }, "maxItems": 100, "type": "array" }, "selectedFlows": { "default": [], "description": "Exact Flow IDs. Empty means every otherwise-authorized Flow, subject to the cohort bound.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 20, "type": "array" } }, "type": "object" }, "name": "jointl_checks_analytics", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "evaluatedCandidateCount": { "type": "number" }, "exactCohort": { "type": "boolean" }, "flowCohorts": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, "hasMore": { "type": "boolean" }, "items": { "items": { "additionalProperties": true, "properties": { "applicantId": { "type": "string" }, "detailOperation": { "type": "string" }, "evidenceSummary": { "type": "string" }, "matchingScore": { "type": [ "number", "null" ] }, "matchingScorePercent": { "type": [ "number", "null" ] }, "name": { "type": "string" }, "rankWithinFlow": { "type": [ "number", "null" ] }, "scoredCandidateCount": { "type": "number" } }, "type": "object" }, "type": "array" }, "nextOffset": { "type": [ "number", "null" ] }, "offset": { "type": "number" }, "returnedCandidateCount": { "type": "number" }, "safety": { "additionalProperties": true, "type": "object" } }, "required": [ "items", "flowCohorts", "evaluatedCandidateCount", "returnedCandidateCount", "offset", "nextOffset", "exactCohort", "hasMore", "safety" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "Analyze Check evidence" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Return the profile, Flow context, recent visible activity, and optional condensed evidence for one authorized Check. Sensitive access tokens are never returned. Use when: Use after search, list, or analytics when one Check needs contextual detail; use checks.report only for the full itemized assessment and reference report. Returns: profile metadata and recent activity, evidenceIncluded, and either condensed pre-screening, matching, work and reference evidence or null. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "applicantId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "includeEvidence": { "default": true, "description": "Include the authorized evidence view. Set false only when profile metadata is sufficient.", "type": "boolean" } }, "required": [ "applicantId" ], "type": "object" }, "name": "jointl_checks_get", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "evidence": { "additionalProperties": true, "type": [ "object", "null" ] }, "evidenceIncluded": { "type": "boolean" }, "profile": { "additionalProperties": true, "type": "object" } }, "required": [ "profile", "evidenceIncluded", "evidence" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "Get one Check" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Return the authorized full factual Check report, including open-text answers, answered AI follow-ups, Tests, reference narratives and integrity context, employment confirmations, attributes, and scores—but no hiring recommendation. Use when: Use after checks.analytics for every candidate relevant to a comparative conclusion, or after checks.get when complete itemized evidence is needed; do not rely on rating and score summaries alone. Returns: the itemized authorized Check report with factual narrative and measured evidence; it never returns a recommendation or reference responses the member cannot access. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "applicantId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "applicantId" ], "type": "object" }, "name": "jointl_checks_report", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "assessment": { "additionalProperties": true, "type": [ "object", "null" ] }, "company": { "additionalProperties": true, "type": [ "object", "null" ] }, "crossVerifiedAttributeScores": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, "flow": { "additionalProperties": true, "type": [ "object", "null" ] }, "flowRequest": { "additionalProperties": true, "type": [ "object", "null" ] }, "keyAchievements": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, "matchingScore": { "type": [ "number", "null" ] }, "preScreening": { "additionalProperties": true, "type": [ "object", "null" ] }, "references": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, "referencesAvgMetrics": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" } }, "required": [ "flow", "company", "flowRequest", "preScreening", "assessment", "references", "referencesAvgMetrics", "crossVerifiedAttributeScores", "keyAchievements", "matchingScore" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "Get Check report" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "List authorized reference request and completion summaries for one visible Check with stable cursor pagination. Use when: Use to retrieve every reference for a Check or find a reference ID before retrieving one complete response. Returns: a cursor-paginated list of reference IDs, referee identity, type, status, and lifecycle times. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "applicantId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "cursor": { "additionalProperties": false, "properties": { "createdAt": { "anyOf": [ { "format": "date-time", "type": "string" }, { "format": "date-time", "type": "string" } ] }, "id": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "createdAt", "id" ], "type": "object" }, "limit": { "default": 100, "maximum": 200, "minimum": 1, "type": "integer" } }, "required": [ "applicantId" ], "type": "object" }, "name": "jointl_references_list", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "hasMore": { "type": "boolean" }, "items": { "items": { "additionalProperties": true, "properties": { "applicantId": { "type": "string" }, "createdAt": { "type": "string" }, "id": { "type": "string" }, "status": { "type": "string" } }, "type": "object" }, "type": "array" }, "nextCursor": { "additionalProperties": true, "type": [ "object", "null" ] } }, "required": [ "items", "hasMore", "nextCursor" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "List reference responses for a Check" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Return one authorized, normalized reference response and its Check-level average metrics. Use when: Use after references.list or a reference.completed event when the complete submitted response is needed. Returns: the complete reference response available to the member and average reference metrics. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "referenceId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "referenceId" ], "type": "object" }, "name": "jointl_references_get", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "Get one reference response" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "List Employees visible through the member’s role, sharing, manager, creator, and company permissions. Use when: Use to browse or filter Employees and obtain Employee IDs; use employees.analytics for performance comparisons and employees.get for one person. Returns: a cursor-paginated list of authorized Employee summaries with company, position, manager, tags, status, and IDs. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "cursor": { "additionalProperties": false, "properties": { "createdAt": { "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "id": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "createdAt", "id" ], "type": "object" }, "limit": { "default": 100, "maximum": 200, "minimum": 1, "type": "integer" }, "selectedCompanies": { "default": [], "description": "Exact Jointl company IDs; empty means every authorized company.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 100, "type": "array" }, "selectedEmployeeStatus": { "default": [ "active" ], "description": "Defaults to active Employees. Pass an empty array to include every authorized Employee status.", "items": { "enum": [ "active", "left" ], "type": "string" }, "maxItems": 100, "type": "array" }, "selectedTags": { "default": [], "description": "Exact Jointl tag IDs; empty means every tag.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 100, "type": "array" } }, "type": "object" }, "name": "jointl_employees_list", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "hasMore": { "type": "boolean" }, "items": { "items": { "additionalProperties": true, "properties": { "_id": { "type": "string" }, "companyId": { "type": [ "string", "null" ] }, "fullName": { "type": "string" }, "positionTitle": { "type": [ "string", "null" ] }, "status": { "type": [ "string", "null" ] } }, "type": "object" }, "type": "array" }, "nextCursor": { "additionalProperties": true, "type": [ "object", "null" ] } }, "required": [ "items", "hasMore", "nextCursor" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "List Employees" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Return a pageable factual ranking and review signals from Team Pulse and Glow Moments for only the Employees visible to the member. It never recommends an employment decision. Use when: Use first for best-performer, needs-attention, strengths, weaknesses, or workforce-comparison requests; follow nextOffset until null for the complete filtered cohort. Returns: factual visible-cohort ranks, performance scores, measured evidence, attention signals, counts, pagination, and guidance for human review. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "endDate": { "description": "Inclusive UTC evidence end date in YYYY-MM-DD. Omit both dates for the trailing six-month default.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "limit": { "default": 25, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 499, "minimum": 0, "type": "integer" }, "selectedCompanies": { "default": [], "description": "Exact Jointl company IDs; empty means every authorized company, subject to the cohort bound.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 100, "type": "array" }, "selectedEmployeeStatus": { "default": [ "active" ], "description": "Defaults to active Employees. Pass an empty array to include every authorized Employee status.", "items": { "enum": [ "active", "left" ], "type": "string" }, "maxItems": 100, "type": "array" }, "selectedTags": { "default": [], "description": "Exact Jointl tag IDs; empty means every tag.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 100, "type": "array" }, "startDate": { "description": "Inclusive UTC evidence start date in YYYY-MM-DD. Omit both dates for the trailing six-month default.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "type": "object" }, "name": "jointl_employees_analytics", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "evaluatedEmployeeCount": { "type": "number" }, "evidenceWindow": { "additionalProperties": true, "properties": { "endDate": { "type": [ "string", "null" ] }, "inclusive": { "type": "boolean" }, "startDate": { "type": [ "string", "null" ] }, "timeZone": { "type": "string" } }, "required": [ "startDate", "endDate", "inclusive", "timeZone" ], "type": "object" }, "exactCohort": { "type": "boolean" }, "hasMore": { "type": "boolean" }, "items": { "items": { "additionalProperties": true, "properties": { "attentionSignals": { "items": { "type": "string" }, "type": "array" }, "detailOperation": { "type": "string" }, "employeeId": { "type": "string" }, "evidenceSummary": { "type": "string" }, "name": { "type": "string" }, "performanceScore": { "type": [ "number", "null" ] }, "performanceScorePercent": { "type": [ "number", "null" ] }, "rankWithinVisibleCohort": { "type": [ "number", "null" ] }, "visibleCohortSize": { "type": "number" } }, "type": "object" }, "type": "array" }, "nextOffset": { "type": [ "number", "null" ] }, "offset": { "type": "number" }, "returnedEmployeeCount": { "type": "number" }, "safety": { "additionalProperties": true, "type": "object" }, "scoredEmployeeCount": { "type": "number" } }, "required": [ "items", "evaluatedEmployeeCount", "scoredEmployeeCount", "returnedEmployeeCount", "offset", "nextOffset", "evidenceWindow", "exactCohort", "hasMore", "safety" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "Analyze Employee performance evidence" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Return the profile, current work context, recent visible activity, and optional performance evidence for one authorized Employee. Use when: Use after search, list, or analytics when one Employee needs contextual or performance detail; set includeEvidence=false only for lightweight profile metadata. Returns: profile, position, company, manager, tags and compensation-access metadata, plus optional Team Pulse, Glow Moments, exit, and work evidence. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "employeeId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "includeEvidence": { "default": true, "description": "Include the authorized evidence view. Set false only when profile metadata is sufficient.", "type": "boolean" } }, "required": [ "employeeId" ], "type": "object" }, "name": "jointl_employees_get", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "evidence": { "additionalProperties": true, "type": [ "object", "null" ] }, "evidenceIncluded": { "type": "boolean" }, "profile": { "additionalProperties": true, "type": "object" } }, "required": [ "profile", "evidenceIncluded", "evidence" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "Get one Employee" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "List company-scoped Talent Pool profiles. Profiles without an authorized company match are not returned. Use when: Use to browse and filter the authorized Talent Pool and obtain profile IDs; use talents.get for one profile. Returns: a cursor-paginated list of scoped Talent Pool summaries, statuses, experience and evidence metrics allowed by the role. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "cursor": { "additionalProperties": false, "properties": { "createdAt": { "anyOf": [ { "format": "date-time", "type": "string" }, { "format": "date-time", "type": "string" } ] }, "id": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "linkedInVerifiedReferences": { "type": "number" }, "referencesCompleted": { "type": "number" }, "referenceScore": { "type": "number" }, "sourceRank": { "enum": [ 0, 1 ], "type": "number" } }, "required": [ "sourceRank", "createdAt", "id" ], "type": "object" }, "limit": { "default": 100, "maximum": 200, "minimum": 1, "type": "integer" }, "selectedAttributes": { "default": [], "description": "Exact extracted attribute values.", "items": { "maxLength": 180, "minLength": 1, "type": "string" }, "maxItems": 100, "type": "array" }, "selectedCompanies": { "default": [], "description": "Exact extracted company-name values; these are labels, not Jointl company IDs.", "items": { "maxLength": 180, "minLength": 1, "type": "string" }, "maxItems": 100, "type": "array" }, "selectedExperience": { "default": [], "description": "Experience-range IDs: 0-2, 3-5, 6-9, or 10-plus.", "items": { "enum": [ "0-2", "3-5", "6-9", "10-plus" ], "type": "string" }, "maxItems": 4, "type": "array" }, "selectedIndustries": { "default": [], "description": "Exact extracted industry values.", "items": { "maxLength": 180, "minLength": 1, "type": "string" }, "maxItems": 100, "type": "array" }, "selectedRoles": { "default": [], "description": "Exact extracted current or prior job-title values.", "items": { "maxLength": 180, "minLength": 1, "type": "string" }, "maxItems": 100, "type": "array" }, "selectedTalentStatus": { "default": [], "items": { "enum": [ "new", "archived", "shortlisted" ], "type": "string" }, "maxItems": 100, "type": "array" } }, "type": "object" }, "name": "jointl_talents_list", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "hasMore": { "type": "boolean" }, "items": { "items": { "additionalProperties": true, "properties": { "_id": { "type": "string" }, "firstName": { "type": [ "string", "null" ] }, "lastName": { "type": [ "string", "null" ] }, "status": { "type": [ "string", "null" ] } }, "type": "object" }, "type": "array" }, "nextCursor": { "additionalProperties": true, "type": [ "object", "null" ] } }, "required": [ "items", "hasMore", "nextCursor" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "List Talent Pool profiles" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Return the profile and optional evidence overview for one company-scoped Talent Pool person. Use when: Use after search or talents.list for one profile; use talents.references.list only when itemized reference responses are specifically needed and permitted. Returns: profile, contact and extracted experience data, plus optional achievements, work, notes, answer signals and cross-verified attributes. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "includeEvidence": { "default": true, "description": "Include the authorized evidence view. Set false only when profile metadata is sufficient.", "type": "boolean" }, "talentId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "talentId" ], "type": "object" }, "name": "jointl_talents_get", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "evidence": { "additionalProperties": true, "type": [ "object", "null" ] }, "evidenceIncluded": { "type": "boolean" }, "profile": { "additionalProperties": true, "type": "object" } }, "required": [ "profile", "evidenceIncluded", "evidence" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "Get one Talent Pool profile" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Return reference responses only when both Talent Pool and response permissions allow it. Use when: Use only for itemized authorized reference responses on one Talent Pool profile; talents.get is the normal profile and evidence path. Returns: normalized reference responses and average reference metrics, with third-party identities masked when required. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "talentId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "talentId" ], "type": "object" }, "name": "jointl_talents_references_list", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "avgMetrics": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, "references": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" } }, "required": [ "references", "avgMetrics" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "List Talent Pool reference responses" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "List Autopilot groups available through the member’s current permissions and Flow or company access. Shareable access links are omitted from list results. Use when: Use to find an Autopilot group, inspect status and Check counts, or obtain a group ID; use autopilots.get only when its public links are needed. Returns: a cursor-paginated list of visible Autopilot summaries without shareable access links. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "cursor": { "additionalProperties": false, "properties": { "createdAt": { "anyOf": [ { "format": "date-time", "type": "string" }, { "format": "date-time", "type": "string" } ] }, "groupId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "createdAt", "groupId" ], "type": "object" }, "includeArchived": { "default": false, "description": "Include archived Autopilots as well as active Autopilots.", "type": "boolean" }, "limit": { "default": 100, "maximum": 200, "minimum": 1, "type": "integer" } }, "type": "object" }, "name": "jointl_autopilots_list", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "hasMore": { "type": "boolean" }, "items": { "items": { "additionalProperties": true, "properties": { "_id": { "type": "string" }, "checksTotal": { "type": "number" }, "flowId": { "type": "string" }, "status": { "type": "string" }, "title": { "type": "string" } }, "type": "object" }, "type": "array" }, "nextCursor": { "additionalProperties": true, "type": [ "object", "null" ] } }, "required": [ "items", "hasMore", "nextCursor" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "List Autopilots" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Return one visible Autopilot and its reusable public access links. Anyone holding an active link can start the attached Flow. Use when: Use only when the user needs to inspect one known Autopilot or retrieve its links for an intended audience; do not expose links from a broad list. Returns: Autopilot status, Flow context, Check count, enabled sections, public links, and a sharing warning. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "autopilotGroupId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "autopilotGroupId" ], "type": "object" }, "name": "jointl_autopilots_get", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "autopilotGroupId": { "type": "string" }, "capabilityWarning": { "type": "string" }, "checksTotal": { "type": "number" }, "createdAt": { "type": "string" }, "flowId": { "type": "string" }, "publicLinks": { "items": { "type": "string" }, "type": "array" }, "status": { "type": "string" }, "title": { "type": "string" } }, "required": [ "autopilotGroupId", "flowId", "title", "status", "createdAt", "checksTotal", "publicLinks", "capabilityWarning" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "Get Autopilot and public links" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Return the General, Performance, or Exit Intelligence view available to the member for an inclusive UTC date range, using the same calculations shown in Jointl. Use when: Use for workspace activity and completion metrics, team performance evidence, or Exit Intelligence themes; select one view and supply both dates when the user specifies a period. Returns: the selected Insights dataset plus the applied view, inclusive UTC dates, and company, Flow, and role filters. Operation errors set isError to true and return a stable error code with a developer-facing message.", "inputSchema": { "additionalProperties": false, "properties": { "endDate": { "description": "Inclusive UTC end date in YYYY-MM-DD. Omit both dates for the trailing six-month default.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "selectedCompanies": { "default": [], "description": "Exact authorized Jointl company IDs; empty means every authorized company.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 100, "type": "array" }, "selectedFlows": { "default": [], "description": "Exact authorized Flow IDs; empty means every authorized Flow for this view.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 100, "type": "array" }, "selectedRoles": { "default": [], "description": "Exact Employee role-title labels; empty means every authorized role.", "items": { "maxLength": 180, "minLength": 1, "type": "string" }, "maxItems": 100, "type": "array" }, "startDate": { "description": "Inclusive UTC start date in YYYY-MM-DD. Omit both dates for the trailing six-month default.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "view": { "default": "general", "description": "general maps to /insights, performance to /insights?view=performance, and exitIntelligence to /insights?view=exit-intelligence.", "enum": [ "general", "performance", "exitIntelligence" ], "type": "string" } }, "type": "object" }, "name": "jointl_insights_get", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "data": { "additionalProperties": true, "type": "object" }, "dateRange": { "additionalProperties": true, "properties": { "endDate": { "type": "string" }, "inclusive": { "type": "boolean" }, "startDate": { "type": "string" }, "timeZone": { "type": "string" } }, "required": [ "startDate", "endDate", "inclusive", "timeZone" ], "type": "object" }, "filters": { "additionalProperties": true, "properties": { "companyIds": { "items": { "type": "string" }, "type": "array" }, "flowIds": { "items": { "type": "string" }, "type": "array" }, "roleTitles": { "items": { "type": "string" }, "type": "array" } }, "required": [ "companyIds", "flowIds", "roleTitles" ], "type": "object" }, "view": { "type": "string" } }, "required": [ "view", "dateRange", "filters", "data" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.read" ], "type": "oauth2" } ], "title": "Get Jointl Insights" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare a manual Glow Moments cycle for every configured participant in one active Performance Flow. This queues private requests and messages, so explicit confirmation is required. Use when: Use only when the user explicitly asks to send Glow Moments now; publishing alone follows the configured cadence and is not a manual-send request. Returns: after confirmation, whether the Glow Moments send was queued and its scheduled time. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "expectedFlowStatus": { "const": "ACTIVE", "default": "ACTIVE", "description": "The Flow must still be ACTIVE when the confirmed send executes.", "type": "string" }, "flowId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "flowId" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_glow_moments_send_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare Glow Moments send" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare cancellation or restoration of one exact Glow Moments cycle using its current status for concurrency safety. Explicit confirmation is required. Use when: Use only after performance.operations.get when the user explicitly asks to cancel or restore that exact Glow Moments cycle. Returns: after confirmation, the cycle ID, Flow ID, previous status, resulting status, enabled state, and change flag. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "cycleId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "enabled": { "description": "False cancels pending delivery and incomplete requests; true restores the cycle where possible.", "type": "boolean" }, "expectedStatus": { "description": "Current Glow Moments cycle status read from performance.operations.get.", "enum": [ "SCHEDULED", "SENT", "CANCELLED" ], "type": "string" } }, "required": [ "cycleId", "expectedStatus", "enabled" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_glow_moments_cycle_status_set_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare Glow Moments cycle status change" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare a manual Team Pulse cycle using the configured form for every participant in one active Performance Flow. This queues private requests and messages, so explicit confirmation is required. Use when: Use only when the user explicitly asks to send Team Pulse now; publishing alone follows the configured cadence and is not a manual-send request. Returns: after confirmation, whether the Team Pulse send was queued and its scheduled time. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "expectedFlowStatus": { "const": "ACTIVE", "default": "ACTIVE", "description": "The Flow must still be ACTIVE when the confirmed send executes.", "type": "string" }, "flowId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "flowId" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_team_pulse_send_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare Team Pulse send" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare cancellation or restoration of one exact Team Pulse cycle using its current status for concurrency safety. Explicit confirmation is required. Use when: Use only after performance.operations.get when the user explicitly asks to cancel or restore that exact Team Pulse cycle. Returns: after confirmation, the cycle ID, Flow ID, previous status, resulting status, enabled state, and change flag. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "cycleId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "enabled": { "description": "False cancels pending delivery and incomplete requests; true restores the cycle where possible.", "type": "boolean" }, "expectedStatus": { "description": "Current Team Pulse cycle status read from performance.operations.get.", "enum": [ "SCHEDULED", "PROCESSING", "SENT", "CANCELLED", "FAILED" ], "type": "string" } }, "required": [ "cycleId", "expectedStatus", "enabled" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_team_pulse_cycle_status_set_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare Team Pulse cycle status change" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare a complete, unpublished Flow draft using visible library templates and optional original question blocks. Hiring drafts enable Public Profiles and, when available for the workspace, Talent Pool by default. No invitations, publishing, team sharing, third-party automation, or automatic candidate decisions occur. Explicit confirmation is required. Use when: Use after capabilities, companies, and relevant question/template discovery have produced a complete supported design and the user wants it saved as a new draft. Returns: after confirmation, the created draft Flow ID, revision, and saved design summary. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "design": { "additionalProperties": false, "properties": { "authoredTemplates": { "additionalProperties": false, "default": {}, "description": "Original template/question blocks to create with this draft. Every evaluative multiple-choice question uses explicit non-flat option scores; Tests may also use native scale scoring. Open text is qualitative context without an attribute; unsupported types and automation are rejected.", "properties": { "assessmentQuestions": { "default": [], "items": { "additionalProperties": false, "properties": { "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "confetti": { "default": true, "type": "boolean" }, "conversationMode": { "default": true, "type": "boolean" }, "questions": { "items": { "additionalProperties": false, "properties": { "aiFollowUpEnabled": { "default": false, "description": "Enable only for a critical open-text question where a vague or incomplete answer needs an adaptive follow-up.", "type": "boolean" }, "attribute": { "description": "One exact numeric evidence attribute from design.matchingScoreAttributes. Omit for open-text narratives and all other non-scored questions.", "maxLength": 120, "minLength": 1, "type": "string" }, "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "evidenceRole": { "default": "evaluative", "description": "Evaluative means the question produces a numeric Matching Score input and requires an attribute. Use context for qualitative narratives, logistics, consent, relationship context, or any other unscored prompt.", "enum": [ "evaluative", "context" ], "type": "string" }, "insightsExtraction": { "description": "Enable for substantive Reference, Exit Intelligence, or Team Pulse narratives. Structured reference types default to enabled except employmentCheck.", "type": "boolean" }, "maxAnswers": { "default": 1, "description": "Maximum options a respondent may select. Use 1 for single-answer multiple choice; when the prompt states a limit such as “choose up to three”, set this to that exact limit.", "maximum": 20, "minimum": 1, "type": "integer" }, "options": { "items": { "anyOf": [ { "maxLength": 200, "minLength": 1, "type": "string" }, { "additionalProperties": false, "properties": { "score": { "description": "Non-negative numeric score for this answer. Required on every option of an evaluative multiple-choice question, with at least two distinct scores.", "maximum": 100, "minimum": 0, "type": "number" }, "title": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "title" ], "type": "object" } ] }, "maxItems": 20, "minItems": 2, "type": "array" }, "prompt": { "maxLength": 1500, "minLength": 1, "type": "string" }, "scoringPoints": { "description": "Optional start/end score mapping for an authored Test scale; reverse order enables reverse scoring.", "items": { "maximum": 100, "minimum": -100, "type": "number" }, "maxItems": 2, "minItems": 2, "type": "array" }, "type": { "description": "Question type. Reference forms also support the structured single-use types strengths, keyAchievements, weaknesses, reasonsForLeavingJob, and employmentCheck.", "enum": [ "shortText", "longText", "multipleChoice", "opinionScale", "rating", "precisionScale", "strengths", "keyAchievements", "weaknesses", "reasonsForLeavingJob", "employmentCheck" ], "type": "string" } }, "required": [ "clientRef", "type", "prompt" ], "type": "object" }, "maxItems": 50, "minItems": 1, "type": "array" }, "thankYouScreen": { "additionalProperties": false, "description": "Optional form-specific completion copy; omit when the native template default fits.", "properties": { "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" }, "title": { "maxLength": 120, "minLength": 1, "type": "string" }, "welcomeScreen": { "additionalProperties": false, "description": "Optional form-specific welcome copy; omit when the native template default fits.", "properties": { "button": { "default": "Begin", "maxLength": 80, "minLength": 1, "type": "string" }, "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" } }, "required": [ "clientRef", "title", "questions" ], "type": "object" }, "maxItems": 10, "type": "array" }, "assessmentTests": { "default": [], "items": { "additionalProperties": false, "properties": { "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "confetti": { "default": true, "type": "boolean" }, "conversationMode": { "default": true, "type": "boolean" }, "questions": { "items": { "additionalProperties": false, "properties": { "aiFollowUpEnabled": { "default": false, "description": "Enable only for a critical open-text question where a vague or incomplete answer needs an adaptive follow-up.", "type": "boolean" }, "attribute": { "description": "One exact numeric evidence attribute from design.matchingScoreAttributes. Omit for open-text narratives and all other non-scored questions.", "maxLength": 120, "minLength": 1, "type": "string" }, "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "evidenceRole": { "default": "evaluative", "description": "Evaluative means the question produces a numeric Matching Score input and requires an attribute. Use context for qualitative narratives, logistics, consent, relationship context, or any other unscored prompt.", "enum": [ "evaluative", "context" ], "type": "string" }, "insightsExtraction": { "description": "Enable for substantive Reference, Exit Intelligence, or Team Pulse narratives. Structured reference types default to enabled except employmentCheck.", "type": "boolean" }, "maxAnswers": { "default": 1, "description": "Maximum options a respondent may select. Use 1 for single-answer multiple choice; when the prompt states a limit such as “choose up to three”, set this to that exact limit.", "maximum": 20, "minimum": 1, "type": "integer" }, "options": { "items": { "anyOf": [ { "maxLength": 200, "minLength": 1, "type": "string" }, { "additionalProperties": false, "properties": { "score": { "description": "Non-negative numeric score for this answer. Required on every option of an evaluative multiple-choice question, with at least two distinct scores.", "maximum": 100, "minimum": 0, "type": "number" }, "title": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "title" ], "type": "object" } ] }, "maxItems": 20, "minItems": 2, "type": "array" }, "prompt": { "maxLength": 1500, "minLength": 1, "type": "string" }, "scoringPoints": { "description": "Optional start/end score mapping for an authored Test scale; reverse order enables reverse scoring.", "items": { "maximum": 100, "minimum": -100, "type": "number" }, "maxItems": 2, "minItems": 2, "type": "array" }, "type": { "description": "Question type. Reference forms also support the structured single-use types strengths, keyAchievements, weaknesses, reasonsForLeavingJob, and employmentCheck.", "enum": [ "shortText", "longText", "multipleChoice", "opinionScale", "rating", "precisionScale", "strengths", "keyAchievements", "weaknesses", "reasonsForLeavingJob", "employmentCheck" ], "type": "string" } }, "required": [ "clientRef", "type", "prompt" ], "type": "object" }, "maxItems": 50, "minItems": 1, "type": "array" }, "thankYouScreen": { "additionalProperties": false, "description": "Optional form-specific completion copy; omit when the native template default fits.", "properties": { "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" }, "title": { "maxLength": 120, "minLength": 1, "type": "string" }, "welcomeScreen": { "additionalProperties": false, "description": "Optional form-specific welcome copy; omit when the native template default fits.", "properties": { "button": { "default": "Begin", "maxLength": 80, "minLength": 1, "type": "string" }, "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" } }, "required": [ "clientRef", "title", "questions" ], "type": "object" }, "maxItems": 10, "type": "array" }, "exitIntelligence": { "default": [], "items": { "additionalProperties": false, "properties": { "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "confetti": { "default": true, "type": "boolean" }, "conversationMode": { "default": true, "type": "boolean" }, "questions": { "items": { "additionalProperties": false, "properties": { "aiFollowUpEnabled": { "default": false, "description": "Enable only for a critical open-text question where a vague or incomplete answer needs an adaptive follow-up.", "type": "boolean" }, "attribute": { "description": "One exact numeric evidence attribute from design.matchingScoreAttributes. Omit for open-text narratives and all other non-scored questions.", "maxLength": 120, "minLength": 1, "type": "string" }, "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "evidenceRole": { "default": "evaluative", "description": "Evaluative means the question produces a numeric Matching Score input and requires an attribute. Use context for qualitative narratives, logistics, consent, relationship context, or any other unscored prompt.", "enum": [ "evaluative", "context" ], "type": "string" }, "insightsExtraction": { "description": "Enable for substantive Reference, Exit Intelligence, or Team Pulse narratives. Structured reference types default to enabled except employmentCheck.", "type": "boolean" }, "maxAnswers": { "default": 1, "description": "Maximum options a respondent may select. Use 1 for single-answer multiple choice; when the prompt states a limit such as “choose up to three”, set this to that exact limit.", "maximum": 20, "minimum": 1, "type": "integer" }, "options": { "items": { "anyOf": [ { "maxLength": 200, "minLength": 1, "type": "string" }, { "additionalProperties": false, "properties": { "score": { "description": "Non-negative numeric score for this answer. Required on every option of an evaluative multiple-choice question, with at least two distinct scores.", "maximum": 100, "minimum": 0, "type": "number" }, "title": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "title" ], "type": "object" } ] }, "maxItems": 20, "minItems": 2, "type": "array" }, "prompt": { "maxLength": 1500, "minLength": 1, "type": "string" }, "scoringPoints": { "description": "Optional start/end score mapping for an authored Test scale; reverse order enables reverse scoring.", "items": { "maximum": 100, "minimum": -100, "type": "number" }, "maxItems": 2, "minItems": 2, "type": "array" }, "type": { "description": "Question type. Reference forms also support the structured single-use types strengths, keyAchievements, weaknesses, reasonsForLeavingJob, and employmentCheck.", "enum": [ "shortText", "longText", "multipleChoice", "opinionScale", "rating", "precisionScale", "strengths", "keyAchievements", "weaknesses", "reasonsForLeavingJob", "employmentCheck" ], "type": "string" } }, "required": [ "clientRef", "type", "prompt" ], "type": "object" }, "maxItems": 50, "minItems": 1, "type": "array" }, "thankYouScreen": { "additionalProperties": false, "description": "Optional form-specific completion copy; omit when the native template default fits.", "properties": { "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" }, "title": { "maxLength": 120, "minLength": 1, "type": "string" }, "welcomeScreen": { "additionalProperties": false, "description": "Optional form-specific welcome copy; omit when the native template default fits.", "properties": { "button": { "default": "Begin", "maxLength": 80, "minLength": 1, "type": "string" }, "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" } }, "required": [ "clientRef", "title", "questions" ], "type": "object" }, "maxItems": 10, "type": "array" }, "preScreening": { "default": [], "items": { "additionalProperties": false, "properties": { "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "confetti": { "default": true, "type": "boolean" }, "conversationMode": { "default": true, "type": "boolean" }, "questions": { "items": { "additionalProperties": false, "properties": { "aiFollowUpEnabled": { "default": false, "description": "Enable only for a critical open-text question where a vague or incomplete answer needs an adaptive follow-up.", "type": "boolean" }, "attribute": { "description": "One exact numeric evidence attribute from design.matchingScoreAttributes. Omit for open-text narratives and all other non-scored questions.", "maxLength": 120, "minLength": 1, "type": "string" }, "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "evidenceRole": { "default": "evaluative", "description": "Evaluative means the question produces a numeric Matching Score input and requires an attribute. Use context for qualitative narratives, logistics, consent, relationship context, or any other unscored prompt.", "enum": [ "evaluative", "context" ], "type": "string" }, "insightsExtraction": { "description": "Enable for substantive Reference, Exit Intelligence, or Team Pulse narratives. Structured reference types default to enabled except employmentCheck.", "type": "boolean" }, "maxAnswers": { "default": 1, "description": "Maximum options a respondent may select. Use 1 for single-answer multiple choice; when the prompt states a limit such as “choose up to three”, set this to that exact limit.", "maximum": 20, "minimum": 1, "type": "integer" }, "options": { "items": { "anyOf": [ { "maxLength": 200, "minLength": 1, "type": "string" }, { "additionalProperties": false, "properties": { "score": { "description": "Non-negative numeric score for this answer. Required on every option of an evaluative multiple-choice question, with at least two distinct scores.", "maximum": 100, "minimum": 0, "type": "number" }, "title": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "title" ], "type": "object" } ] }, "maxItems": 20, "minItems": 2, "type": "array" }, "prompt": { "maxLength": 1500, "minLength": 1, "type": "string" }, "scoringPoints": { "description": "Optional start/end score mapping for an authored Test scale; reverse order enables reverse scoring.", "items": { "maximum": 100, "minimum": -100, "type": "number" }, "maxItems": 2, "minItems": 2, "type": "array" }, "type": { "description": "Question type. Reference forms also support the structured single-use types strengths, keyAchievements, weaknesses, reasonsForLeavingJob, and employmentCheck.", "enum": [ "shortText", "longText", "multipleChoice", "opinionScale", "rating", "precisionScale", "strengths", "keyAchievements", "weaknesses", "reasonsForLeavingJob", "employmentCheck" ], "type": "string" } }, "required": [ "clientRef", "type", "prompt" ], "type": "object" }, "maxItems": 50, "minItems": 1, "type": "array" }, "thankYouScreen": { "additionalProperties": false, "description": "Optional form-specific completion copy; omit when the native template default fits.", "properties": { "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" }, "title": { "maxLength": 120, "minLength": 1, "type": "string" }, "welcomeScreen": { "additionalProperties": false, "description": "Optional form-specific welcome copy; omit when the native template default fits.", "properties": { "button": { "default": "Begin", "maxLength": 80, "minLength": 1, "type": "string" }, "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" } }, "required": [ "clientRef", "title", "questions" ], "type": "object" }, "maxItems": 10, "type": "array" }, "references": { "default": [], "items": { "additionalProperties": false, "properties": { "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "confetti": { "default": true, "type": "boolean" }, "conversationMode": { "default": true, "type": "boolean" }, "questions": { "items": { "additionalProperties": false, "properties": { "aiFollowUpEnabled": { "default": false, "description": "Enable only for a critical open-text question where a vague or incomplete answer needs an adaptive follow-up.", "type": "boolean" }, "attribute": { "description": "One exact numeric evidence attribute from design.matchingScoreAttributes. Omit for open-text narratives and all other non-scored questions.", "maxLength": 120, "minLength": 1, "type": "string" }, "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "evidenceRole": { "default": "evaluative", "description": "Evaluative means the question produces a numeric Matching Score input and requires an attribute. Use context for qualitative narratives, logistics, consent, relationship context, or any other unscored prompt.", "enum": [ "evaluative", "context" ], "type": "string" }, "insightsExtraction": { "description": "Enable for substantive Reference, Exit Intelligence, or Team Pulse narratives. Structured reference types default to enabled except employmentCheck.", "type": "boolean" }, "maxAnswers": { "default": 1, "description": "Maximum options a respondent may select. Use 1 for single-answer multiple choice; when the prompt states a limit such as “choose up to three”, set this to that exact limit.", "maximum": 20, "minimum": 1, "type": "integer" }, "options": { "items": { "anyOf": [ { "maxLength": 200, "minLength": 1, "type": "string" }, { "additionalProperties": false, "properties": { "score": { "description": "Non-negative numeric score for this answer. Required on every option of an evaluative multiple-choice question, with at least two distinct scores.", "maximum": 100, "minimum": 0, "type": "number" }, "title": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "title" ], "type": "object" } ] }, "maxItems": 20, "minItems": 2, "type": "array" }, "prompt": { "maxLength": 1500, "minLength": 1, "type": "string" }, "scoringPoints": { "description": "Optional start/end score mapping for an authored Test scale; reverse order enables reverse scoring.", "items": { "maximum": 100, "minimum": -100, "type": "number" }, "maxItems": 2, "minItems": 2, "type": "array" }, "type": { "description": "Question type. Reference forms also support the structured single-use types strengths, keyAchievements, weaknesses, reasonsForLeavingJob, and employmentCheck.", "enum": [ "shortText", "longText", "multipleChoice", "opinionScale", "rating", "precisionScale", "strengths", "keyAchievements", "weaknesses", "reasonsForLeavingJob", "employmentCheck" ], "type": "string" } }, "required": [ "clientRef", "type", "prompt" ], "type": "object" }, "maxItems": 50, "minItems": 1, "type": "array" }, "thankYouScreen": { "additionalProperties": false, "description": "Optional form-specific completion copy; omit when the native template default fits.", "properties": { "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" }, "title": { "maxLength": 120, "minLength": 1, "type": "string" }, "welcomeScreen": { "additionalProperties": false, "description": "Optional form-specific welcome copy; omit when the native template default fits.", "properties": { "button": { "default": "Begin", "maxLength": 80, "minLength": 1, "type": "string" }, "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" } }, "required": [ "clientRef", "title", "questions" ], "type": "object" }, "maxItems": 10, "type": "array" }, "teamPulse": { "default": [], "items": { "additionalProperties": false, "properties": { "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "confetti": { "default": true, "type": "boolean" }, "conversationMode": { "default": true, "type": "boolean" }, "questions": { "items": { "additionalProperties": false, "properties": { "aiFollowUpEnabled": { "default": false, "description": "Enable only for a critical open-text question where a vague or incomplete answer needs an adaptive follow-up.", "type": "boolean" }, "attribute": { "description": "One exact numeric evidence attribute from design.matchingScoreAttributes. Omit for open-text narratives and all other non-scored questions.", "maxLength": 120, "minLength": 1, "type": "string" }, "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "evidenceRole": { "default": "evaluative", "description": "Evaluative means the question produces a numeric Matching Score input and requires an attribute. Use context for qualitative narratives, logistics, consent, relationship context, or any other unscored prompt.", "enum": [ "evaluative", "context" ], "type": "string" }, "insightsExtraction": { "description": "Enable for substantive Reference, Exit Intelligence, or Team Pulse narratives. Structured reference types default to enabled except employmentCheck.", "type": "boolean" }, "maxAnswers": { "default": 1, "description": "Maximum options a respondent may select. Use 1 for single-answer multiple choice; when the prompt states a limit such as “choose up to three”, set this to that exact limit.", "maximum": 20, "minimum": 1, "type": "integer" }, "options": { "items": { "anyOf": [ { "maxLength": 200, "minLength": 1, "type": "string" }, { "additionalProperties": false, "properties": { "score": { "description": "Non-negative numeric score for this answer. Required on every option of an evaluative multiple-choice question, with at least two distinct scores.", "maximum": 100, "minimum": 0, "type": "number" }, "title": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "title" ], "type": "object" } ] }, "maxItems": 20, "minItems": 2, "type": "array" }, "prompt": { "maxLength": 1500, "minLength": 1, "type": "string" }, "scoringPoints": { "description": "Optional start/end score mapping for an authored Test scale; reverse order enables reverse scoring.", "items": { "maximum": 100, "minimum": -100, "type": "number" }, "maxItems": 2, "minItems": 2, "type": "array" }, "type": { "description": "Question type. Reference forms also support the structured single-use types strengths, keyAchievements, weaknesses, reasonsForLeavingJob, and employmentCheck.", "enum": [ "shortText", "longText", "multipleChoice", "opinionScale", "rating", "precisionScale", "strengths", "keyAchievements", "weaknesses", "reasonsForLeavingJob", "employmentCheck" ], "type": "string" } }, "required": [ "clientRef", "type", "prompt" ], "type": "object" }, "maxItems": 50, "minItems": 1, "type": "array" }, "thankYouScreen": { "additionalProperties": false, "description": "Optional form-specific completion copy; omit when the native template default fits.", "properties": { "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" }, "title": { "maxLength": 120, "minLength": 1, "type": "string" }, "welcomeScreen": { "additionalProperties": false, "description": "Optional form-specific welcome copy; omit when the native template default fits.", "properties": { "button": { "default": "Begin", "maxLength": 80, "minLength": 1, "type": "string" }, "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" } }, "required": [ "clientRef", "title", "questions" ], "type": "object" }, "maxItems": 10, "type": "array" } }, "type": "object" }, "clearCopyOverrideFields": { "default": [], "description": "On a draft revision, reset only these existing copy overrides to Jointl defaults.", "items": { "enum": [ "welcomeScreen", "referenceCheckingCandidateScreen", "thankYouScreen", "welcomeEmail", "reminderWelcomeEmail", "emailRequestToReferee", "reminderEmailRequestToReferee", "thankYouEmail", "teamPulseEmailRequestToEmployee", "teamPulseReminderEmailRequestToEmployee" ], "type": "string" }, "maxItems": 10, "type": "array" }, "companyId": { "description": "Exact companies.list ID. Required for HIRING_REVIEW and must be within the member's current company access.", "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "copyOverrides": { "additionalProperties": false, "default": {}, "description": "Override only copy whose native Jointl default materially conflicts with this Flow; omit ordinary defaults.", "properties": { "emailRequestToReferee": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" }, "referenceCheckingCandidateScreen": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" }, "reminderEmailRequestToReferee": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" }, "reminderWelcomeEmail": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" }, "teamPulseEmailRequestToEmployee": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" }, "teamPulseReminderEmailRequestToEmployee": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" }, "thankYouEmail": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" }, "thankYouScreen": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" }, "welcomeEmail": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" }, "welcomeScreen": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "type": "object" }, "jobTitle": { "description": "Job title assessed by a HIRING_REVIEW Flow; required for that type.", "maxLength": 80, "minLength": 1, "type": "string" }, "matchingScoreAttributes": { "default": [], "description": "Up to 15 job-related attributes used by Jointl Matching Score, deliberately ordered from highest to lowest importance. With N attributes, Jointl applies linear weights N through 1 in this exact order. Every Hiring Review attribute must have at least one selected or authored question with valid numeric scoring.", "items": { "maxLength": 120, "minLength": 1, "type": "string" }, "maxItems": 15, "type": "array" }, "performance": { "additionalProperties": false, "description": "Required complete participant and cadence configuration for PERFORMANCE Flows; omit for other types.", "properties": { "employeeIds": { "description": "Exact visible Employee IDs who participate in enabled Glow Moments and Team Pulse cycles.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 250, "type": "array" }, "glowMoments": { "additionalProperties": false, "properties": { "cadence": { "additionalProperties": false, "properties": { "firstSendAt": { "anyOf": [ { "format": "date-time", "type": "string" }, { "format": "date-time", "type": "string" } ], "description": "ISO 8601 date-time for the first Glow Moments send." }, "interval": { "enum": [ "MONTHLY", "QUARTERLY" ], "type": "string" }, "mode": { "enum": [ "ONE_TIME", "RECURRING" ], "type": "string" }, "repeatUntil": { "anyOf": [ { "format": "date-time", "type": "string" }, { "format": "date-time", "type": "string" } ], "description": "Optional inclusive end date-time for a recurring cadence." } }, "required": [ "mode", "firstSendAt" ], "type": "object" }, "enabled": { "type": "boolean" } }, "required": [ "enabled" ], "type": "object" }, "teamPulse": { "additionalProperties": false, "properties": { "cadence": { "additionalProperties": false, "properties": { "firstSendAt": { "anyOf": [ { "format": "date-time", "type": "string" }, { "format": "date-time", "type": "string" } ], "description": "ISO 8601 date-time for the first Team Pulse send." }, "interval": { "enum": [ "MONTHLY", "QUARTERLY", "SEMI_ANNUAL" ], "type": "string" }, "mode": { "enum": [ "ONE_TIME", "RECURRING" ], "type": "string" }, "repeatUntil": { "anyOf": [ { "format": "date-time", "type": "string" }, { "format": "date-time", "type": "string" } ], "description": "Optional inclusive end date-time for a recurring cadence." } }, "required": [ "mode", "firstSendAt" ], "type": "object" }, "enabled": { "type": "boolean" } }, "required": [ "enabled" ], "type": "object" } }, "required": [ "employeeIds", "glowMoments", "teamPulse" ], "type": "object" }, "referenceCollection": { "additionalProperties": false, "description": "Hiring Review reference collection mode and thresholds; omit for other Flow types.", "properties": { "method": { "default": "AUTO", "enum": [ "AUTO", "MANUAL" ], "type": "string" }, "minReferenceCount": { "default": 3, "maximum": 10, "minimum": 1, "type": "integer" }, "minReferenceGap": { "default": 1, "maximum": 10, "minimum": 0, "type": "integer" } }, "type": "object" }, "tagIds": { "default": [], "description": "Existing Jointl tag IDs to attach.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 40, "type": "array" }, "templateIds": { "additionalProperties": false, "default": {}, "description": "Existing visible templates selected by category.", "properties": { "assessmentQuestions": { "default": [], "description": "Existing assessment-question template IDs.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 40, "type": "array" }, "assessmentTests": { "default": [], "description": "Existing visible Test template IDs. Search Private and Public Test Libraries before authoring a new Test.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 40, "type": "array" }, "exitIntelligence": { "default": [], "description": "Existing Exit Intelligence template IDs.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 40, "type": "array" }, "preScreening": { "default": [], "description": "Existing pre-screening template IDs.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 40, "type": "array" }, "references": { "default": [], "description": "Existing reference template IDs.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 40, "type": "array" }, "teamPulse": { "default": [], "description": "Existing Team Pulse template IDs.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 40, "type": "array" } }, "type": "object" }, "title": { "description": "Human-readable Flow title.", "maxLength": 80, "minLength": 1, "type": "string" }, "type": { "description": "Flow type. The allowed sections depend on this value.", "enum": [ "HIRING_REVIEW", "EXIT_INTELLIGENCE", "PERFORMANCE" ], "type": "string" } }, "required": [ "title", "type" ], "type": "object" } }, "required": [ "design" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_flows_draft_create_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare a new Flow draft" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare a replacement of supported sections in one unpublished Flow. The latest blueprint revision is required so concurrent edits are not overwritten. Publishing, team sharing, Public Profiles, Talent Pool, third-party automation, automatic candidate decisions, and messaging remain unchanged. Explicit confirmation is required. Use when: Use only after flows.blueprint.get when the user wants to replace supported sections of that still-unpublished draft. Returns: after confirmation, the revised draft Flow ID, new revision, and saved design summary. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "design": { "additionalProperties": false, "properties": { "authoredTemplates": { "additionalProperties": false, "default": {}, "description": "Original template/question blocks to create with this draft. Every evaluative multiple-choice question uses explicit non-flat option scores; Tests may also use native scale scoring. Open text is qualitative context without an attribute; unsupported types and automation are rejected.", "properties": { "assessmentQuestions": { "default": [], "items": { "additionalProperties": false, "properties": { "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "confetti": { "default": true, "type": "boolean" }, "conversationMode": { "default": true, "type": "boolean" }, "questions": { "items": { "additionalProperties": false, "properties": { "aiFollowUpEnabled": { "default": false, "description": "Enable only for a critical open-text question where a vague or incomplete answer needs an adaptive follow-up.", "type": "boolean" }, "attribute": { "description": "One exact numeric evidence attribute from design.matchingScoreAttributes. Omit for open-text narratives and all other non-scored questions.", "maxLength": 120, "minLength": 1, "type": "string" }, "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "evidenceRole": { "default": "evaluative", "description": "Evaluative means the question produces a numeric Matching Score input and requires an attribute. Use context for qualitative narratives, logistics, consent, relationship context, or any other unscored prompt.", "enum": [ "evaluative", "context" ], "type": "string" }, "insightsExtraction": { "description": "Enable for substantive Reference, Exit Intelligence, or Team Pulse narratives. Structured reference types default to enabled except employmentCheck.", "type": "boolean" }, "maxAnswers": { "default": 1, "description": "Maximum options a respondent may select. Use 1 for single-answer multiple choice; when the prompt states a limit such as “choose up to three”, set this to that exact limit.", "maximum": 20, "minimum": 1, "type": "integer" }, "options": { "items": { "anyOf": [ { "maxLength": 200, "minLength": 1, "type": "string" }, { "additionalProperties": false, "properties": { "score": { "description": "Non-negative numeric score for this answer. Required on every option of an evaluative multiple-choice question, with at least two distinct scores.", "maximum": 100, "minimum": 0, "type": "number" }, "title": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "title" ], "type": "object" } ] }, "maxItems": 20, "minItems": 2, "type": "array" }, "prompt": { "maxLength": 1500, "minLength": 1, "type": "string" }, "scoringPoints": { "description": "Optional start/end score mapping for an authored Test scale; reverse order enables reverse scoring.", "items": { "maximum": 100, "minimum": -100, "type": "number" }, "maxItems": 2, "minItems": 2, "type": "array" }, "type": { "description": "Question type. Reference forms also support the structured single-use types strengths, keyAchievements, weaknesses, reasonsForLeavingJob, and employmentCheck.", "enum": [ "shortText", "longText", "multipleChoice", "opinionScale", "rating", "precisionScale", "strengths", "keyAchievements", "weaknesses", "reasonsForLeavingJob", "employmentCheck" ], "type": "string" } }, "required": [ "clientRef", "type", "prompt" ], "type": "object" }, "maxItems": 50, "minItems": 1, "type": "array" }, "thankYouScreen": { "additionalProperties": false, "description": "Optional form-specific completion copy; omit when the native template default fits.", "properties": { "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" }, "title": { "maxLength": 120, "minLength": 1, "type": "string" }, "welcomeScreen": { "additionalProperties": false, "description": "Optional form-specific welcome copy; omit when the native template default fits.", "properties": { "button": { "default": "Begin", "maxLength": 80, "minLength": 1, "type": "string" }, "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" } }, "required": [ "clientRef", "title", "questions" ], "type": "object" }, "maxItems": 10, "type": "array" }, "assessmentTests": { "default": [], "items": { "additionalProperties": false, "properties": { "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "confetti": { "default": true, "type": "boolean" }, "conversationMode": { "default": true, "type": "boolean" }, "questions": { "items": { "additionalProperties": false, "properties": { "aiFollowUpEnabled": { "default": false, "description": "Enable only for a critical open-text question where a vague or incomplete answer needs an adaptive follow-up.", "type": "boolean" }, "attribute": { "description": "One exact numeric evidence attribute from design.matchingScoreAttributes. Omit for open-text narratives and all other non-scored questions.", "maxLength": 120, "minLength": 1, "type": "string" }, "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "evidenceRole": { "default": "evaluative", "description": "Evaluative means the question produces a numeric Matching Score input and requires an attribute. Use context for qualitative narratives, logistics, consent, relationship context, or any other unscored prompt.", "enum": [ "evaluative", "context" ], "type": "string" }, "insightsExtraction": { "description": "Enable for substantive Reference, Exit Intelligence, or Team Pulse narratives. Structured reference types default to enabled except employmentCheck.", "type": "boolean" }, "maxAnswers": { "default": 1, "description": "Maximum options a respondent may select. Use 1 for single-answer multiple choice; when the prompt states a limit such as “choose up to three”, set this to that exact limit.", "maximum": 20, "minimum": 1, "type": "integer" }, "options": { "items": { "anyOf": [ { "maxLength": 200, "minLength": 1, "type": "string" }, { "additionalProperties": false, "properties": { "score": { "description": "Non-negative numeric score for this answer. Required on every option of an evaluative multiple-choice question, with at least two distinct scores.", "maximum": 100, "minimum": 0, "type": "number" }, "title": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "title" ], "type": "object" } ] }, "maxItems": 20, "minItems": 2, "type": "array" }, "prompt": { "maxLength": 1500, "minLength": 1, "type": "string" }, "scoringPoints": { "description": "Optional start/end score mapping for an authored Test scale; reverse order enables reverse scoring.", "items": { "maximum": 100, "minimum": -100, "type": "number" }, "maxItems": 2, "minItems": 2, "type": "array" }, "type": { "description": "Question type. Reference forms also support the structured single-use types strengths, keyAchievements, weaknesses, reasonsForLeavingJob, and employmentCheck.", "enum": [ "shortText", "longText", "multipleChoice", "opinionScale", "rating", "precisionScale", "strengths", "keyAchievements", "weaknesses", "reasonsForLeavingJob", "employmentCheck" ], "type": "string" } }, "required": [ "clientRef", "type", "prompt" ], "type": "object" }, "maxItems": 50, "minItems": 1, "type": "array" }, "thankYouScreen": { "additionalProperties": false, "description": "Optional form-specific completion copy; omit when the native template default fits.", "properties": { "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" }, "title": { "maxLength": 120, "minLength": 1, "type": "string" }, "welcomeScreen": { "additionalProperties": false, "description": "Optional form-specific welcome copy; omit when the native template default fits.", "properties": { "button": { "default": "Begin", "maxLength": 80, "minLength": 1, "type": "string" }, "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" } }, "required": [ "clientRef", "title", "questions" ], "type": "object" }, "maxItems": 10, "type": "array" }, "exitIntelligence": { "default": [], "items": { "additionalProperties": false, "properties": { "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "confetti": { "default": true, "type": "boolean" }, "conversationMode": { "default": true, "type": "boolean" }, "questions": { "items": { "additionalProperties": false, "properties": { "aiFollowUpEnabled": { "default": false, "description": "Enable only for a critical open-text question where a vague or incomplete answer needs an adaptive follow-up.", "type": "boolean" }, "attribute": { "description": "One exact numeric evidence attribute from design.matchingScoreAttributes. Omit for open-text narratives and all other non-scored questions.", "maxLength": 120, "minLength": 1, "type": "string" }, "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "evidenceRole": { "default": "evaluative", "description": "Evaluative means the question produces a numeric Matching Score input and requires an attribute. Use context for qualitative narratives, logistics, consent, relationship context, or any other unscored prompt.", "enum": [ "evaluative", "context" ], "type": "string" }, "insightsExtraction": { "description": "Enable for substantive Reference, Exit Intelligence, or Team Pulse narratives. Structured reference types default to enabled except employmentCheck.", "type": "boolean" }, "maxAnswers": { "default": 1, "description": "Maximum options a respondent may select. Use 1 for single-answer multiple choice; when the prompt states a limit such as “choose up to three”, set this to that exact limit.", "maximum": 20, "minimum": 1, "type": "integer" }, "options": { "items": { "anyOf": [ { "maxLength": 200, "minLength": 1, "type": "string" }, { "additionalProperties": false, "properties": { "score": { "description": "Non-negative numeric score for this answer. Required on every option of an evaluative multiple-choice question, with at least two distinct scores.", "maximum": 100, "minimum": 0, "type": "number" }, "title": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "title" ], "type": "object" } ] }, "maxItems": 20, "minItems": 2, "type": "array" }, "prompt": { "maxLength": 1500, "minLength": 1, "type": "string" }, "scoringPoints": { "description": "Optional start/end score mapping for an authored Test scale; reverse order enables reverse scoring.", "items": { "maximum": 100, "minimum": -100, "type": "number" }, "maxItems": 2, "minItems": 2, "type": "array" }, "type": { "description": "Question type. Reference forms also support the structured single-use types strengths, keyAchievements, weaknesses, reasonsForLeavingJob, and employmentCheck.", "enum": [ "shortText", "longText", "multipleChoice", "opinionScale", "rating", "precisionScale", "strengths", "keyAchievements", "weaknesses", "reasonsForLeavingJob", "employmentCheck" ], "type": "string" } }, "required": [ "clientRef", "type", "prompt" ], "type": "object" }, "maxItems": 50, "minItems": 1, "type": "array" }, "thankYouScreen": { "additionalProperties": false, "description": "Optional form-specific completion copy; omit when the native template default fits.", "properties": { "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" }, "title": { "maxLength": 120, "minLength": 1, "type": "string" }, "welcomeScreen": { "additionalProperties": false, "description": "Optional form-specific welcome copy; omit when the native template default fits.", "properties": { "button": { "default": "Begin", "maxLength": 80, "minLength": 1, "type": "string" }, "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" } }, "required": [ "clientRef", "title", "questions" ], "type": "object" }, "maxItems": 10, "type": "array" }, "preScreening": { "default": [], "items": { "additionalProperties": false, "properties": { "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "confetti": { "default": true, "type": "boolean" }, "conversationMode": { "default": true, "type": "boolean" }, "questions": { "items": { "additionalProperties": false, "properties": { "aiFollowUpEnabled": { "default": false, "description": "Enable only for a critical open-text question where a vague or incomplete answer needs an adaptive follow-up.", "type": "boolean" }, "attribute": { "description": "One exact numeric evidence attribute from design.matchingScoreAttributes. Omit for open-text narratives and all other non-scored questions.", "maxLength": 120, "minLength": 1, "type": "string" }, "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "evidenceRole": { "default": "evaluative", "description": "Evaluative means the question produces a numeric Matching Score input and requires an attribute. Use context for qualitative narratives, logistics, consent, relationship context, or any other unscored prompt.", "enum": [ "evaluative", "context" ], "type": "string" }, "insightsExtraction": { "description": "Enable for substantive Reference, Exit Intelligence, or Team Pulse narratives. Structured reference types default to enabled except employmentCheck.", "type": "boolean" }, "maxAnswers": { "default": 1, "description": "Maximum options a respondent may select. Use 1 for single-answer multiple choice; when the prompt states a limit such as “choose up to three”, set this to that exact limit.", "maximum": 20, "minimum": 1, "type": "integer" }, "options": { "items": { "anyOf": [ { "maxLength": 200, "minLength": 1, "type": "string" }, { "additionalProperties": false, "properties": { "score": { "description": "Non-negative numeric score for this answer. Required on every option of an evaluative multiple-choice question, with at least two distinct scores.", "maximum": 100, "minimum": 0, "type": "number" }, "title": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "title" ], "type": "object" } ] }, "maxItems": 20, "minItems": 2, "type": "array" }, "prompt": { "maxLength": 1500, "minLength": 1, "type": "string" }, "scoringPoints": { "description": "Optional start/end score mapping for an authored Test scale; reverse order enables reverse scoring.", "items": { "maximum": 100, "minimum": -100, "type": "number" }, "maxItems": 2, "minItems": 2, "type": "array" }, "type": { "description": "Question type. Reference forms also support the structured single-use types strengths, keyAchievements, weaknesses, reasonsForLeavingJob, and employmentCheck.", "enum": [ "shortText", "longText", "multipleChoice", "opinionScale", "rating", "precisionScale", "strengths", "keyAchievements", "weaknesses", "reasonsForLeavingJob", "employmentCheck" ], "type": "string" } }, "required": [ "clientRef", "type", "prompt" ], "type": "object" }, "maxItems": 50, "minItems": 1, "type": "array" }, "thankYouScreen": { "additionalProperties": false, "description": "Optional form-specific completion copy; omit when the native template default fits.", "properties": { "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" }, "title": { "maxLength": 120, "minLength": 1, "type": "string" }, "welcomeScreen": { "additionalProperties": false, "description": "Optional form-specific welcome copy; omit when the native template default fits.", "properties": { "button": { "default": "Begin", "maxLength": 80, "minLength": 1, "type": "string" }, "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" } }, "required": [ "clientRef", "title", "questions" ], "type": "object" }, "maxItems": 10, "type": "array" }, "references": { "default": [], "items": { "additionalProperties": false, "properties": { "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "confetti": { "default": true, "type": "boolean" }, "conversationMode": { "default": true, "type": "boolean" }, "questions": { "items": { "additionalProperties": false, "properties": { "aiFollowUpEnabled": { "default": false, "description": "Enable only for a critical open-text question where a vague or incomplete answer needs an adaptive follow-up.", "type": "boolean" }, "attribute": { "description": "One exact numeric evidence attribute from design.matchingScoreAttributes. Omit for open-text narratives and all other non-scored questions.", "maxLength": 120, "minLength": 1, "type": "string" }, "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "evidenceRole": { "default": "evaluative", "description": "Evaluative means the question produces a numeric Matching Score input and requires an attribute. Use context for qualitative narratives, logistics, consent, relationship context, or any other unscored prompt.", "enum": [ "evaluative", "context" ], "type": "string" }, "insightsExtraction": { "description": "Enable for substantive Reference, Exit Intelligence, or Team Pulse narratives. Structured reference types default to enabled except employmentCheck.", "type": "boolean" }, "maxAnswers": { "default": 1, "description": "Maximum options a respondent may select. Use 1 for single-answer multiple choice; when the prompt states a limit such as “choose up to three”, set this to that exact limit.", "maximum": 20, "minimum": 1, "type": "integer" }, "options": { "items": { "anyOf": [ { "maxLength": 200, "minLength": 1, "type": "string" }, { "additionalProperties": false, "properties": { "score": { "description": "Non-negative numeric score for this answer. Required on every option of an evaluative multiple-choice question, with at least two distinct scores.", "maximum": 100, "minimum": 0, "type": "number" }, "title": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "title" ], "type": "object" } ] }, "maxItems": 20, "minItems": 2, "type": "array" }, "prompt": { "maxLength": 1500, "minLength": 1, "type": "string" }, "scoringPoints": { "description": "Optional start/end score mapping for an authored Test scale; reverse order enables reverse scoring.", "items": { "maximum": 100, "minimum": -100, "type": "number" }, "maxItems": 2, "minItems": 2, "type": "array" }, "type": { "description": "Question type. Reference forms also support the structured single-use types strengths, keyAchievements, weaknesses, reasonsForLeavingJob, and employmentCheck.", "enum": [ "shortText", "longText", "multipleChoice", "opinionScale", "rating", "precisionScale", "strengths", "keyAchievements", "weaknesses", "reasonsForLeavingJob", "employmentCheck" ], "type": "string" } }, "required": [ "clientRef", "type", "prompt" ], "type": "object" }, "maxItems": 50, "minItems": 1, "type": "array" }, "thankYouScreen": { "additionalProperties": false, "description": "Optional form-specific completion copy; omit when the native template default fits.", "properties": { "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" }, "title": { "maxLength": 120, "minLength": 1, "type": "string" }, "welcomeScreen": { "additionalProperties": false, "description": "Optional form-specific welcome copy; omit when the native template default fits.", "properties": { "button": { "default": "Begin", "maxLength": 80, "minLength": 1, "type": "string" }, "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" } }, "required": [ "clientRef", "title", "questions" ], "type": "object" }, "maxItems": 10, "type": "array" }, "teamPulse": { "default": [], "items": { "additionalProperties": false, "properties": { "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "confetti": { "default": true, "type": "boolean" }, "conversationMode": { "default": true, "type": "boolean" }, "questions": { "items": { "additionalProperties": false, "properties": { "aiFollowUpEnabled": { "default": false, "description": "Enable only for a critical open-text question where a vague or incomplete answer needs an adaptive follow-up.", "type": "boolean" }, "attribute": { "description": "One exact numeric evidence attribute from design.matchingScoreAttributes. Omit for open-text narratives and all other non-scored questions.", "maxLength": 120, "minLength": 1, "type": "string" }, "clientRef": { "maxLength": 64, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "type": "string" }, "evidenceRole": { "default": "evaluative", "description": "Evaluative means the question produces a numeric Matching Score input and requires an attribute. Use context for qualitative narratives, logistics, consent, relationship context, or any other unscored prompt.", "enum": [ "evaluative", "context" ], "type": "string" }, "insightsExtraction": { "description": "Enable for substantive Reference, Exit Intelligence, or Team Pulse narratives. Structured reference types default to enabled except employmentCheck.", "type": "boolean" }, "maxAnswers": { "default": 1, "description": "Maximum options a respondent may select. Use 1 for single-answer multiple choice; when the prompt states a limit such as “choose up to three”, set this to that exact limit.", "maximum": 20, "minimum": 1, "type": "integer" }, "options": { "items": { "anyOf": [ { "maxLength": 200, "minLength": 1, "type": "string" }, { "additionalProperties": false, "properties": { "score": { "description": "Non-negative numeric score for this answer. Required on every option of an evaluative multiple-choice question, with at least two distinct scores.", "maximum": 100, "minimum": 0, "type": "number" }, "title": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "title" ], "type": "object" } ] }, "maxItems": 20, "minItems": 2, "type": "array" }, "prompt": { "maxLength": 1500, "minLength": 1, "type": "string" }, "scoringPoints": { "description": "Optional start/end score mapping for an authored Test scale; reverse order enables reverse scoring.", "items": { "maximum": 100, "minimum": -100, "type": "number" }, "maxItems": 2, "minItems": 2, "type": "array" }, "type": { "description": "Question type. Reference forms also support the structured single-use types strengths, keyAchievements, weaknesses, reasonsForLeavingJob, and employmentCheck.", "enum": [ "shortText", "longText", "multipleChoice", "opinionScale", "rating", "precisionScale", "strengths", "keyAchievements", "weaknesses", "reasonsForLeavingJob", "employmentCheck" ], "type": "string" } }, "required": [ "clientRef", "type", "prompt" ], "type": "object" }, "maxItems": 50, "minItems": 1, "type": "array" }, "thankYouScreen": { "additionalProperties": false, "description": "Optional form-specific completion copy; omit when the native template default fits.", "properties": { "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" }, "title": { "maxLength": 120, "minLength": 1, "type": "string" }, "welcomeScreen": { "additionalProperties": false, "description": "Optional form-specific welcome copy; omit when the native template default fits.", "properties": { "button": { "default": "Begin", "maxLength": 80, "minLength": 1, "type": "string" }, "content": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" } }, "required": [ "clientRef", "title", "questions" ], "type": "object" }, "maxItems": 10, "type": "array" } }, "type": "object" }, "clearCopyOverrideFields": { "default": [], "description": "On a draft revision, reset only these existing copy overrides to Jointl defaults.", "items": { "enum": [ "welcomeScreen", "referenceCheckingCandidateScreen", "thankYouScreen", "welcomeEmail", "reminderWelcomeEmail", "emailRequestToReferee", "reminderEmailRequestToReferee", "thankYouEmail", "teamPulseEmailRequestToEmployee", "teamPulseReminderEmailRequestToEmployee" ], "type": "string" }, "maxItems": 10, "type": "array" }, "companyId": { "description": "Exact companies.list ID. Required for HIRING_REVIEW and must be within the member's current company access.", "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "copyOverrides": { "additionalProperties": false, "default": {}, "description": "Override only copy whose native Jointl default materially conflicts with this Flow; omit ordinary defaults.", "properties": { "emailRequestToReferee": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" }, "referenceCheckingCandidateScreen": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" }, "reminderEmailRequestToReferee": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" }, "reminderWelcomeEmail": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" }, "teamPulseEmailRequestToEmployee": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" }, "teamPulseReminderEmailRequestToEmployee": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" }, "thankYouEmail": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" }, "thankYouScreen": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" }, "welcomeEmail": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" }, "welcomeScreen": { "description": "Plain text only; separate title and paragraphs with newlines. Supported ##...## placeholders are preserved.", "maxLength": 6000, "minLength": 1, "type": "string" } }, "type": "object" }, "jobTitle": { "description": "Job title assessed by a HIRING_REVIEW Flow; required for that type.", "maxLength": 80, "minLength": 1, "type": "string" }, "matchingScoreAttributes": { "default": [], "description": "Up to 15 job-related attributes used by Jointl Matching Score, deliberately ordered from highest to lowest importance. With N attributes, Jointl applies linear weights N through 1 in this exact order. Every Hiring Review attribute must have at least one selected or authored question with valid numeric scoring.", "items": { "maxLength": 120, "minLength": 1, "type": "string" }, "maxItems": 15, "type": "array" }, "performance": { "additionalProperties": false, "description": "Required complete participant and cadence configuration for PERFORMANCE Flows; omit for other types.", "properties": { "employeeIds": { "description": "Exact visible Employee IDs who participate in enabled Glow Moments and Team Pulse cycles.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 250, "type": "array" }, "glowMoments": { "additionalProperties": false, "properties": { "cadence": { "additionalProperties": false, "properties": { "firstSendAt": { "anyOf": [ { "format": "date-time", "type": "string" }, { "format": "date-time", "type": "string" } ], "description": "ISO 8601 date-time for the first Glow Moments send." }, "interval": { "enum": [ "MONTHLY", "QUARTERLY" ], "type": "string" }, "mode": { "enum": [ "ONE_TIME", "RECURRING" ], "type": "string" }, "repeatUntil": { "anyOf": [ { "format": "date-time", "type": "string" }, { "format": "date-time", "type": "string" } ], "description": "Optional inclusive end date-time for a recurring cadence." } }, "required": [ "mode", "firstSendAt" ], "type": "object" }, "enabled": { "type": "boolean" } }, "required": [ "enabled" ], "type": "object" }, "teamPulse": { "additionalProperties": false, "properties": { "cadence": { "additionalProperties": false, "properties": { "firstSendAt": { "anyOf": [ { "format": "date-time", "type": "string" }, { "format": "date-time", "type": "string" } ], "description": "ISO 8601 date-time for the first Team Pulse send." }, "interval": { "enum": [ "MONTHLY", "QUARTERLY", "SEMI_ANNUAL" ], "type": "string" }, "mode": { "enum": [ "ONE_TIME", "RECURRING" ], "type": "string" }, "repeatUntil": { "anyOf": [ { "format": "date-time", "type": "string" }, { "format": "date-time", "type": "string" } ], "description": "Optional inclusive end date-time for a recurring cadence." } }, "required": [ "mode", "firstSendAt" ], "type": "object" }, "enabled": { "type": "boolean" } }, "required": [ "enabled" ], "type": "object" } }, "required": [ "employeeIds", "glowMoments", "teamPulse" ], "type": "object" }, "referenceCollection": { "additionalProperties": false, "description": "Hiring Review reference collection mode and thresholds; omit for other Flow types.", "properties": { "method": { "default": "AUTO", "enum": [ "AUTO", "MANUAL" ], "type": "string" }, "minReferenceCount": { "default": 3, "maximum": 10, "minimum": 1, "type": "integer" }, "minReferenceGap": { "default": 1, "maximum": 10, "minimum": 0, "type": "integer" } }, "type": "object" }, "tagIds": { "default": [], "description": "Existing Jointl tag IDs to attach.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 40, "type": "array" }, "templateIds": { "additionalProperties": false, "default": {}, "description": "Existing visible templates selected by category.", "properties": { "assessmentQuestions": { "default": [], "description": "Existing assessment-question template IDs.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 40, "type": "array" }, "assessmentTests": { "default": [], "description": "Existing visible Test template IDs. Search Private and Public Test Libraries before authoring a new Test.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 40, "type": "array" }, "exitIntelligence": { "default": [], "description": "Existing Exit Intelligence template IDs.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 40, "type": "array" }, "preScreening": { "default": [], "description": "Existing pre-screening template IDs.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 40, "type": "array" }, "references": { "default": [], "description": "Existing reference template IDs.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 40, "type": "array" }, "teamPulse": { "default": [], "description": "Existing Team Pulse template IDs.", "items": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "maxItems": 40, "type": "array" } }, "type": "object" }, "title": { "description": "Human-readable Flow title.", "maxLength": 80, "minLength": 1, "type": "string" }, "type": { "description": "Flow type. The allowed sections depend on this value.", "enum": [ "HIRING_REVIEW", "EXIT_INTELLIGENCE", "PERFORMANCE" ], "type": "string" } }, "required": [ "title", "type" ], "type": "object" }, "expectedRevision": { "anyOf": [ { "format": "date-time", "type": "string" }, { "format": "date-time", "type": "string" } ] }, "flowId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "flowId", "expectedRevision", "design" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_flows_draft_revise_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare a Flow draft revision" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare a Flow publish, archive, or restore action using the current Flow status to prevent conflicting changes. Publishing validates that the Flow is ready; archiving cancels pending requests and scheduled activity for the Flow. Explicit confirmation is required. Use when: Use only when the user explicitly asks to publish, activate, archive, or restore one known Flow; never infer a status change from scores or recommendations. Returns: after confirmation, the Flow ID, previous status, resulting status, and whether the status change was applied. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "expectedStatus": { "description": "Current status read from flows.get or flows.blueprint.get; used for concurrency safety.", "enum": [ "ACTIVE", "DRAFT", "ARCHIVED" ], "type": "string" }, "flowId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "status": { "description": "Publish/restore as ACTIVE or archive as ARCHIVED. Returning a Flow to DRAFT is unsupported.", "enum": [ "ACTIVE", "ARCHIVED" ], "type": "string" } }, "required": [ "flowId", "expectedStatus", "status" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_flows_status_set_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare Flow status change" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare irreversible deletion of one visible Flow and its related Checks, Autopilots, pending activity, and Performance cycle data. Explicit confirmation is required. Use when: Use only when the user explicitly asks to permanently delete one known Flow; offer flows.status.set with ARCHIVED when preserving history is acceptable. Returns: after confirmation, the deleted Flow ID, prior status, and deletion outcome. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "expectedStatus": { "description": "Current status read from flows.get or flows.blueprint.get; used to prevent a stale destructive action.", "enum": [ "ACTIVE", "DRAFT", "ARCHIVED" ], "type": "string" }, "flowId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "flowId", "expectedStatus" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_flows_delete_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare Flow deletion" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare a status change for one authorized Check using its current status to prevent conflicting changes. The `selected` status is not available because candidate selection uses the separate Employee conversion workflow. Explicit confirmation is required. Use when: Use only when the user explicitly asks to change one Check status; never shortlist or reject someone solely because an analysis, score, or ranking suggests it. Returns: after confirmation, the Check ID, previous status, resulting status, and whether the change was applied. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "applicantId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "expectedStatus": { "description": "Current status read from checks.get or checks.list; used for concurrency safety.", "enum": [ "new", "archived", "inProgress", "shortlisted", "rejected", "selected" ], "type": "string" }, "status": { "description": "New Check status. selected is intentionally excluded because selection creates an Employee.", "enum": [ "new", "archived", "inProgress", "shortlisted", "rejected" ], "type": "string" } }, "required": [ "applicantId", "expectedStatus", "status" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_checks_status_set_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare Check status change" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare irreversible deletion of one visible Check and its pre-screening, assessment, reference, feedback, verification, and pending lifecycle data. Explicit confirmation is required. Use when: Use only when the user explicitly asks to permanently delete one known Check; do not derive deletion from a score, rank, recommendation, or status. Returns: after confirmation, the deleted Check ID, prior status, and deletion outcome. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "applicantId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "expectedStatus": { "description": "Current status read from checks.get or checks.list; used to prevent a stale destructive action.", "enum": [ "new", "archived", "inProgress", "shortlisted", "rejected", "selected" ], "type": "string" } }, "required": [ "applicantId", "expectedStatus" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_checks_delete_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare Check deletion" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare an active or left status change for one authorized Employee using the current status to prevent conflicting changes. Marking left requires an end date for every active position and can optionally launch an Exit Intelligence Flow; an Employee already marked left may use the same operation solely to send Exit Intelligence. Explicit confirmation is required. Use when: Use only when the user explicitly asks to mark a known Employee active or left and has supplied any required position end dates, or explicitly asks to send Exit Intelligence to an Employee already marked left; never infer this action from performance analytics. Returns: after confirmation, the Employee ID, previous status, resulting status, and whether the change was applied. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "employeeId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "exitIntelligenceFlowId": { "description": "Optional active Exit Intelligence Flow to launch after marking the Employee left.", "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "expectedStatus": { "description": "Current status read from employees.get or employees.list; used for concurrency safety.", "enum": [ "active", "left" ], "type": "string" }, "positionEndAt": { "description": "One leaving date to apply to every active position. Do not combine with positionEndDates.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "positionEndDates": { "default": [], "description": "When marking left, provide an end date for every active position returned by employees.get.", "items": { "additionalProperties": false, "properties": { "endAt": { "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "positionId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "positionId", "endAt" ], "type": "object" }, "maxItems": 50, "type": "array" }, "status": { "enum": [ "active", "left" ], "type": "string" } }, "required": [ "employeeId", "expectedStatus", "status" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_employees_status_set_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare Employee status change" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare irreversible deletion of one visible Employee, removal from manager and Glow Moment assignments, and cancellation of incomplete requests and scheduled activity for the Employee. Explicit confirmation is required. Use when: Use only when the user explicitly asks to permanently delete one known Employee; do not derive deletion from performance evidence, rankings, or attention signals. Returns: after confirmation, the deleted Employee ID, prior status, and deletion outcome. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "employeeId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "expectedStatus": { "description": "Current status read from employees.get or employees.list; used to prevent a stale destructive action.", "enum": [ "active", "left" ], "type": "string" } }, "required": [ "employeeId", "expectedStatus" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_employees_delete_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare Employee deletion" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare a new, shortlisted, or archived status change for one company-scoped Talent Pool profile using its current status to prevent conflicting changes. Explicit confirmation is required. Use when: Use only when the user explicitly asks to change one Talent Pool status; never infer shortlisting from an analysis or ranking. Returns: after confirmation, the Talent Pool profile ID, previous status, resulting status, and whether the change was applied. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "expectedStatus": { "description": "Current status read from talents.get or talents.list; used for concurrency safety.", "enum": [ "new", "archived", "shortlisted" ], "type": "string" }, "status": { "enum": [ "new", "archived", "shortlisted" ], "type": "string" }, "talentId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "talentId", "expectedStatus", "status" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_talents_status_set_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare Talent Pool status change" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare a new Autopilot for one active visible Hiring Review Flow and generate reusable public access links. Anyone with a link can start the Flow. Explicit confirmation is required. Use when: Use when the user explicitly asks to run a new Autopilot or generate a new Autopilot link group for one exact active Flow. Returns: after confirmation, the Autopilot group ID, Flow context, newly generated public links, and a sharing warning. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "flowId": { "description": "Exact active Hiring Review Flow ID.", "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "linkCount": { "default": 1, "description": "Number of independent reusable public access links to generate.", "maximum": 20, "minimum": 1, "type": "integer" } }, "required": [ "flowId" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_autopilots_create_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare Autopilot run and public links" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare additional reusable public access links for one active Autopilot. Explicit confirmation is required. Use when: Use when the user explicitly asks for more links on an existing known Autopilot; do not create a second Autopilot group for the same intent. Returns: after confirmation, the existing group ID and only the newly generated public links with a sharing warning. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "autopilotGroupId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "expectedStatus": { "const": "ACTIVE", "default": "ACTIVE", "description": "Links can be added only while the Autopilot is ACTIVE.", "type": "string" }, "linkCount": { "default": 1, "description": "Number of independent reusable public access links to generate.", "maximum": 20, "minimum": 1, "type": "integer" } }, "required": [ "autopilotGroupId" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_autopilots_links_generate_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare additional Autopilot links" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare an Autopilot archive or restore action. Archiving disables every public link in the group while preserving its Checks. Explicit confirmation is required. Use when: Use only when the user explicitly asks to archive, disable, restore, or reactivate one known Autopilot. Returns: after confirmation, the Autopilot group ID, previous status, resulting status, and whether the action was applied. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "autopilotGroupId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "expectedStatus": { "enum": [ "ACTIVE", "ARCHIVED" ], "type": "string" }, "status": { "enum": [ "ACTIVE", "ARCHIVED" ], "type": "string" } }, "required": [ "autopilotGroupId", "expectedStatus", "status" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_autopilots_status_set_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare Autopilot status change" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare irreversible deletion of an Autopilot, every public link in its group, and every Check created through those links. Explicit confirmation is required. Use when: Use only when the user explicitly asks to permanently delete one known Autopilot; offer autopilots.status.set with ARCHIVED when disabling links while preserving Checks is acceptable. Returns: after confirmation, deleted group ID, prior status, link and Check counts, and deletion outcome. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "autopilotGroupId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "expectedStatus": { "description": "Current status read from autopilots.get or autopilots.list; used to prevent a stale destructive action.", "enum": [ "ACTIVE", "ARCHIVED" ], "type": "string" } }, "required": [ "autopilotGroupId", "expectedStatus" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_autopilots_delete_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare Autopilot deletion" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare one reference request using an exact manual reference form configured on the Check’s Flow. Use when: Use after resolving the Check and selecting a template from flows.referenceTemplates.list. Returns: after confirmation, the created reference ID and invitation delivery status. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "applicantId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "referee": { "additionalProperties": false, "properties": { "email": { "format": "email", "maxLength": 254, "type": "string" }, "name": { "maxLength": 180, "minLength": 1, "type": "string" }, "phone": { "pattern": "^[1-9][0-9]{6,14}$", "type": "string" }, "phoneMessageConsent": { "default": false, "type": "boolean" } }, "required": [ "name", "email" ], "type": "object" }, "templateId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "applicantId", "templateId", "referee" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_references_request_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare a reference request" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare up to 250 Checks from validated structured rows, such as rows parsed from an uploaded spreadsheet. Confirmation creates the Checks as one retry-safe action and queues any candidate invitations configured by the Flow. Use when: Use after the client has parsed a file into validated fullName and email rows and resolved one authorized Flow ID; never pass a file or URL. Returns: after confirmation, the created count and each applicant ID with its invitation delivery status. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "applicants": { "items": { "additionalProperties": false, "properties": { "email": { "format": "email", "maxLength": 254, "type": "string" }, "fullName": { "maxLength": 180, "minLength": 1, "type": "string" }, "sourceRowNumber": { "description": "Original one-based spreadsheet row number for preview and error reporting.", "maximum": 1000000, "minimum": 1, "type": "integer" } }, "required": [ "fullName", "email" ], "type": "object" }, "maxItems": 250, "minItems": 1, "type": "array" }, "flowId": { "description": "Exact authorized Hiring Review Flow ID.", "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "flowId", "applicants" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_checks_bulk_create_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare bulk Checks" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare an idempotent Employee import from up to 500 validated structured rows. Upsert mode applies Jointl Employee matching, create mode rejects existing matches, and update mode changes only exact Employee and work-record IDs. Company scope and compensation permissions are rechecked at confirmation. Use when: Use after the client has parsed and validated Employee rows and resolved exact authorized company IDs; use create for Search-or-Create, update for one exact existing work record, and upsert for bulk imports; never pass a file or URL. Returns: after confirmation, an import summary with created, updated, unchanged, and row-level outcomes. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "employees": { "items": { "additionalProperties": false, "properties": { "companyId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "companyName": { "maxLength": 180, "minLength": 1, "type": "string" }, "compensation": { "additionalProperties": false, "properties": { "currency": { "maxLength": 3, "minLength": 3, "type": "string" }, "effectiveAt": { "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "grossAmount": { "minimum": 0, "type": "number" }, "netAmount": { "minimum": 0, "type": "number" }, "payPeriod": { "enum": [ "annual", "monthly", "weekly", "daily", "hourly" ], "type": "string" } }, "type": "object" }, "email": { "format": "email", "maxLength": 254, "type": "string" }, "employeeId": { "description": "Exact existing Employee ID. Required only in update mode.", "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "endAt": { "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "fullName": { "maxLength": 180, "minLength": 1, "type": "string" }, "managerColumnMapped": { "description": "True only when the uploaded file explicitly mapped a manager column; false preserves an existing matching position manager.", "type": "boolean" }, "managerName": { "description": "Manager full name from the mapped column. Jointl resolves only an unambiguous existing Employee.", "maxLength": 180, "minLength": 1, "type": "string" }, "positionId": { "description": "Exact work-record ID on employeeId. Required only in update mode.", "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "positionTitle": { "maxLength": 180, "minLength": 1, "type": "string" }, "sourceRowNumber": { "description": "Original one-based spreadsheet row number for preview and error reporting.", "maximum": 1000000, "minimum": 1, "type": "integer" }, "startAt": { "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "tagNames": { "description": "Tag names parsed from the mapped column. Missing names are created only on confirmation.", "items": { "maxLength": 100, "minLength": 1, "type": "string" }, "maxItems": 50, "type": "array" }, "tagsColumnMapped": { "description": "True only when the uploaded file explicitly mapped a tags column; false preserves existing tags on a matching position.", "type": "boolean" } }, "required": [ "fullName", "companyId", "positionTitle", "startAt" ], "type": "object" }, "maxItems": 500, "minItems": 1, "type": "array" }, "mode": { "default": "upsert", "description": "upsert applies Jointl Employee matching; create rejects existing matches; update requires exact employeeId and positionId values.", "enum": [ "upsert", "create", "update" ], "type": "string" } }, "required": [ "employees" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_employees_bulk_import_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare bulk Employee import" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare a note for a visible Check. `visibleToTeam` controls whether other authorized workspace members can see it. A separate human confirmation is required. Use when: Use only when the user explicitly asks to add text to one authorized Check, after resolving its applicant ID. Returns: after confirmation, whether the note was added. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "applicantId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "text": { "description": "Exact note text the user asked to save.", "maxLength": 4000, "minLength": 1, "type": "string" }, "visibleToTeam": { "default": false, "description": "False keeps the note private to its author; true shares it with authorized workspace members.", "type": "boolean" } }, "required": [ "applicantId", "text" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_checks_add_note_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare Check note" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare a note for a visible Employee. `visibleToTeam` controls whether other authorized workspace members can see it. A separate human confirmation is required. Use when: Use only when the user explicitly asks to add text to one authorized Employee, after resolving its Employee ID. Returns: after confirmation, whether the note was added. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "employeeId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "text": { "description": "Exact note text the user asked to save.", "maxLength": 4000, "minLength": 1, "type": "string" }, "visibleToTeam": { "default": false, "description": "False keeps the note private to its author; true shares it with authorized workspace members.", "type": "boolean" } }, "required": [ "employeeId", "text" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_employees_add_note_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare Employee note" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Prepare a note for a company-scoped Talent Pool profile. `visibleToTeam` controls whether other authorized workspace members can see it. A separate human confirmation is required. Use when: Use only when the user explicitly asks to add text to one authorized Talent Pool profile, after resolving its profile ID. Returns: after confirmation, whether the note was added. Operation errors set isError to true and return a stable error code with a developer-facing message. Preparing returns an expiring preview without applying the action.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "Stable identity for one intent. Reuse only when retrying identical input.", "maxLength": 160, "minLength": 8, "pattern": "^[A-Za-z0-9._:-]{8,160}$", "type": "string" }, "input": { "additionalProperties": false, "properties": { "talentId": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "text": { "description": "Exact note text the user asked to save.", "maxLength": 4000, "minLength": 1, "type": "string" }, "visibleToTeam": { "default": false, "description": "False keeps the note private to its author; true shares it with authorized workspace members.", "type": "boolean" } }, "required": [ "talentId", "text" ], "type": "object" } }, "required": [ "input", "idempotencyKey" ], "type": "object" }, "name": "jointl_talents_add_note_prepare", "outputSchema": { "additionalProperties": false, "properties": { "result": { "oneOf": [ { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "confirmationToken": { "type": "string" }, "expiresAt": { "type": "string" }, "instruction": { "type": "string" }, "operation": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title" ], "type": "object" }, "preview": { "additionalProperties": true, "type": "object" }, "state": { "const": "pending" } }, "required": [ "confirmationId", "state", "confirmationToken", "expiresAt", "operation", "preview", "instruction" ], "type": "object" }, { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Prepare Talent Pool note" }, { "_meta": { "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ] }, "annotations": { "destructiveHint": true, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": false }, "description": "Execute exactly one prepared action after the user explicitly approves its preview. Returns state=completed and the operation result.", "inputSchema": { "additionalProperties": false, "properties": { "confirmationToken": { "maxLength": 256, "minLength": 40, "type": "string" } }, "required": [ "confirmationToken" ], "type": "object" }, "name": "jointl_confirm_action", "outputSchema": { "additionalProperties": false, "properties": { "result": { "additionalProperties": true, "properties": { "confirmationId": { "type": "string" }, "result": {}, "state": { "const": "completed" } }, "required": [ "confirmationId", "state", "result" ], "type": "object" } }, "required": [ "result" ], "type": "object" }, "securitySchemes": [ { "scopes": [ "workspace.write" ], "type": "oauth2" } ], "title": "Confirm a prepared Jointl action" } ] } }