> This page is for Agent Handler. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # Warp **Authentication:** API key. See [Magic Link](/merge-agent-handler/build/authentication/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/administer/application-credentials) to bring your own OAuth app. ## Available Tools #### list_custom_fields List the custom worker field definitions your API key can read. Use this to find field IDs (and, for... #### get_custom_field Get a custom worker field definition by ID, including its select options. Use list_custom_fields to find valid IDs. #### create_custom_field Create a custom worker field definition. The field type is immutable after creation. Select and multi_select fields... #### update_custom_field Update a custom worker field definition. The field type cannot be changed; create a new field instead. Changing... #### archive_custom_field Archive a custom worker field. Archived fields keep their existing worker values but cannot receive new ones. Use... #### create_field_option Add an option to a select or multi_select custom worker field. The option value should be treated as stable; the... #### update_field_option Update the label or sort order of a custom worker field option. Options of archived fields cannot be edited. Use... #### delete_field_option Delete a custom worker field option that is not applied to any worker. Options in use must be archived instead using... #### archive_field_option Archive a custom worker field option. Archived options remain on existing worker values but cannot be newly... #### list_custom_field_values List custom field values for workers, optionally filtered by worker or field. Values are returned only for fields... #### set_custom_field_value Create or replace a worker's value for a custom field (upsert). The value shape must match the field type. Use... #### clear_custom_field_value Remove a worker's value for a custom field. Use list_workers for the worker ID and list_custom_fields for the field ID. #### list_departments List all departments for your company, with cursor pagination. Use this to find departmentId values for... #### create_department Create a new department for your company. #### update_department Update an existing department's name. Use list_departments to find valid IDs. #### list_offers List candidate offers. Supports filtering by status, worker type, and candidate email, plus cursor pagination. Use... #### create_offer Create and send a candidate offer. The candidate receives an email with a link to the offer portal, so only call... #### void_offer Void a previously sent offer. Only offers in 'sent' status can be voided. Use list_offers to find valid offer IDs. #### extend_offer_deadline Extend the expiration deadline of a sent offer. Use list_offers to find valid offer IDs. #### resend_offer Resend the offer email to the candidate for a sent offer. Use list_offers to find valid offer IDs. #### list_time_off_policies List the time off policies for your company, with cursor pagination. #### get_time_off_policy Get a specific time off policy by ID. Use list_time_off_policies to find valid IDs. #### list_time_off_assignments List time off assignments (mappings between workers and time off policies). Useful for finding which policies a... #### list_time_off_balances Get worker remaining time-off balances. Filter by policyIds (use list_time_off_policies), workerIds (use... #### list_time_off_requests Get the time off requests that workers in your company have made. Filter by status, policyIds (use... #### list_workers List workers (employees and contractors). Supports filtering by status, type, and work email, plus cursor... #### get_worker Get a specific worker by ID. Use list_workers to find valid worker IDs. #### create_employee Create a new US employee in draft status. Requires a valid departmentId (use list_departments) and managerId (use... #### create_contractor Create a new contractor (individual or business) in draft status. Requires a valid departmentId (use... #### invite_worker Send or resend the onboarding invite email to a worker so they can accept and complete onboarding to Warp. If... #### delete_worker Delete a worker. Only workers who have not yet completed onboarding (draft, invited, or onboarding status) can be... #### list_workplaces List all workplaces for your company, with cursor pagination. Use this to find workplaceId values for the office... #### create_workplace Create a new workplace for your company. #### update_workplace Update an existing workplace's name. Use list_workplaces to find valid IDs.