---
updatedAt: 2025-02-13T23:30:13.000Z
agentTools:
  projectIndex: https://kollus-live.readme.io/llms.txt
---

# 파일 전송처 사용 여부 수정

파일 전송처 사용 여부를 수정합니다. <br><br> 접근 가능한 권한: 최고관리자, 관리자, 운영자

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Kollus Live API (KR)",
    "description": "\n<h3>Usage</h3>\n<ol>\n<li>일반적인 Oauth2 API Spec 을 준수합니다.</li>\n<li>API 인증을 위해 Client_ID, Client_Secret 등이 필요합니다. Kollus Live Console 에서 발급 하실수 있습니다.</li>\n<li>이 API 문서페이지(Swagger UI) 테스트하려면 Kollus Live Console 에서 Client 생성시 Redirect URL 에\n'https://live-kr.kollus.com/api/oauth2-callback' 를 등록해야 합니다.</li>\n<li>Kollus Live Console 에서 Client 생성/수정시 Redirect URL 가 복수개일 경우 ',' 를 구분자로 복수개를 입력할 수 있습니다.</li>\n<li>Update 관련 API 는 수정하려는 필드만 반영됩니다.\n이 API 문서페이지(Swagger UI)에서는 테스트 할 경우 자칫 수정하려는 필드대신 다른필드가 수정될 수 있습니다.<br/>\nUpdate Api 는 되도록이면 이 API 문서페이지(Swagger UI)에서는 테스트를 삼가하시길 바랍니다.</li>\n<li>API 호출은 1분당 60번만 가능합니다. 연속적으로 API 호출을 할때에는 최소 1초의 인터벌을 주시길 바랍니다.</li>\n</ol>\n<h4>Supported Credentials</h4>\n<ul>\n<li>Authorization Code</li>\n<li>Personal Access Token</li>\n</ul>\n<h4>Scope List</h4>\n<p>Access Token 요청시 Scope 를 명시해야 합니다. 복수의 Scope 는 ' '(공백)으로 구분자로 문자열을 만듭니다. ex) 'live:control live:statistics'</p>\n<ul>\n<li>live:control : 라이브 콘솔 컨트롤</li>\n<li>live:statistics : 라이브 통계</li>\n</ul>\n<h4>Role List</h4>\n<p>API 를 사용하는 유저의 role 에 따라 API 접근도 제한됩니다. API 문서 설명부분에 허가되는 role 에 대해 설명이 있습니다.</p>\n<ul>\n<li>Owner : 최고관리자</li>\n<li>Manager : 관리자</li>\n<li>Viewer : 운영자</li>\n</ul>\n",
    "contact": {},
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api-live-kr.kollus.com/api",
      "description": "Kollus Live API"
    }
  ],
  "paths": {
    "/v1/live/service-accounts/{service_account_key}/channels/{channel_key}/file-transfers/{file_transfer_id}/status": {
      "put": {
        "tags": [
          "파일 전송처 관리"
        ],
        "summary": "파일 전송처 사용 여부 수정",
        "description": "파일 전송처 사용 여부를 수정합니다. <br><br> 접근 가능한 권한: 최고관리자, 관리자, 운영자",
        "operationId": "16b01651f49114c89e5971b1dee88d22",
        "parameters": [
          {
            "name": "service_account_key",
            "in": "path",
            "description": "서비스 계정 키",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "channel_key",
            "in": "path",
            "description": "채널 키",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "file_transfer_id",
            "in": "path",
            "description": "파일 전송처 ID",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "required": [
                  "status"
                ],
                "properties": {
                  "status": {
                    "description": "사용 여부",
                    "type": "integer",
                    "default": 0,
                    "enum": [
                      0,
                      1
                    ]
                  }
                },
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ApiOpenLiveMediaFileTransfer"
                    }
                  },
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Bad request"
          },
          "401": {
            "description": "Unauthenticated"
          },
          "404": {
            "description": "Not found"
          },
          "422": {
            "description": "Unprocessable entity"
          }
        },
        "security": [
          {
            "kollus_oauth2": [
              "live:control"
            ]
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "ApiOpenLiveMediaFileTransfer": {
        "description": "파일 전송처",
        "properties": {
          "id": {
            "description": "아이디",
            "type": "integer"
          },
          "title": {
            "description": "제목",
            "type": "string"
          },
          "host": {
            "description": "Host(ftp, kollus)",
            "type": "string"
          },
          "port": {
            "description": "Port(ftp)",
            "type": "string"
          },
          "username": {
            "description": "User Name(ftp, kollus)",
            "type": "string"
          },
          "password": {
            "description": "Password(ftp, kollus)",
            "type": "string"
          },
          "remote_path": {
            "description": "Remote Path(ftp)",
            "type": "string"
          },
          "category_key": {
            "description": "카테고리 키(kollus)",
            "type": "string"
          },
          "use_encryption": {
            "description": "encryption 사용 여부(kollus)",
            "type": "boolean"
          },
          "aws_access_key_id": {
            "description": "AWS S3 access key 정보(S3)",
            "type": "string"
          },
          "aws_secret_access_key": {
            "description": "AWS S3 secret access key 정보(S3)",
            "type": "string"
          },
          "bucket_name": {
            "description": "S3 버킷 명(S3)",
            "type": "string"
          },
          "aws_region_key": {
            "description": "AWS S3 region key 정보(S3)",
            "type": "string"
          },
          "status": {
            "description": "사용 여부",
            "type": "boolean"
          },
          "created_at": {
            "description": "생성일",
            "type": "string"
          },
          "updated_at": {
            "description": "수정일",
            "type": "string"
          }
        },
        "type": "object"
      }
    },
    "securitySchemes": {
      "kollus_oauth2": {
        "type": "oauth2",
        "description": "Kollus oauth2 security.",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://live-kr.kollus.com/oauth/authorize",
            "tokenUrl": "https://live-kr.kollus.com/oauth/token",
            "refreshUrl": "https://live-kr.kollus.com/token/refresh",
            "scopes": {
              "live:control": "Live Control",
              "live:statistics": "Live Statistics"
            }
          },
          "clientCredentials": {
            "tokenUrl": "https://live-kr.kollus.com/oauth/token",
            "refreshUrl": "https://live-kr.kollus.com/token/refresh",
            "scopes": {
              "live:creator": "Live Creator App",
              "platform-app": "Platform Api Actions"
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```