Skip to main content
PUT
Assign team 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
teamId
string
required

ID of the team to assign

isToolCall
boolean
default:false

Whether it's a tool call

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

Response

Team 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)