Set a video's visibility

PUT/media/v1/projects/{projectId}/videos/{videoId}/visibility

Updates a video's visibility (public, unlisted, or private). Requires project access.

Authorization

Bearer

Authorization<token>

In: header

Path Parameters

projectId*string

Project ID

videoId*string

Video ID

Request Body

required

application/json

{
  "$ref": "#/components/schemas/internal_media.updateVisibilityBody",
  "$ref-value": {
    "properties": {
      "visibility": {
        "enum": [
          "public",
          "unlisted",
          "private"
        ],
        "type": "string"
      }
    },
    "required": [
      "visibility"
    ],
    "type": "object"
  }
}

Response Body

200application/json

type: unknown

{
  "$ref": "#/components/schemas/videosv1.GetVideoResponse",
  "$ref-value": {
    "properties": {
      "bitrate": {
        "type": "integer"
      },
      "codec": {
        "type": "string"
      },
      "duration": {
        "type": "number"
      },
      "framerate": {
        "type": "string"
      },
      "hdr": {
        "type": "boolean"
      },
      "height": {
        "type": "integer"
      },
      "id": {
        "type": "string"
      },
      "visibility": {
        "$ref": "#/components/schemas/videosv1.Visibility",
        "$ref-value": {
          "enum": [
            0,
            1,
            2,
            3
          ],
          "type": "integer",
          "x-enum-varnames": [
            "Visibility_VISIBILITY_UNSPECIFIED",
            "Visibility_VISIBILITY_PUBLIC",
            "Visibility_VISIBILITY_UNLISTED",
            "Visibility_VISIBILITY_PRIVATE"
          ]
        }
      },
      "width": {
        "type": "integer"
      }
    },
    "type": "object"
  }
}

curl -X PUT "https://api.rixl.com/media/v1/projects/string/videos/string/visibility" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "public"
  }'

application/json

{
  "$ref": "#/components/schemas/videosv1.GetVideoResponse",
  "$ref-value": {
    "properties": {
      "bitrate": {
        "type": "integer"
      },
      "codec": {
        "type": "string"
      },
      "duration": {
        "type": "number"
      },
      "framerate": {
        "type": "string"
      },
      "hdr": {
        "type": "boolean"
      },
      "height": {
        "type": "integer"
      },
      "id": {
        "type": "string"
      },
      "visibility": {
        "$ref": "#/components/schemas/videosv1.Visibility",
        "$ref-value": {
          "enum": [
            0,
            1,
            2,
            3
          ],
          "type": "integer",
          "x-enum-varnames": [
            "Visibility_VISIBILITY_UNSPECIFIED",
            "Visibility_VISIBILITY_PUBLIC",
            "Visibility_VISIBILITY_UNLISTED",
            "Visibility_VISIBILITY_PRIVATE"
          ]
        }
      },
      "width": {
        "type": "integer"
      }
    },
    "type": "object"
  }
}