Skip to content
OnCoreDocs
Transfer Reasons

POSThttps://core-api.heysadie.ai/transfer-reasons

name reason message assistantId phoneNumber extension isActive waitForResponse properties success data id createdAt updatedAt metadata timestamp version path error code details field

Create transfer reason

Create a new transfer reason for an assistant. Transfer reasons define when the assistant should hand over the call to a human. Use this when: - A caller wants to speak to a human for specific cases (e.g., special requests, escalations) - You want the assistant to have fallback logic for unhandled queries ⚠️ Make sure the number is reachable and properly configured for handling forwarded calls.

Try it in the API Explorer

Example request

Terminal
curl -X POST "https://core-api.heysadie.ai/transfer-reasons" \
  -H "Authorization: ApiKey YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "reason": "string",
    "message": "string"
  }'

Authentication

Authenticate with an API key in the Authorization header using the ApiKey scheme — see Authentication for how keys work and where to get them.

Authorizationstringrequired

API key in the ApiKey scheme: ApiKey YOUR_API_KEY. Tenant keys authorize their own tenant; organization keys can act on any tenant in the organization.

X-Tenant-Idstring (uuid)optional

Required when authenticating with an organization key — selects the tenant the request acts on. Omit with tenant keys.

Request

Body application/json · required

namestringoptional

A friendly name for this transfer reason

reasonstringoptional

Trigger that causes the assistant to transfer the call (e.g., user wants to talk to a human)

messagestringoptional

What the assistant says before transferring the call

assistantIdstring (uuid)optional

The assistant ID this rule applies to

phoneNumberstringoptional

Phone number to forward the call to

extensionstringoptional

Extension to dial automatically once the call connects. Leave blank to keep current behavior.

isActivebooleanoptional

Whether the transfer reason is active

waitForResponsebooleanoptional

Whether the assistant should wait for the caller's response before transferring (default: true)

propertiesanyoptional

Responses

200
successbooleanrequired
dataobjectoptional
Show 12 child properties
idstringrequired
namestringrequired
reasonstringrequired
messagestringrequired
assistantIdstringrequired
propertiesanyrequired
phoneNumberstringrequired
extensionstring | nullrequired
isActiveboolean | nullrequired
waitForResponseboolean | nullrequired
createdAtstring (date-time) | string (date) | number | nullrequired
updatedAtstring (date-time) | string (date) | number | nullrequired
metadataobjectoptional
Show 3 child properties
timestampstringrequired
versionstringrequired
pathstringoptional
400
successbooleanrequired
errorobjectoptional
Show 3 child properties
codeenumrequired
Allowed values:"VALIDATION_ERROR"
messagestringrequired
detailsobject[]optional
Show 2 item properties
fieldstringrequired
messagestringrequired
metadataobjectoptional
Show 3 child properties
timestampstringrequired
versionstringrequired
pathstringoptional
401
successbooleanrequired
errorobjectoptional
Show 2 child properties
codeenumrequired
Allowed values:"UNAUTHORIZED"
messagestringrequired
metadataobjectoptional
Show 3 child properties
timestampstringrequired
versionstringrequired
pathstringoptional
403
successbooleanrequired
errorobjectoptional
Show 2 child properties
codeenumrequired
Allowed values:"FORBIDDEN"
messagestringrequired
metadataobjectoptional
Show 3 child properties
timestampstringrequired
versionstringrequired
pathstringoptional
404
successbooleanrequired
errorobjectoptional
Show 2 child properties
codeenumrequired
Allowed values:"RESOURCE_NOT_FOUND"
messagestringrequired
metadataobjectoptional
Show 3 child properties
timestampstringrequired
versionstringrequired
pathstringoptional
500
successbooleanrequired
errorobjectoptional
Show 2 child properties
codeenumrequired
Allowed values:"INTERNAL_SERVER_ERROR"
messagestringrequired
metadataobjectoptional
Show 3 child properties
timestampstringrequired
versionstringrequired
pathstringoptional