---
title: "Hangup conference"
method: POST
path: "/calls/1/conferences/{conferenceId}/hangup"
tags: ["channels", "voice", "calls", "conference-calls", "conference-operations"]
---

# Hangup conference

`POST /calls/1/conferences/{conferenceId}/hangup`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/calls/1/conferences/{conferenceId}/hangup`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

Hang up a conference. This action also hangs up all calls in the conference.

## Path parameters

- `conferenceId` string, required

## Response `200`

Success

- C18e27d419b307552daa9403b0085ee796da1a5e57e2a4e6fb73f406471574fcConference
  - `id` string: Unique conference ID.
  - `name` string: Conference name, requested or autogenerated on creation.
  - `participants` C18e27d419b307552daa9403b0085ee796da1a5e57e2a4e6fb73f406471574fcParticipant[]: The list of conference participants.
    - `callId` string: Participant call ID.
    - `endpoint` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611CallEndpoint, required: Call endpoint. Represents a caller for the inbound calls and a callee for the outbound calls.
      - `type` 'PHONE' | 'SIP' | 'WEBRTC' | 'VIBER' | 'WHATSAPP' | 'WEBSOCKET'
    - `state` 'JOINING' | 'JOINED' | 'LEFT': Participant state.
    - `joinTime` string, date-time: Date and time when the participant has joined.
    - `leaveTime` string, date-time: Date and time when the participant has left.
    - `media` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611MediaProperties
      - `audio` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611AudioMediaProperties: Audio media properties.
        - `muted` boolean: Indicates whether the end user can speak.
        - `userMuted` boolean: Indicates whether the end user muted himself.
        - `deaf` boolean: Indicates whether the end user can hear.
      - `video` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611VideoMediaProperties: Video media properties.
        - `camera` boolean: Indicates whether there is a video feed.
        - `screenShare` boolean: Indicates whether the end user is sharing their screen.
        - `blind` boolean: Indicates whether the end user can receive remote videos.
    - `role` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611Role: Represents the role of the call inside the conference.
      - `type` 'DEFAULT' | 'ADVISOR' | 'MONITOR' | 'LISTENER' | 'AUDITOR'
  - `callsConfigurationId` string: Calls Configuration ID.
  - `platform` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611Platform: Platform options. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).
    - `entityId` string: Required to use entity in a send request for outbound traffic. Returned in notification events. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).
    - `applicationId` string: Required for application use in a send request for outbound traffic. Returned in notification events. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)