List team handling segments

Request

List the periods teammates actively handled a conversation, attributed to the team assigned to the conversation at the time. A period is split where the team changes. Teammate identity is not included; join with List handling events by time to recover it.

Periods with no team assigned are returned with team set to null. ended_at is null while a period is still open.

Requires the read_conversations OAuth scope, and the caller must be able to access the conversation.

Security

bearerAuth

Path

idstringrequired

The identifier for the conversation as given by Intercom.

Example:123

Intercom-Versionstring(intercom_version_preview)

Preview Intercom API version. Used for closed beta endpoints or other features under managed availability.

Default:"Preview"

Value:"Preview"

Example:Preview

curl -i -X GET \
  https://api.intercom.io/conversations/123/team_handling_segments \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: Preview'

Responses

Successful response

Bodyapplication/json

team_handling_segmentsArray of objects(Team Handling Segment)

Example:

[
  {
    "team": { … },
    "started_at": "2026-09-28T10:10:00Z",
    "ended_at": "2026-09-28T10:20:00Z",
    "start_reason": null,
    "end_reason": "team_change"
  }
]

Response

{
  "team_handling_segments": [
    { … },
    { … }
  ]
}