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

# 파일 할당량 조회

> - 현재 사용자의 파일 사용량 및 남은 할당량 조회
- 기본 사용자 그룹은 최대 `2000`개 파일 허용

**참고:**
파일 API의 기본 URL은 `https://files-api.evolink.ai`입니다



## OpenAPI

````yaml ko/api-manual/file-series/quota.json GET /api/v1/files/quota
openapi: 3.1.0
info:
  title: 파일 할당량 API
  description: 현재 사용자의 파일 사용량 및 남은 할당량 조회
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://files-api.evolink.ai
    description: 파일 서비스 환경
security:
  - bearerAuth: []
tags:
  - name: 파일 관리
    description: 파일 관리 관련 API
paths:
  /api/v1/files/quota:
    get:
      tags:
        - 파일 관리
      summary: 파일 할당량 조회
      description: |-
        - 현재 사용자의 파일 사용량 및 남은 할당량 조회
        - 기본 사용자 그룹은 최대 `2000`개 파일 허용

        **참고:**
        파일 API의 기본 URL은 `https://files-api.evolink.ai`입니다
      operationId: getFilesQuota
      responses:
        '200':
          description: 성공
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuotaResponse'
              example:
                success: true
                code: 200
                data:
                  user_group: default
                  used_files: 35
                  max_files: 2000
                  remain_files: 65
                  is_custom: false
                  quota_reason: ''
components:
  schemas:
    QuotaResponse:
      type: object
      properties:
        success:
          type: boolean
          description: 요청 성공 여부
          example: true
        code:
          type: integer
          description: 응답 상태 코드
          example: 200
        data:
          $ref: '#/components/schemas/QuotaData'
    QuotaData:
      type: object
      properties:
        user_group:
          type: string
          description: '사용자 그룹: `default`（기본 할당량 2000개 파일）'
          example: default
        used_files:
          type: integer
          description: 현재 저장된 파일 수
          example: 35
        max_files:
          type: integer
          description: 최대 허용 파일 수
          example: 2000
        remain_files:
          type: integer
          description: 남은 업로드 가능 수
          example: 65
        is_custom:
          type: boolean
          description: 관리자가 수동으로 설정한 사용자 지정 할당량 여부
          example: false
        quota_reason:
          type: string
          description: 사용자 지정 할당량 이유（`is_custom`이 `true`인 경우에만 설정）
          example: ''
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: |-
        ##모든 API는 Bearer Token 인증이 필요합니다##

        **API Key 받기:**

        [API Key 관리 페이지](https://evolink.ai/dashboard/keys)를 방문하여 API Key를 받으세요

        **요청 헤더에 추가:**
        ```
        Authorization: Bearer YOUR_API_KEY
        ```

````