> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tenbyte.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Security Settings

> Update a library’s security configurations such as access level, allowed domains, or token-based restrictions.



## OpenAPI

````yaml https://raw.githubusercontent.com/vidinfra/open-api-docs/refs/heads/main/openapi.json put /libraries/{libraryId}/security
openapi: 3.0.1
info:
  title: Default module
  description: ''
  version: 1.0.0
servers:
  - url: https://api.tenbyte.io/v1/vidinfra
    description: Production server
security:
  - bearer: []
tags:
  - name: Library
  - name: Folder
  - name: Video
  - name: Subtitle
  - name: Video Thumbnails
  - name: Transcoding Profiles
  - name: Player Themes
  - name: Video Chapter
  - name: Webhook Endpoints
  - name: Webhook Deliveries
  - name: Security
  - name: Video Multipart Upload
  - name: Webhook
  - name: Migration Jobs
paths:
  /libraries/{libraryId}/security:
    put:
      tags:
        - Security
      summary: Update Security Settings
      description: >-
        Update a library’s security configurations such as access level, allowed
        domains, or token-based restrictions.
      parameters:
        - name: libraryId
          in: path
          description: Unique identifier of the library.
          required: true
          example: 314221a1-3cbf-4d3c-846e-f6c22bc43064
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                referrers:
                  type: object
                  description: Defines domain-level access control based on HTTP referrers.
                  properties:
                    action:
                      type: string
                      description: >-
                        Specifies whether the listed domains are 'allow' or
                        'block' actions.
                    values:
                      type: array
                      items:
                        type: string
                      description: >-
                        List of domain names or patterns to allow or block
                        (e.g., 'example.com', '*.trustedsite.com').
                    enabled:
                      type: boolean
                      description: >-
                        Determines whether referrer-based restrictions are
                        active.
                  required:
                    - action
                    - values
                    - enabled
                countries:
                  type: object
                  description: Defines geo-based access control based on viewer country.
                  properties:
                    action:
                      type: string
                      description: >-
                        Specifies whether the listed countries are 'allow' or
                        'block' actions.
                    values:
                      type: array
                      items:
                        type: string
                      description: >-
                        List of ISO 3166-1 alpha-2 country codes to allow or
                        block (e.g., 'US', 'BD', 'IN').
                    enabled:
                      type: boolean
                      description: >-
                        Determines whether country-based access restrictions are
                        active.
                  required:
                    - action
                    - values
                    - enabled
                video_privacy:
                  type: string
                  description: >-
                    Sets the default privacy level for videos. Possible values:
                    'public', 'private', or 'restricted'.
              required:
                - referrers
                - countries
                - video_privacy
            example:
              referrers:
                action: allow
                values:
                  - example.com
                  - partner.com
                enabled: true
              countries:
                action: deny
                values:
                  - RU
                  - CN
                enabled: true
              video_privacy: private
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      whitelist_referrers:
                        type: object
                        properties:
                          action:
                            type: string
                          values:
                            type: array
                            items:
                              type: string
                          enabled:
                            type: boolean
                        required:
                          - action
                          - values
                          - enabled
                      blocked_countries:
                        type: object
                        properties:
                          action:
                            type: string
                          values:
                            type: array
                            items:
                              type: string
                          enabled:
                            type: boolean
                        required:
                          - action
                          - values
                          - enabled
                      video_privacy:
                        type: string
                    required:
                      - whitelist_referrers
                      - blocked_countries
                      - video_privacy
                  message:
                    type: string
                  success:
                    type: boolean
                required:
                  - data
                  - message
                  - success
              example:
                data:
                  whitelist_referrers:
                    action: allow
                    values:
                      - www.vidinfra.com
                      - app.partnerdomain.com
                    enabled: false
                  blocked_countries:
                    action: allow
                    values:
                      - CN
                      - RU
                    enabled: false
                  video_privacy: unlisted
                message: Security Settings Updated Successfully
                success: true
          headers: {}
        '400':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  success:
                    type: boolean
                required:
                  - message
                  - success
              example:
                message: Invalid Request
                success: false
          headers: {}
        '401':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  success:
                    type: boolean
                required:
                  - code
                  - message
                  - success
              example:
                code: auth_type_not_found
                message: >-
                  Could not determine authentication type from request. Please
                  provide a valid Authorization header or X-API-Key header.
                success: false
          headers: {}
        '404':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  success:
                    type: boolean
                required:
                  - message
                  - success
              example:
                message: Resource not found
                success: false
          headers: {}
        '422':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                        code:
                          type: string
                        message:
                          type: string
                  success:
                    type: boolean
                required:
                  - message
                  - errors
                  - success
              example:
                message: Invalid Request
                errors:
                  - field: field_name
                    code: validation_required
                    message: This field is required
                success: false
          headers: {}
        '500':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  success:
                    type: boolean
                required:
                  - message
                  - success
              example:
                message: Internal server error
                success: false
          headers: {}
      deprecated: false
      security:
        - bearer: []
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````