# AshbyApi
import StarterToolInfo from "@/app/_components/starter-tool-info";
import ToolInfo from "@/app/_components/tool-info";
import Badges from "@/app/_components/badges";
import TabbedCodeBlock from "@/app/_components/tabbed-code-block";
import TableOfContents from "@/app/_components/table-of-contents";
import ToolFooter from "@/app/_components/tool-footer";
import { Callout } from "nextra/components";
The AshbyApi MCP Server offers a comprehensive suite of tools for managing recruitment processes within the Ashby platform. Users can perform a variety of actions, including:
- Create, update, and manage job applications and candidates.
- Retrieve detailed information about candidates, applications, jobs, and departments.
- Manage interview schedules, feedback, and assessments.
- Handle job postings, openings, and associated locations.
- Utilize webhooks for event notifications and manage user permissions.
This server is designed to streamline the hiring process, making it easier to track candidates and manage recruitment workflows effectively.
## Available Tools
If you need to perform an action that's not listed here, you can [get in touch
with us](mailto:contact@arcade.dev) to request a new tool, or [create your own
tools](/guides/create-tools/tool-basics/build-mcp-server).
## AshbyApi.GetApiKeyInfo
Retrieve information about the current API key in use.
**Parameters**
- **empty_request_body** (`json`, optional) Provide an empty JSON object as the request body. This is required to make the call but should contain no data.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ChangeApplicationSource
Change the source of an application in Ashby.
**Parameters**
- **application_source_details** (`json`, optional) JSON object containing `applicationId` and `sourceId` to specify the application and its new source.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ChangeApplicationStage
Change the stage of a candidate's application.
**Parameters**
- **application_stage_change_details** (`json`, optional) A JSON object containing applicationId, interviewStageId, and optional archiveReasonId and archiveEmail details, to change the application stage.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.CreateJobApplication
Create a job application for a candidate.
**Parameters**
- **job_application_data** (`json`, optional) JSON object containing candidateId, jobId, interviewPlanId, interviewStageId, sourceId, creditedToUserId, createdAt, and applicationHistory for the job application.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.FetchApplicationDetails
Fetch application details using application or form instance ID.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListApplications
Retrieve all applications in the organization.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.TransferApplicationToJob
Transfer an application to a different job.
**Parameters**
- **application_transfer_details** (`json`, optional) A JSON object containing the details for transferring an application, including `applicationId`, `jobId`, `interviewPlanId`, `interviewStageId`, and `startAutomaticActivities`.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.UpdateApplicationStatus
Updates the status or details of an application.
**Parameters**
- **application_update_payload** (`json`, optional) JSON object containing applicationId, sourceId, creditedToUserId, createdAt, and sendNotifications to update application details. sendNotifications controls subscriber notifications.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.UpdateApplicationHistory
Update the history of an application.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetApplicationHistory
Fetch a paginated list of application history items.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetCandidateCriteriaEvaluations
Retrieve AI evaluations for candidate job criteria.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListApplicationFeedback
Retrieve interview feedback and scorecards for applications.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.AddHiringTeamMember
Add a user to the hiring team for an application.
**Parameters**
- **hiring_team_member_details** (`json`, optional) A JSON object containing 'applicationId', 'teamMemberId', and 'roleId'. These IDs specify the application, team member, and role for adding to the hiring team.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.RemoveHiringTeamMember
Remove a user from the hiring team for an application.
**Parameters**
- **hiring_team_removal_details** (`json`, optional) JSON object containing applicationId, teamMemberId, and roleId for the user to be removed.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetHiringTeamRoles
Retrieve all available hiring team roles for applications.
**Parameters**
This tool does not take any parameters.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.SubmitApplicationFeedback
Submit application feedback forms with various field types.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetApprovalList
Retrieve all approvals in the organization.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.UpdateApprovalDefinition
Create or update an approval definition for an entity.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListArchiveReasons
Retrieve a list of archive reasons.
**Parameters**
- **include_archived_interview_plans** (`boolean`, optional) Set to true to include archived interview plans in the results.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.AddCompletedAssessmentToCandidate
Adds a completed assessment to a candidate's record.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.StartAssessment
Start an assessment using the Ashby API.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListAssessments
Retrieve a list of available assessments.
**Parameters**
This tool does not take any parameters.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.UpdateAssessmentStatus
Update the status of a candidate assessment in Ashby.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.CancelAssessment
Cancel an ongoing assessment.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.AddCandidateToProject
Add a candidate to a specified project.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.AddCandidateTag
Add a tag to a candidate in the recruitment system.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.AnonymizeCandidateData
Permanently anonymize a candidate's data in the system.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.CreateCandidate
Create a new candidate entry.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.CreateCandidateNote
Add a note to a candidate's profile in Ashby.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetCandidateInformation
Retrieve detailed information of a candidate using their ID.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListCandidates
Retrieve a list of all candidates in an organization.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListCandidateClientInfo
Retrieve client info records for a candidate.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListCandidateNotes
Retrieve all notes associated with a candidate.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListCandidateProjects
Retrieve all projects linked to a candidate.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.FindCandidates
Search for candidates by email or name.
**Parameters**
- **candidate_email** (`string`, optional) The email address of the candidate to search for. Use this to refine the search results and find specific candidates.
- **candidate_name** (`string`, optional) The name of the candidate to search for in the database.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.UpdateCandidateInfo
Update an existing candidate's information.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.CreateCandidateTag
Create a new candidate tag in the Ashby system.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListCandidateTags
Retrieve a list of all candidate tags.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListCloseReasons
Get a list of close reasons for jobs or openings.
**Parameters**
- **include_archived_reasons** (`boolean`, optional) Set to true to include archived close reasons in the response.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListEnabledCommunicationTemplates
Retrieve all enabled communication templates.
**Parameters**
This tool does not take any parameters.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.CreateCustomField
Creates a new custom field in Ashby.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetCustomFieldInfo
Retrieve information about a custom field.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListCustomFields
Retrieve a list of all custom fields.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.SetCustomFieldValue
Update the value of a custom field for an object.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.CreateDepartment
Create a new department within an organization.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ArchiveDepartment
Archive a department within an organization.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.RestoreDepartment
Restores a previously deleted department.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetDepartmentDetails
Fetches department details using a department ID.
**Parameters**
- **department_id** (`json`, optional) The ID of the department to fetch details for. This is required to retrieve accurate department information.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListDepartments
Retrieve a list of all departments.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.MoveDepartment
Relocate a department to a new parent structure.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.UpdateDepartment
Update existing department details in the system.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.RetrieveCandidateFileUrl
Retrieve the URL of a candidate's associated file.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetFeedbackFormInfo
Fetch detailed information about a specific feedback form by ID.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListFeedbackForms
Retrieve a list of all feedback forms.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.HiringTeamAddMember
Adds a user to the hiring team for a job or application.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.RemoveTeamMemberFromHiring
Remove a member from the hiring team at job or application level.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListHiringTeamRoles
Retrieve possible hiring team roles within an organization.
**Parameters**
- **return_role_titles_only** (`boolean`, optional) Set to true to return only role titles. Set to false to return objects with id and title.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.FetchInterviewDetails
Retrieve interview details using interview ID.
**Parameters**
- **interview_id** (`json`, optional) The unique ID of the interview to fetch details for. This ID is required to retrieve the specific interview information.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListInterviews
Retrieve a list of all scheduled interviews.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListInterviewEvents
Retrieve a list of interview events for a schedule.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListInterviewPlans
Fetch a list of all available interview plans.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.CancelInterviewSchedule
Cancel an interview schedule using its ID.
**Parameters**
- **interview_schedule_cancel_details** (`json`, optional) A JSON object containing the ID of the interview schedule to cancel and whether rescheduling is allowed. Required JSON structure with keys 'id' and 'allowReschedule'.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.CreateInterviewSchedule
Create a scheduled interview in Ashby.
**Parameters**
- **interview_schedule_request** (`json`, optional) JSON object containing application ID, interview events, and extra data. Events include start time, end time, and interviewers.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetInterviewSchedules
Retrieve all interview schedules for the organization.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.UpdateInterviewSchedule
Update, add, or cancel interview schedule events.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListInterviewStages
Retrieve all interview stages for an interview plan in order.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.FetchInterviewStageDetails
Fetches details of a specific interview stage.
**Parameters**
- **interview_stage_id** (`json`, optional) The unique identifier of the interview stage to fetch details for. Required for retrieving the specific stage information.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListInterviewStageGroups
Retrieve all interview group stages in order.
**Parameters**
This tool does not take any parameters.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListInterviewerPools
Fetches a list of all interviewer pools.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetInterviewerPoolInfo
Retrieve information about an interviewer pool.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.CreateInterviewerPool
Creates a new interviewer pool for hiring processes.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.UpdateInterviewerPool
Update an interviewer pool.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ArchiveInterviewerPool
Archive an interviewer pool when needed.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.RestoreInterviewerPool
Restores an archived interviewer pool.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.AddUserToInterviewerPool
Add a user to an interviewer pool in Ashby.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.RemoveUserFromInterviewerPool
Remove a user from an interviewer pool.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.CreateNewJob
Create a new job listing with specified details.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetJobDetails
Retrieve detailed information about a job using its ID.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListAllJobs
Retrieve all open, closed, and archived jobs from Ashby.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.SetJobStatus
Update the status of a job by its ID.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.UpdateJobDetails
Update details of an existing job.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.UpdateJobCompensation
Update a job's compensation details.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.SearchJobsByTitle
Search for jobs by title.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListEnabledJobBoards
Retrieve all enabled job boards.
**Parameters**
- **request_body_data** (`json`, optional) The JSON payload for the request. This should contain any necessary parameters for listing enabled job boards.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.JobInterviewPlanInfo
Retrieve a job's interview plan details.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetJobPostingInfo
Retrieve detailed information about a specific job posting.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListPublishedJobPostings
Retrieve all published and publicly listed job postings.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListJobTemplates
Retrieve all active and inactive job templates.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.UpdateJobPosting
Update an existing job posting on the Ashby platform.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ArchiveLocation
Archives a location or location hierarchy.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.CreateLocation
Create a location or location hierarchy.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetLocationDetails
Retrieve detailed information for a specific location.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListAllLocations
Retrieve a list of all available locations.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.MoveLocationInHierarchy
Move a location within the organizational hierarchy.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.RestoreArchivedLocation
Restores an archived location or hierarchy.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.UpdateLocationAddress
Update the address of a location.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.UpdateLocationName
Updates the name of a location.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.UpdateLocationRemoteStatus
Update the remote status of a specific location.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.UpdateWorkplaceType
Update the workplace type for a specific location.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.OfferApprovalAction
Approve an offer or a specific step in the approval process.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.CreateOffer
Create a new offer using specified form fields.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetOfferDetails
Retrieve details about a specific offer using its ID.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetLatestOffers
Retrieve the latest version of all offers available.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.CreateCandidateOfferVersion
Initiate a new offer version for a candidate.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.UpdateOffer
Update an existing offer and retrigger approval steps.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.StartOfferProcess
Initiate an offer process for a candidate.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetOpeningInfo
Retrieve job opening details using a UUID.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListJobOpenings
Retrieve a list of current job openings.
**Parameters**
- **last_sync_token** (`string`, optional) Opaque token representing the last time a full set of results was fetched. Use this to sync data updates.
- **page_cursor** (`string`, optional) String indicating which page of job openings results to fetch, used for pagination.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.SearchJobOpenings
Search for job openings by identifier.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.CreateJobOpening
Create a new job opening in the system.
**Parameters**
- **associated_job_ids** (`array[string]`, optional) Array of job IDs related to the opening.
- **department_team_id** (`string`, optional) The unique identifier for the department or team associated with the job opening.
- **employment_start_date** (`string`, optional) The date (in YYYY-MM-DD format) when the hired person is expected to start employment.
- **employment_type** (`string`, optional) The employment type for this opening. Options include: FullTime, PartTime, Intern, Contract, Temporary.
- **identifiers** (`string`, optional) Comma-separated list of jobIds, targetHireDate, targetStartDate, isBackfill, and employmentType to define job details.
- **is_backfill** (`boolean`, optional) Indicate whether the job opening is intended to backfill a previous employee's position.
- **job_description** (`string`, optional) A detailed description of the job opening, including responsibilities and qualifications.
- **location_ids** (`array[string]`, optional) A list of location IDs associated with the job opening.
- **opening_state** (`string`, optional) Specifies the state of the job opening. Options: Draft, Approved, Open, Closed. Defaults to Draft. Additional validation may be needed if not Draft.
- **target_hire_date** (`string`, optional) Specify the date (YYYY-MM-DD) by which the hire is intended to be made for the job opening.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.AddJobToOpening
Adds a job to an opening.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.RemoveJobFromOpening
Remove a job from an opening.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.AddLocationToJobOpening
Adds a location to a job opening.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.RemoveLocationFromOpening
Remove a location from a job opening.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.SetOpeningState
Update the state of a job opening.
**Parameters**
- **close_reason_id** (`string`, optional) The ID for the reason why the opening is closed, required when setting the state to closed.
- **new_opening_state** (`string`, optional) The new state to update the job opening to. Accepted values are 'Draft', 'Approved', 'Open', 'Closed'.
- **opening_id** (`string`, optional) The unique identifier of the job opening to be updated.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.SetOpeningArchivedState
Set or unset the archived state of a job opening.
**Parameters**
- **opening_id** (`string`, optional) The ID of the job opening to archive or unarchive.
- **set_archived_state** (`boolean`, optional) Boolean to set the archived state of a job opening. Use true to archive and false to unarchive.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.UpdateJobOpening
Update the details of a job opening.
**Parameters**
- **department_team_id** (`string`, optional) The unique ID of the department or team associated with the job opening.
- **employment_type** (`string`, optional) Specifies the employment type for the job opening. Can be FullTime, PartTime, Intern, Contract, or Temporary.
- **fields_to_update** (`string`, optional) Specify the fields you want to update, such as jobIds, targetHireDate, targetStartDate, isBackfill, employmentType.
- **is_backfill** (`boolean`, optional) Indicate if the opening is intended to backfill an employee. Use true for backfill, false otherwise.
- **job_description_update** (`string`, optional) The new description text for the job opening. Provide a detailed and clear update relevant to the job role.
- **opening_identifier** (`string`, optional) The unique ID of the job opening to update.
- **target_hire_date** (`string`, optional) The date in YYYY-MM-DD format by which you intend to hire for the opening.
- **target_start_date** (`string`, optional) The intended start date (in YYYY-MM-DD format) for a newly hired employee.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetProjectInformation
Retrieve detailed information about a project.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListProjects
Retrieve a list of projects.
**Parameters**
- **last_sync_token** (`string`, optional) An opaque token from the last successful data sync. This is used to fetch updates.
- **max_items_to_return** (`integer`, optional) The maximum number of projects to return. The default and maximum value is 100.
- **page_results_cursor** (`string`, optional) An opaque cursor indicating which page of results to fetch from the project list.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.SearchProjectsByTitle
Search for projects by title for quick lookups.
**Parameters**
- **project_title** (`string`, optional) The title of the project to search for. Use this to narrow down the results to specific projects based on their name.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.CreateCandidateReferral
Creates a candidate referral in the system.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetReferralFormInfo
Fetches or creates the default referral form details.
**Parameters**
This tool does not take any parameters.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GenerateAndPollReport
Generate a new report or poll status of report generation.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.RetrieveSyncReport
Retrieve report data synchronously with Ashby.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListAllSources
Retrieve a list of all sources for hiring processes.
**Parameters**
- **include_archived_items** (`boolean`, optional) When true, archived items are included in the results.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListSourceTrackingLinks
Retrieve all source custom tracking links.
**Parameters**
- **include_disabled_tracking_links** (`boolean`, optional) Set to true to include disabled tracking links in the list.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetSurveyFormDetails
Retrieve details of a survey form definition by id.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListSurveyFormDefinitions
Retrieve all survey form definitions.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.CreateSurveyRequest
Create a survey request and get a survey URL.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListSurveyRequests
Retrieve a list of all survey requests.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.CreateSurveySubmission
Create a new survey submission.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.ListSurveySubmissions
Retrieve all survey submissions for a specific type.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetAshbyUserInfo
Retrieve detailed information of a specific Ashby user.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetAshbyUserList
Retrieve a list of all users in Ashby and their access levels.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.AshbyUserSearch
Search for an Ashby user by email address.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.GetInterviewerSettings
Retrieve interviewer settings for a user.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.UpdateInterviewerSettings
Update interviewer settings for a user.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.CreateWebhookSetting
Creates a webhook setting in Ashby.
**Parameters**
- **webhook_configuration** (`json`, optional) A JSON object containing configuration details for the webhook, including webhookType, requestUrl, and secretToken.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.RetrieveWebhookInfo
Retrieve detailed information on a specific webhook setting by ID.
**Parameters**
- **mode** (`Enum` [ToolMode](#toolmode), required) Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
- **request_body** (`string`, optional) Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.UpdateWebhookSetting
Update a webhook setting for Ashby service.
**Parameters**
- **webhook_settings_payload** (`json`, optional) JSON object containing `webhookId`, optionally one of `enabled`, `requestUrl`, or `secretToken` to update specific settings.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## AshbyApi.DeleteWebhookSetting
Delete a webhook setting.
**Parameters**
- **webhook_id** (`json`, optional) The unique identifier of the webhook to be deleted.
**Secrets**
This tool requires the following secrets: `ASHBY_API_KEY` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))
## Reference
Below is a reference of enumerations used by some of the tools in the AshbyApi MCP Server:
### ToolMode
- **GET_REQUEST_SCHEMA**: `get_request_schema`
- **EXECUTE**: `execute`