Force-disable one media kind on the publisher

Stops capture in the browser. Does not change the token publish ceiling.

POST / v1 / calls / {id} / participants / {pid} / unpublish

Stops capture in the browser. Does not change the token publish ceiling.

Authorizations

Authorizationstringheaderrequired

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

Request body required

media"microphone" | "camera" | "screen"required

Available options: microphone, camera, screen

Responses

Sent

curl --request POST \
  --url "http://127.0.0.1:7880/v1/calls/{id}/participants/{pid}/unpublish" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"media":"screen"}'

const res = await fetch("http://127.0.0.1:7880/v1/calls/{id}/participants/{pid}/unpublish", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"media":"screen"}),
});
const data = await res.json();

{
  "error": {
    "code": "unauthorized",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "<string>"
  }
}