Skip to main content
POST
Request a manual handoff of a LeadScout conversation to internal users

Authorizations

x-api-key
string
header
required

Copy the API key as provided by the Bridge Console.

Path Parameters

workspaceId
string<uuid>
required

Unique identifier of the workspace (UUID v4).

conversationId
string
required

Identifier of the conversation to hand off.

Body

application/json

Request body for a LeadScout manual handoff.

assignees
HandoffAssignee · object[]
required

Internal users to hand the conversation off to. At least one is required.

Minimum array length: 1
handoffMessages
string[]

Optional message bodies posted as part of the handoff.

includeAiLeadSummary
boolean
default:false

When true, the handoff message should include an AI-generated summary of the lead.

Response

Successful Response

Response body acknowledging an accepted handoff request.

trackingId
string
required

Correlation id generated for this handoff request.

conversationId
string
required

The conversation the handoff targets.

status
string
required

Acceptance status of the handoff request.

Example:

"ACCEPTED"

assignees
HandoffAssignee · object[]
required

Echo of the assignees received in the request.