Put Channel

put/api/channels/:channel_id/

Create or replace a channel. Configuration runs in background.

Path parameters

channel_idstringRequired

Request

This endpoint expects an object.

Loading schema details…

Response

200Successful Response

Loading schema details…

Errors

422Validation Error

Loading schema details…

503Service unavailable

No response body.

put/api/channels/{channel_id}/

curl -X PUT "/api/channels/{channel_id}/" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "BeamChannel",
  "metadata": {
    "name": "string",
    "displayName": "string"
  },
  "spec": {
    "type": "EncodingContribution",
    "state": "Stopped",
    "inputs": [],
    "transform": {
      "encoding": {
        "video": {
          "codec": "H264High",
          "videoFormat": "1920x1080p",
          "bitrate": 6000000,
          "frameRate": "TrueMotion"
        },
        "audios": []
      },
      "multiplexing": {
        "enabled": false
      }
    },
    "outputs": []
  }
}'

200Successful Response

{
  "kind": "BeamChannel",
  "metadata": {
    "name": "string",
    "displayName": "string",
    "created": "2024-01-01T00:00:00Z"
  },
  "spec": {
    "type": "EncodingContribution",
    "state": "Stopped",
    "inputs": [],
    "transform": {
      "encoding": {
        "video": {
          "codec": "H264High",
          "videoFormat": "1920x1080p",
          "bitrate": 6000000,
          "frameRate": "TrueMotion"
        },
        "audios": []
      },
      "multiplexing": {
        "enabled": false
      }
    },
    "outputs": []
  },
  "status": {
    "state": "Stopped",
    "health": {
      "severity": "Clear"
    },
    "inputs": [],
    "outputs": [],
    "syncState": "Ok",
    "syncError": [],
    "errors": [],
    "unsyncedFields": []
  },
  "serviceIds": [
    "string"
  ]
}