Skip to main content
PUT
Assign user to conversation

Authorizations

Authorization
string
header
required

Token JWT de autenticação

Headers

x-company-id
string

Target company identifier. Required only for global API keys (type=global). Ignored for company API keys and human users.

Path Parameters

id
string
required

Conversation ID

Body

application/json
userId
string
required

ID of the user (attendant) to assign

isToolCall
boolean
default:false

Whether it's a tool call

preserveWhoAnswering
boolean
default:false

If true, keeps the current who_answering (does not force HUMAN). Used in HubSpot owner synchronization.

triggeredBy
enum<string>

Assignment origin. Purely an observability field, propagated only to logs.

Available options:
ai_tool_assign_user,
ai_tool_assign_team,
ai_tool_distribute_owner,
ai_tool_assign_linked_user,
webhook_hubspot_owner_sync,
campaign_step_config,
campaign_list_owner_reconcile,
ui_user,
ui_admin,
user_offboard_reassign,
manual_template_send,
internal
rejectInactiveUser
boolean

If true, assigning to a user who is not ACTIVE returns an error instead of ignoring the assignment. Enabled only on the operator route, where someone is available to read the message; every automatic path (tool, CRM webhook, campaign) uses the default false.

webhookEventId
string

eventId of the HubSpot webhook when the assignment is triggered via WebhookOwnerSyncService. Propagated only for logs.

Response

User assigned successfully

last_activity_at
any
required

Date of the last activity

status
enum<string>
required

Conversation status

Available options:
OPEN,
RESOLVED
who_answering
enum<string>
required

Who is responding (AGENT/HUMAN)

Available options:
AGENT,
HUMAN,
UNASSIGNED
contact
any
required

Conversation's contact

inbox
any
required

Conversation's inbox

company
any
required

Conversation's company

_id
string

Conversation ID

additional_attributes
any

Additional conversation attributes

agent_last_activity_at
any

Date of the agent's last activity

contact_last_activity_at
any

Date of the contact's last activity

allow_send_messages_at
any

Date allowed to send messages

priority
enum<number>

Conversation priority

Available options:
4,
3,
2,
1
agent
any

Agent assigned to the conversation

current_step
any

Current step of the agent's flow

user
any

User assigned to the conversation

requires_attention
object

Attention required

referral
any

Conversation referral data

createdAt
any

Conversation creation date

updatedAt
any

Conversation update date

resolved_count
number

Number of resolved conversations for the contact (only when grouped)