---
title: "Staff Directory Transfer"
method: POST
path: "/vapi/staff-directory-transfer"
tags: ["Vapi"]
---

# Staff Directory Transfer

`POST /vapi/staff-directory-transfer`

## Request

- Base URL: `https://api.openintake.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openintake.ai/vapi/staff-directory-transfer`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/openintake/apis/openintake-api/docs/vapi/staff-directory-transfer/post.ts> (a function with typed inputs; its response is checked against the schema)

Put a staff-line caller through to a colleague or department (the
staff line's transferTo tool).

The agent names an entry from the {{staffDirectory}} list
resolve_inbound_routing injected (app/vapi/staff_directory.py). This maps
it back to a person's extension or a TransferDestination and hands the call
off the same way /transfer-destination does: stamp it, wait for the spoken
announcement, POST the transfer to the control URL.

A name that isn't in the directory is a tool error, so the agent asks the
caller again instead of guessing. Every entry is reached by SIP REFER (a
person has no number to dial), so the call must have come through the SIP
relay.

## Request body

- VapiCustomToolRequest: Wrapper for Vapi custom tool requests.
  - `message` VapiMessage, required
    - `type` string, required
    - `toolCallList` VapiToolCall[], required
      - `id` string, required
      - `type` string
      - `function` VapiToolCallFunction, required
        - `name` string, required
        - `arguments` object, required
    - `call` VapiCallObject
      - `id` string, required
    - `artifact` object, nullable
    - `assistant` object, nullable

## Response `200`

Successful Response

- VapiCustomToolResponse: Standard Vapi custom tool response format.
  - `results` VapiToolResult[], required
    - `toolCallId` string, required
    - `result` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-05** `bbd665969b1b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openintake/apis/openintake-api/changes/vapi/staff-directory-transfer/post.md)

---

[API](https://skmtc.dev/openintake/apis/openintake-api.md) - [All operations](https://skmtc.dev/openintake/apis/openintake-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openintake/apis/openintake-api/revisions/fe9f779e77ad?raw)