Gitea Settings API

openapi: 3.2.0
info:
  description: This documentation describes the Gitea API.
  title: Gitea Settings API
  license:
    name: MIT
    url: http://opensource.org/licenses/MIT
  version: 1.27.0+dev-89-gf52b6f3315
servers:
- url: /api/v1
security:
- BasicAuth: []
- Token: []
- AccessToken: []
- AuthorizationHeaderToken: []
- SudoParam: []
- SudoHeader: []
- TOTPHeader: []
tags:
- name: Settings
paths:
  /settings/api:
    get:
      tags:
      - Settings
      summary: Get instance's global settings for api
      operationId: getGeneralAPISettings
      responses:
        '200':
          $ref: '#/components/responses/GeneralAPISettings'
  /settings/attachment:
    get:
      tags:
      - Settings
      summary: Get instance's global settings for Attachment
      operationId: getGeneralAttachmentSettings
      responses:
        '200':
          $ref: '#/components/responses/GeneralAttachmentSettings'
  /settings/repository:
    get:
      tags:
      - Settings
      summary: Get instance's global settings for repositories
      operationId: getGeneralRepositorySettings
      responses:
        '200':
          $ref: '#/components/responses/GeneralRepoSettings'
  /settings/ui:
    get:
      tags:
      - Settings
      summary: Get instance's global settings for ui
      operationId: getGeneralUISettings
      responses:
        '200':
          $ref: '#/components/responses/GeneralUISettings'
components:
  schemas:
    GeneralUISettings:
      description: GeneralUISettings contains global ui settings exposed by API
      type: object
      properties:
        allowed_reactions:
          description: AllowedReactions contains the list of allowed emoji reactions
          type: array
          items:
            type: string
          x-go-name: AllowedReactions
        custom_emojis:
          description: CustomEmojis contains the list of custom emojis
          type: array
          items:
            type: string
          x-go-name: CustomEmojis
        default_theme:
          description: DefaultTheme is the default UI theme
          type: string
          x-go-name: DefaultTheme
      x-go-package: code.gitea.io/gitea/modules/structs
    GeneralAPISettings:
      description: GeneralAPISettings contains global api settings exposed by it
      type: object
      properties:
        default_git_trees_per_page:
          description: DefaultGitTreesPerPage is the default number of Git tree items per page
          type: integer
          format: int64
          x-go-name: DefaultGitTreesPerPage
        default_max_blob_size:
          description: DefaultMaxBlobSize is the default maximum blob size for API responses
          type: integer
          format: int64
          x-go-name: DefaultMaxBlobSize
        default_max_response_size:
          description: DefaultMaxResponseSize is the default maximum response size
          type: integer
          format: int64
          x-go-name: DefaultMaxResponseSize
        default_paging_num:
          description: DefaultPagingNum is the default number of items per page
          type: integer
          format: int64
          x-go-name: DefaultPagingNum
        max_response_items:
          description: MaxResponseItems is the maximum number of items returned in API responses
          type: integer
          format: int64
          x-go-name: MaxResponseItems
      x-go-package: code.gitea.io/gitea/modules/structs
    GeneralRepoSettings:
      description: GeneralRepoSettings contains global repository settings exposed by API
      type: object
      properties:
        http_git_disabled:
          description: HTTPGitDisabled indicates if HTTP Git operations are disabled
          type: boolean
          x-go-name: HTTPGitDisabled
        lfs_disabled:
          description: LFSDisabled indicates if Git LFS support is disabled
          type: boolean
          x-go-name: LFSDisabled
        migrations_disabled:
          description: MigrationsDisabled indicates if repository migrations are disabled
          type: boolean
          x-go-name: MigrationsDisabled
        mirrors_disabled:
          description: MirrorsDisabled indicates if repository mirroring is disabled
          type: boolean
          x-go-name: MirrorsDisabled
        stars_disabled:
          description: StarsDisabled indicates if repository starring is disabled
          type: boolean
          x-go-name: StarsDisabled
        time_tracking_disabled:
          description: TimeTrackingDisabled indicates if time tracking is disabled
          type: boolean
          x-go-name: TimeTrackingDisabled
      x-go-package: code.gitea.io/gitea/modules/structs
    GeneralAttachmentSettings:
      description: GeneralAttachmentSettings contains global Attachment settings exposed by API
      type: object
      properties:
        allowed_types:
          description: AllowedTypes contains the allowed file types for attachments
          type: string
          x-go-name: AllowedTypes
        enabled:
          description: Enabled indicates if file attachments are enabled
          type: boolean
          x-go-name: Enabled
        max_files:
          description: MaxFiles is the maximum number of files per attachment
          type: integer
          format: int64
          x-go-name: MaxFiles
        max_size:
          description: MaxSize is the maximum size for individual attachments
          type: integer
          format: int64
          x-go-name: MaxSize
      x-go-package: code.gitea.io/gitea/modules/structs
  responses:
    GeneralAPISettings:
      description: GeneralAPISettings
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GeneralAPISettings'
    GeneralRepoSettings:
      description: GeneralRepoSettings
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GeneralRepoSettings'
    GeneralUISettings:
      description: GeneralUISettings
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GeneralUISettings'
    GeneralAttachmentSettings:
      description: GeneralAttachmentSettings
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GeneralAttachmentSettings'
  securitySchemes:
    AccessToken:
      description: This authentication option is deprecated for removal in Gitea 1.23. Please use AuthorizationHeaderToken instead.
      type: apiKey
      name: access_token
      in: query
    AuthorizationHeaderToken:
      description: API tokens must be prepended with "token" followed by a space.
      type: apiKey
      name: Authorization
      in: header
    BasicAuth:
      type: http
      scheme: basic
    SudoHeader:
      description: Sudo API request as the user provided as the key. Admin privileges are required.
      type: apiKey
      name: Sudo
      in: header
    SudoParam:
      description: Sudo API request as the user provided as the key. Admin privileges are required.
      type: apiKey
      name: sudo
      in: query
    TOTPHeader:
      description: Must be used in combination with BasicAuth if two-factor authentication is enabled.
      type: apiKey
      name: X-GITEA-OTP
      in: header
    Token:
      description: This authentication option is deprecated for removal in Gitea 1.23. Please use AuthorizationHeaderToken instead.
      type: apiKey
      name: token
      in: query