Skip to main content
PUT
Update team
Configure telephony pacing, distribution, and wrap-up with the optional team policy fields. Send only the fields you want to change. All fields, including name, are optional when updating a team; omitted fields stay unchanged. Creating a team still requires a name. An update must contain at least one recognized field; empty bodies or bodies containing only unknown fields return 400 without changing the team. For example, to enable support without changing the team name or other settings:
Optionally set category_id to a category from the same workspace. See team categories for defaults, clearing a category, and validation.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

teamId
string
required

Body

application/json
name
string
category_id
string<uuid> | null
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
description
string
is_support_enabled
boolean
support_office_hours_id
string | null
support_assignment_strategy
enum<string>
Available options:
least-busy,
round-robin,
unassigned
call_wrap_up_seconds
integer | null

Team wrap-up in seconds. Null inherits the organization setting; zero disables wrap-up.

Required range: 0 <= x <= 3600
telephony_pacing_enabled
boolean

Queue calls for this team and offer each call to one available agent at a time.

telephony_ring_seconds
integer
Required range: 10 <= x <= 120
telephony_queue_wait_seconds
integer
Required range: 30 <= x <= 3600
telephony_distribution
enum<string>
Available options:
fewest_answered_today,
longest_available
auto_assign_interval_seconds
integer

Seconds between automatic assignments to the same agent under the least-busy strategy: 0 turns pacing off, otherwise 15 to 3600.

Required range: 0 <= x <= 3600

Response

Default Response