ARCHIVED-graphql/src/schemas/gitea.yml

consumes:
  - application/json
  - text/plain
produces:
  - application/json
  - text/html
schemes:
  - http
  - https
swagger: '2.0'
info:
  description: This documentation describes the Gitea API.
  title: Gitea API.
  license:
    name: MIT
    url: http://opensource.org/licenses/MIT
  version: 1.19.4
basePath: https://gitea.com/api/v1
paths:
  /activitypub/user-id/{user-id}:
    get:
      produces:
        - application/json
      tags:
        - activitypub
      summary: Returns the Person actor for a user
      operationId: activitypubPerson
      parameters:
        - type: integer
          description: user ID of the user
          name: user-id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/ActivityPub'
  /activitypub/user-id/{user-id}/inbox:
    post:
      produces:
        - application/json
      tags:
        - activitypub
      summary: Send to the inbox
      operationId: activitypubPersonInbox
      parameters:
        - type: integer
          description: user ID of the user
          name: user-id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
  /admin/cron:
    get:
      produces:
        - application/json
      tags:
        - admin
      summary: List cron tasks
      operationId: adminCronList
      parameters:
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/CronList'
        '403':
          $ref: '#/responses/forbidden'
  /admin/cron/{task}:
    post:
      produces:
        - application/json
      tags:
        - admin
      summary: Run cron task
      operationId: adminCronRun
      parameters:
        - type: string
          description: task to run
          name: task
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/notFound'
  /admin/hooks:
    get:
      produces:
        - application/json
      tags:
        - admin
      summary: List system's webhooks
      operationId: adminListHooks
      parameters:
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/HookList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - admin
      summary: Create a hook
      operationId: adminCreateHook
      parameters:
        - name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/CreateHookOption'
      responses:
        '201':
          $ref: '#/responses/Hook'
  /admin/hooks/{id}:
    get:
      produces:
        - application/json
      tags:
        - admin
      summary: Get a hook
      operationId: adminGetHook
      parameters:
        - type: integer
          format: int64
          description: id of the hook to get
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Hook'
    delete:
      produces:
        - application/json
      tags:
        - admin
      summary: Delete a hook
      operationId: adminDeleteHook
      parameters:
        - type: integer
          format: int64
          description: id of the hook to delete
          name: id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
    patch:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - admin
      summary: Update a hook
      operationId: adminEditHook
      parameters:
        - type: integer
          format: int64
          description: id of the hook to update
          name: id
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/EditHookOption'
      responses:
        '200':
          $ref: '#/responses/Hook'
  /admin/orgs:
    get:
      produces:
        - application/json
      tags:
        - admin
      summary: List all organizations
      operationId: adminGetAllOrgs
      parameters:
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/OrganizationList'
        '403':
          $ref: '#/responses/forbidden'
  /admin/unadopted:
    get:
      produces:
        - application/json
      tags:
        - admin
      summary: List unadopted repositories
      operationId: adminUnadoptedList
      parameters:
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
        - type: string
          description: pattern of repositories to search for
          name: pattern
          in: query
      responses:
        '200':
          $ref: '#/responses/StringSlice'
        '403':
          $ref: '#/responses/forbidden'
  /admin/unadopted/{owner}/{repo}:
    post:
      produces:
        - application/json
      tags:
        - admin
      summary: Adopt unadopted files as a repository
      operationId: adminAdoptRepository
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
    delete:
      produces:
        - application/json
      tags:
        - admin
      summary: Delete unadopted files
      operationId: adminDeleteUnadoptedRepository
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
  /admin/users:
    get:
      produces:
        - application/json
      tags:
        - admin
      summary: List all users
      operationId: adminGetAllUsers
      parameters:
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/UserList'
        '403':
          $ref: '#/responses/forbidden'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - admin
      summary: Create a user
      operationId: adminCreateUser
      parameters:
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateUserOption'
      responses:
        '201':
          $ref: '#/responses/User'
        '400':
          $ref: '#/responses/error'
        '403':
          $ref: '#/responses/forbidden'
        '422':
          $ref: '#/responses/validationError'
  /admin/users/{username}:
    delete:
      produces:
        - application/json
      tags:
        - admin
      summary: Delete a user
      operationId: adminDeleteUser
      parameters:
        - type: string
          description: username of user to delete
          name: username
          in: path
          required: true
        - type: boolean
          description: purge the user from the system completely
          name: purge
          in: query
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
        '422':
          $ref: '#/responses/validationError'
    patch:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - admin
      summary: Edit an existing user
      operationId: adminEditUser
      parameters:
        - type: string
          description: username of user to edit
          name: username
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/EditUserOption'
      responses:
        '200':
          $ref: '#/responses/User'
        '403':
          $ref: '#/responses/forbidden'
        '422':
          $ref: '#/responses/validationError'
  /admin/users/{username}/keys:
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - admin
      summary: Add a public key on behalf of a user
      operationId: adminCreatePublicKey
      parameters:
        - type: string
          description: username of the user
          name: username
          in: path
          required: true
        - name: key
          in: body
          schema:
            $ref: '#/definitions/CreateKeyOption'
      responses:
        '201':
          $ref: '#/responses/PublicKey'
        '403':
          $ref: '#/responses/forbidden'
        '422':
          $ref: '#/responses/validationError'
  /admin/users/{username}/keys/{id}:
    delete:
      produces:
        - application/json
      tags:
        - admin
      summary: Delete a user's public key
      operationId: adminDeleteUserPublicKey
      parameters:
        - type: string
          description: username of user
          name: username
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the key to delete
          name: id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
  /admin/users/{username}/orgs:
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - admin
      summary: Create an organization
      operationId: adminCreateOrg
      parameters:
        - type: string
          description: username of the user that will own the created organization
          name: username
          in: path
          required: true
        - name: organization
          in: body
          required: true
          schema:
            $ref: '#/definitions/CreateOrgOption'
      responses:
        '201':
          $ref: '#/responses/Organization'
        '403':
          $ref: '#/responses/forbidden'
        '422':
          $ref: '#/responses/validationError'
  /admin/users/{username}/repos:
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - admin
      summary: Create a repository on behalf of a user
      operationId: adminCreateRepo
      parameters:
        - type: string
          description: username of the user. This user will own the created repository
          name: username
          in: path
          required: true
        - name: repository
          in: body
          required: true
          schema:
            $ref: '#/definitions/CreateRepoOption'
      responses:
        '201':
          $ref: '#/responses/Repository'
        '400':
          $ref: '#/responses/error'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
        '409':
          $ref: '#/responses/error'
        '422':
          $ref: '#/responses/validationError'
  /markdown:
    post:
      consumes:
        - application/json
      produces:
        - text/html
      tags:
        - miscellaneous
      summary: Render a markdown document as HTML
      operationId: renderMarkdown
      parameters:
        - name: body
          in: body
          schema:
            $ref: '#/definitions/MarkdownOption'
      responses:
        '200':
          $ref: '#/responses/MarkdownRender'
        '422':
          $ref: '#/responses/validationError'
  /markdown/raw:
    post:
      consumes:
        - text/plain
      produces:
        - text/html
      tags:
        - miscellaneous
      summary: Render raw markdown as HTML
      operationId: renderMarkdownRaw
      parameters:
        - description: Request body to render
          name: body
          in: body
          required: true
          schema:
            type: string
      responses:
        '200':
          $ref: '#/responses/MarkdownRender'
        '422':
          $ref: '#/responses/validationError'
  /nodeinfo:
    get:
      produces:
        - application/json
      tags:
        - miscellaneous
      summary: Returns the nodeinfo of the Gitea application
      operationId: getNodeInfo
      responses:
        '200':
          $ref: '#/responses/NodeInfo'
  /notifications:
    get:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - notification
      summary: List users's notification threads
      operationId: notifyGetList
      parameters:
        - type: boolean
          description: If true, show notifications marked as read. Default value is false
          name: all
          in: query
        - type: array
          items:
            type: string
          collectionFormat: multi
          description: >-
            Show notifications with the provided status types. Options are:
            unread, read and/or pinned. Defaults to unread & pinned.
          name: status-types
          in: query
        - type: array
          items:
            enum:
              - issue
              - pull
              - commit
              - repository
            type: string
          collectionFormat: multi
          description: filter notifications by subject type
          name: subject-type
          in: query
        - type: string
          format: date-time
          description: >-
            Only show notifications updated after the given time. This is a
            timestamp in RFC 3339 format
          name: since
          in: query
        - type: string
          format: date-time
          description: >-
            Only show notifications updated before the given time. This is a
            timestamp in RFC 3339 format
          name: before
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/NotificationThreadList'
    put:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - notification
      summary: Mark notification threads as read, pinned or unread
      operationId: notifyReadList
      parameters:
        - type: string
          format: date-time
          description: >-
            Describes the last point that notifications were checked. Anything
            updated since this time will not be updated.
          name: last_read_at
          in: query
        - type: string
          description: If true, mark all notifications on this repo. Default value is false
          name: all
          in: query
        - type: array
          items:
            type: string
          collectionFormat: multi
          description: >-
            Mark notifications with the provided status types. Options are:
            unread, read and/or pinned. Defaults to unread.
          name: status-types
          in: query
        - type: string
          description: Status to mark notifications as, Defaults to read.
          name: to-status
          in: query
      responses:
        '205':
          $ref: '#/responses/NotificationThreadList'
  /notifications/new:
    get:
      tags:
        - notification
      summary: Check if unread notifications exist
      operationId: notifyNewAvailable
      responses:
        '200':
          $ref: '#/responses/NotificationCount'
  /notifications/threads/{id}:
    get:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - notification
      summary: Get notification thread by ID
      operationId: notifyGetThread
      parameters:
        - type: string
          description: id of notification thread
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/NotificationThread'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
    patch:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - notification
      summary: Mark notification thread as read by ID
      operationId: notifyReadThread
      parameters:
        - type: string
          description: id of notification thread
          name: id
          in: path
          required: true
        - type: string
          default: read
          description: Status to mark notifications as
          name: to-status
          in: query
      responses:
        '205':
          $ref: '#/responses/NotificationThread'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
  /org/{org}/repos:
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - organization
      summary: Create a repository in an organization
      operationId: createOrgRepoDeprecated
      deprecated: true
      parameters:
        - type: string
          description: name of organization
          name: org
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateRepoOption'
      responses:
        '201':
          $ref: '#/responses/Repository'
        '403':
          $ref: '#/responses/forbidden'
        '422':
          $ref: '#/responses/validationError'
  /orgs:
    get:
      produces:
        - application/json
      tags:
        - organization
      summary: Get list of organizations
      operationId: orgGetAll
      parameters:
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/OrganizationList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - organization
      summary: Create an organization
      operationId: orgCreate
      parameters:
        - name: organization
          in: body
          required: true
          schema:
            $ref: '#/definitions/CreateOrgOption'
      responses:
        '201':
          $ref: '#/responses/Organization'
        '403':
          $ref: '#/responses/forbidden'
        '422':
          $ref: '#/responses/validationError'
  /orgs/{org}:
    get:
      produces:
        - application/json
      tags:
        - organization
      summary: Get an organization
      operationId: orgGet
      parameters:
        - type: string
          description: name of the organization to get
          name: org
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Organization'
    delete:
      produces:
        - application/json
      tags:
        - organization
      summary: Delete an organization
      operationId: orgDelete
      parameters:
        - type: string
          description: organization that is to be deleted
          name: org
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
    patch:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - organization
      summary: Edit an organization
      operationId: orgEdit
      parameters:
        - type: string
          description: name of the organization to edit
          name: org
          in: path
          required: true
        - name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/EditOrgOption'
      responses:
        '200':
          $ref: '#/responses/Organization'
  /orgs/{org}/hooks:
    get:
      produces:
        - application/json
      tags:
        - organization
      summary: List an organization's webhooks
      operationId: orgListHooks
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/HookList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - organization
      summary: Create a hook
      operationId: orgCreateHook
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/CreateHookOption'
      responses:
        '201':
          $ref: '#/responses/Hook'
  /orgs/{org}/hooks/{id}:
    get:
      produces:
        - application/json
      tags:
        - organization
      summary: Get a hook
      operationId: orgGetHook
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the hook to get
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Hook'
    delete:
      produces:
        - application/json
      tags:
        - organization
      summary: Delete a hook
      operationId: orgDeleteHook
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the hook to delete
          name: id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
    patch:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - organization
      summary: Update a hook
      operationId: orgEditHook
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the hook to update
          name: id
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/EditHookOption'
      responses:
        '200':
          $ref: '#/responses/Hook'
  /orgs/{org}/labels:
    get:
      produces:
        - application/json
      tags:
        - organization
      summary: List an organization's labels
      operationId: orgListLabels
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/LabelList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - organization
      summary: Create a label for an organization
      operationId: orgCreateLabel
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateLabelOption'
      responses:
        '201':
          $ref: '#/responses/Label'
        '422':
          $ref: '#/responses/validationError'
  /orgs/{org}/labels/{id}:
    get:
      produces:
        - application/json
      tags:
        - organization
      summary: Get a single label
      operationId: orgGetLabel
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the label to get
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Label'
    delete:
      tags:
        - organization
      summary: Delete a label
      operationId: orgDeleteLabel
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the label to delete
          name: id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
    patch:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - organization
      summary: Update a label
      operationId: orgEditLabel
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the label to edit
          name: id
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/EditLabelOption'
      responses:
        '200':
          $ref: '#/responses/Label'
        '422':
          $ref: '#/responses/validationError'
  /orgs/{org}/members:
    get:
      produces:
        - application/json
      tags:
        - organization
      summary: List an organization's members
      operationId: orgListMembers
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/UserList'
  /orgs/{org}/members/{username}:
    get:
      tags:
        - organization
      summary: Check if a user is a member of an organization
      operationId: orgIsMember
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - type: string
          description: username of the user
          name: username
          in: path
          required: true
      responses:
        '204':
          description: user is a member
        '303':
          description: redirection to /orgs/{org}/public_members/{username}
        '404':
          description: user is not a member
    delete:
      produces:
        - application/json
      tags:
        - organization
      summary: Remove a member from an organization
      operationId: orgDeleteMember
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - type: string
          description: username of the user
          name: username
          in: path
          required: true
      responses:
        '204':
          description: member removed
  /orgs/{org}/public_members:
    get:
      produces:
        - application/json
      tags:
        - organization
      summary: List an organization's public members
      operationId: orgListPublicMembers
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/UserList'
  /orgs/{org}/public_members/{username}:
    get:
      tags:
        - organization
      summary: Check if a user is a public member of an organization
      operationId: orgIsPublicMember
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - type: string
          description: username of the user
          name: username
          in: path
          required: true
      responses:
        '204':
          description: user is a public member
        '404':
          description: user is not a public member
    put:
      produces:
        - application/json
      tags:
        - organization
      summary: Publicize a user's membership
      operationId: orgPublicizeMember
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - type: string
          description: username of the user
          name: username
          in: path
          required: true
      responses:
        '204':
          description: membership publicized
        '403':
          $ref: '#/responses/forbidden'
    delete:
      produces:
        - application/json
      tags:
        - organization
      summary: Conceal a user's membership
      operationId: orgConcealMember
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - type: string
          description: username of the user
          name: username
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
  /orgs/{org}/repos:
    get:
      produces:
        - application/json
      tags:
        - organization
      summary: List an organization's repos
      operationId: orgListRepos
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/RepositoryList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - organization
      summary: Create a repository in an organization
      operationId: createOrgRepo
      parameters:
        - type: string
          description: name of organization
          name: org
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateRepoOption'
      responses:
        '201':
          $ref: '#/responses/Repository'
        '400':
          $ref: '#/responses/error'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
  /orgs/{org}/teams:
    get:
      produces:
        - application/json
      tags:
        - organization
      summary: List an organization's teams
      operationId: orgListTeams
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/TeamList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - organization
      summary: Create a team
      operationId: orgCreateTeam
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateTeamOption'
      responses:
        '201':
          $ref: '#/responses/Team'
        '422':
          $ref: '#/responses/validationError'
  /orgs/{org}/teams/search:
    get:
      produces:
        - application/json
      tags:
        - organization
      summary: Search for teams within an organization
      operationId: teamSearch
      parameters:
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
        - type: string
          description: keywords to search
          name: q
          in: query
        - type: boolean
          description: include search within team description (defaults to true)
          name: include_desc
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          description: SearchResults of a successful search
          schema:
            type: object
            properties:
              data:
                type: array
                items:
                  $ref: '#/definitions/Team'
              ok:
                type: boolean
  /packages/{owner}:
    get:
      produces:
        - application/json
      tags:
        - package
      summary: Gets all packages of an owner
      operationId: listPackages
      parameters:
        - type: string
          description: owner of the packages
          name: owner
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
        - enum:
            - cargo
            - chef
            - composer
            - conan
            - conda
            - container
            - generic
            - helm
            - maven
            - npm
            - nuget
            - pub
            - pypi
            - rubygems
            - vagrant
          type: string
          description: package type filter
          name: type
          in: query
        - type: string
          description: name filter
          name: q
          in: query
      responses:
        '200':
          $ref: '#/responses/PackageList'
  /packages/{owner}/{type}/{name}/{version}:
    get:
      produces:
        - application/json
      tags:
        - package
      summary: Gets a package
      operationId: getPackage
      parameters:
        - type: string
          description: owner of the package
          name: owner
          in: path
          required: true
        - type: string
          description: type of the package
          name: type
          in: path
          required: true
        - type: string
          description: name of the package
          name: name
          in: path
          required: true
        - type: string
          description: version of the package
          name: version
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Package'
        '404':
          $ref: '#/responses/notFound'
    delete:
      tags:
        - package
      summary: Delete a package
      operationId: deletePackage
      parameters:
        - type: string
          description: owner of the package
          name: owner
          in: path
          required: true
        - type: string
          description: type of the package
          name: type
          in: path
          required: true
        - type: string
          description: name of the package
          name: name
          in: path
          required: true
        - type: string
          description: version of the package
          name: version
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/notFound'
  /packages/{owner}/{type}/{name}/{version}/files:
    get:
      produces:
        - application/json
      tags:
        - package
      summary: Gets all files of a package
      operationId: listPackageFiles
      parameters:
        - type: string
          description: owner of the package
          name: owner
          in: path
          required: true
        - type: string
          description: type of the package
          name: type
          in: path
          required: true
        - type: string
          description: name of the package
          name: name
          in: path
          required: true
        - type: string
          description: version of the package
          name: version
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/PackageFileList'
        '404':
          $ref: '#/responses/notFound'
  /repos/issues/search:
    get:
      produces:
        - application/json
      tags:
        - issue
      summary: Search for issues across the repositories that the user has access to
      operationId: issueSearchIssues
      parameters:
        - type: string
          description: whether issue is open or closed
          name: state
          in: query
        - type: string
          description: >-
            comma separated list of labels. Fetch only issues that have any of
            this labels. Non existent labels are discarded
          name: labels
          in: query
        - type: string
          description: >-
            comma separated list of milestone names. Fetch only issues that have
            any of this milestones. Non existent are discarded
          name: milestones
          in: query
        - type: string
          description: search string
          name: q
          in: query
        - type: integer
          format: int64
          description: repository to prioritize in the results
          name: priority_repo_id
          in: query
        - type: string
          description: filter by type (issues / pulls) if set
          name: type
          in: query
        - type: string
          format: date-time
          description: >-
            Only show notifications updated after the given time. This is a
            timestamp in RFC 3339 format
          name: since
          in: query
        - type: string
          format: date-time
          description: >-
            Only show notifications updated before the given time. This is a
            timestamp in RFC 3339 format
          name: before
          in: query
        - type: boolean
          description: filter (issues / pulls) assigned to you, default is false
          name: assigned
          in: query
        - type: boolean
          description: filter (issues / pulls) created by you, default is false
          name: created
          in: query
        - type: boolean
          description: filter (issues / pulls) mentioning you, default is false
          name: mentioned
          in: query
        - type: boolean
          description: filter pulls requesting your review, default is false
          name: review_requested
          in: query
        - type: string
          description: filter by owner
          name: owner
          in: query
        - type: string
          description: >-
            filter by team (requires organization owner parameter to be
            provided)
          name: team
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/IssueList'
  /repos/migrate:
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - repository
      summary: Migrate a remote git repository
      operationId: repoMigrate
      parameters:
        - name: body
          in: body
          schema:
            $ref: '#/definitions/MigrateRepoOptions'
      responses:
        '201':
          $ref: '#/responses/Repository'
        '403':
          $ref: '#/responses/forbidden'
        '409':
          description: The repository with the same name already exists.
        '422':
          $ref: '#/responses/validationError'
  /repos/search:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Search for repositories
      operationId: repoSearch
      parameters:
        - type: string
          description: keyword
          name: q
          in: query
        - type: boolean
          description: Limit search to repositories with keyword as topic
          name: topic
          in: query
        - type: boolean
          description: include search of keyword within repository description
          name: includeDesc
          in: query
        - type: integer
          format: int64
          description: >-
            search only for repos that the user with the given id owns or
            contributes to
          name: uid
          in: query
        - type: integer
          format: int64
          description: repo owner to prioritize in the results
          name: priority_owner_id
          in: query
        - type: integer
          format: int64
          description: search only for repos that belong to the given team id
          name: team_id
          in: query
        - type: integer
          format: int64
          description: search only for repos that the user with the given id has starred
          name: starredBy
          in: query
        - type: boolean
          description: >-
            include private repositories this user has access to (defaults to
            true)
          name: private
          in: query
        - type: boolean
          description: show only pubic, private or all repositories (defaults to all)
          name: is_private
          in: query
        - type: boolean
          description: >-
            include template repositories this user has access to (defaults to
            true)
          name: template
          in: query
        - type: boolean
          description: >-
            show only archived, non-archived or all repositories (defaults to
            all)
          name: archived
          in: query
        - type: string
          description: >-
            type of repository to search for. Supported values are "fork",
            "source", "mirror" and "collaborative"
          name: mode
          in: query
        - type: boolean
          description: if `uid` is given, search only for repos that the user owns
          name: exclusive
          in: query
        - type: string
          description: >-
            sort repos by attribute. Supported values are "alpha", "created",
            "updated", "size", and "id". Default is "alpha"
          name: sort
          in: query
        - type: string
          description: >-
            sort order, either "asc" (ascending) or "desc" (descending). Default
            is "asc", ignored if "sort" is not specified.
          name: order
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/SearchResults'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a repository
      operationId: repoGet
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Repository'
    delete:
      produces:
        - application/json
      tags:
        - repository
      summary: Delete a repository
      operationId: repoDelete
      parameters:
        - type: string
          description: owner of the repo to delete
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo to delete
          name: repo
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
    patch:
      produces:
        - application/json
      tags:
        - repository
      summary: >-
        Edit a repository's properties. Only fields that are set will be
        changed.
      operationId: repoEdit
      parameters:
        - type: string
          description: owner of the repo to edit
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo to edit
          name: repo
          in: path
          required: true
        - description: Properties of a repo that you can edit
          name: body
          in: body
          schema:
            $ref: '#/definitions/EditRepoOption'
      responses:
        '200':
          $ref: '#/responses/Repository'
        '403':
          $ref: '#/responses/forbidden'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/archive/{archive}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get an archive of a repository
      operationId: repoGetArchive
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: >-
            the git reference for download with attached archive format (e.g.
            master.zip)
          name: archive
          in: path
          required: true
      responses:
        '200':
          description: success
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/assignees:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Return all users that have write access and can be assigned to issues
      operationId: repoGetAssignees
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/UserList'
  /repos/{owner}/{repo}/branch_protections:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: List branch protections for a repository
      operationId: repoListBranchProtection
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/BranchProtectionList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - repository
      summary: Create a branch protections for a repository
      operationId: repoCreateBranchProtection
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateBranchProtectionOption'
      responses:
        '201':
          $ref: '#/responses/BranchProtection'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/branch_protections/{name}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a specific branch protection for the repository
      operationId: repoGetBranchProtection
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: name of protected branch
          name: name
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/BranchProtection'
        '404':
          $ref: '#/responses/notFound'
    delete:
      produces:
        - application/json
      tags:
        - repository
      summary: Delete a specific branch protection for the repository
      operationId: repoDeleteBranchProtection
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: name of protected branch
          name: name
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/notFound'
    patch:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - repository
      summary: >-
        Edit a branch protections for a repository. Only fields that are set
        will be changed
      operationId: repoEditBranchProtection
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: name of protected branch
          name: name
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/EditBranchProtectionOption'
      responses:
        '200':
          $ref: '#/responses/BranchProtection'
        '404':
          $ref: '#/responses/notFound'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/branches:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: List a repository's branches
      operationId: repoListBranches
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/BranchList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - repository
      summary: Create a branch
      operationId: repoCreateBranch
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateBranchRepoOption'
      responses:
        '201':
          $ref: '#/responses/Branch'
        '404':
          description: The old branch does not exist.
        '409':
          description: The branch with the same name already exists.
  /repos/{owner}/{repo}/branches/{branch}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: >-
        Retrieve a specific branch from a repository, including its effective
        branch protection
      operationId: repoGetBranch
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: branch to get
          name: branch
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Branch'
        '404':
          $ref: '#/responses/notFound'
    delete:
      produces:
        - application/json
      tags:
        - repository
      summary: Delete a specific branch from a repository
      operationId: repoDeleteBranch
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: branch to delete
          name: branch
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/error'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/collaborators:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: List a repository's collaborators
      operationId: repoListCollaborators
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/UserList'
  /repos/{owner}/{repo}/collaborators/{collaborator}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Check if a user is a collaborator of a repository
      operationId: repoCheckCollaborator
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: username of the collaborator
          name: collaborator
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/notFound'
        '422':
          $ref: '#/responses/validationError'
    put:
      produces:
        - application/json
      tags:
        - repository
      summary: Add a collaborator to a repository
      operationId: repoAddCollaborator
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: username of the collaborator to add
          name: collaborator
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/AddCollaboratorOption'
      responses:
        '204':
          $ref: '#/responses/empty'
        '422':
          $ref: '#/responses/validationError'
    delete:
      produces:
        - application/json
      tags:
        - repository
      summary: Delete a collaborator from a repository
      operationId: repoDeleteCollaborator
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: username of the collaborator to delete
          name: collaborator
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/collaborators/{collaborator}/permission:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get repository permissions for a user
      operationId: repoGetRepoPermissions
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: username of the collaborator
          name: collaborator
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/RepoCollaboratorPermission'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/commits:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a list of all commits from a repository
      operationId: repoGetAllCommits
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: SHA or branch to start listing commits from (usually 'master')
          name: sha
          in: query
        - type: string
          description: filepath of a file/dir
          name: path
          in: query
        - type: boolean
          description: >-
            include diff stats for every commit (disable for speedup, default
            'true')
          name: stat
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results (ignored if used with 'path')
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/CommitList'
        '404':
          $ref: '#/responses/notFound'
        '409':
          $ref: '#/responses/EmptyRepository'
  /repos/{owner}/{repo}/commits/{ref}/status:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a commit's combined status, by branch/tag/commit reference
      operationId: repoGetCombinedStatusByRef
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: name of branch/tag/commit
          name: ref
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/CombinedStatus'
        '400':
          $ref: '#/responses/error'
  /repos/{owner}/{repo}/commits/{ref}/statuses:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a commit's statuses, by branch/tag/commit reference
      operationId: repoListStatusesByRef
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: name of branch/tag/commit
          name: ref
          in: path
          required: true
        - enum:
            - oldest
            - recentupdate
            - leastupdate
            - leastindex
            - highestindex
          type: string
          description: type of sort
          name: sort
          in: query
        - enum:
            - pending
            - success
            - error
            - failure
            - warning
          type: string
          description: type of state
          name: state
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/CommitStatusList'
        '400':
          $ref: '#/responses/error'
  /repos/{owner}/{repo}/contents:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Gets the metadata of all the entries of the root dir
      operationId: repoGetContentsList
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: >-
            The name of the commit/branch/tag. Default the repository’s default
            branch (usually master)
          name: ref
          in: query
      responses:
        '200':
          $ref: '#/responses/ContentsListResponse'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/contents/{filepath}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: >-
        Gets the metadata and contents (if a file) of an entry in a repository,
        or a list of entries if a dir
      operationId: repoGetContents
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: path of the dir, file, symlink or submodule in the repo
          name: filepath
          in: path
          required: true
        - type: string
          description: >-
            The name of the commit/branch/tag. Default the repository’s default
            branch (usually master)
          name: ref
          in: query
      responses:
        '200':
          $ref: '#/responses/ContentsResponse'
        '404':
          $ref: '#/responses/notFound'
    put:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - repository
      summary: Update a file in a repository
      operationId: repoUpdateFile
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: path of the file to update
          name: filepath
          in: path
          required: true
        - name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/UpdateFileOptions'
      responses:
        '200':
          $ref: '#/responses/FileResponse'
        '403':
          $ref: '#/responses/error'
        '404':
          $ref: '#/responses/notFound'
        '422':
          $ref: '#/responses/error'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - repository
      summary: Create a file in a repository
      operationId: repoCreateFile
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: path of the file to create
          name: filepath
          in: path
          required: true
        - name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/CreateFileOptions'
      responses:
        '201':
          $ref: '#/responses/FileResponse'
        '403':
          $ref: '#/responses/error'
        '404':
          $ref: '#/responses/notFound'
        '422':
          $ref: '#/responses/error'
    delete:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - repository
      summary: Delete a file in a repository
      operationId: repoDeleteFile
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: path of the file to delete
          name: filepath
          in: path
          required: true
        - name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/DeleteFileOptions'
      responses:
        '200':
          $ref: '#/responses/FileDeleteResponse'
        '400':
          $ref: '#/responses/error'
        '403':
          $ref: '#/responses/error'
        '404':
          $ref: '#/responses/error'
  /repos/{owner}/{repo}/diffpatch:
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - repository
      summary: Apply diff patch to repository
      operationId: repoApplyDiffPatch
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/UpdateFileOptions'
      responses:
        '200':
          $ref: '#/responses/FileResponse'
  /repos/{owner}/{repo}/editorconfig/{filepath}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get the EditorConfig definitions of a file in a repository
      operationId: repoGetEditorConfig
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: filepath of file to get
          name: filepath
          in: path
          required: true
        - type: string
          description: >-
            The name of the commit/branch/tag. Default the repository’s default
            branch (usually master)
          name: ref
          in: query
      responses:
        '200':
          description: success
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/forks:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: List a repository's forks
      operationId: listForks
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/RepositoryList'
    post:
      produces:
        - application/json
      tags:
        - repository
      summary: Fork a repository
      operationId: createFork
      parameters:
        - type: string
          description: owner of the repo to fork
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo to fork
          name: repo
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateForkOption'
      responses:
        '202':
          $ref: '#/responses/Repository'
        '403':
          $ref: '#/responses/forbidden'
        '409':
          description: The repository with the same name already exists.
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/git/blobs/{sha}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Gets the blob of a repository.
      operationId: GetBlob
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: sha of the commit
          name: sha
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/GitBlobResponse'
        '400':
          $ref: '#/responses/error'
  /repos/{owner}/{repo}/git/commits/{sha}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a single commit from a repository
      operationId: repoGetSingleCommit
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: a git ref or commit sha
          name: sha
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Commit'
        '404':
          $ref: '#/responses/notFound'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/git/commits/{sha}.{diffType}:
    get:
      produces:
        - text/plain
      tags:
        - repository
      summary: Get a commit's diff or patch
      operationId: repoDownloadCommitDiffOrPatch
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: SHA of the commit to get
          name: sha
          in: path
          required: true
        - enum:
            - diff
            - patch
          type: string
          description: whether the output is diff or patch
          name: diffType
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/string'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/git/notes/{sha}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a note corresponding to a single commit from a repository
      operationId: repoGetNote
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: a git ref or commit sha
          name: sha
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Note'
        '404':
          $ref: '#/responses/notFound'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/git/refs:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get specified ref or filtered repository's refs
      operationId: repoListAllGitRefs
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/ReferenceList'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/git/refs/{ref}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get specified ref or filtered repository's refs
      operationId: repoListGitRefs
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: part or full name of the ref
          name: ref
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/ReferenceList'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/git/tags/{sha}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Gets the tag object of an annotated tag (not lightweight tags)
      operationId: GetAnnotatedTag
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: >-
            sha of the tag. The Git tags API only supports annotated tag
            objects, not lightweight tags.
          name: sha
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/AnnotatedTag'
        '400':
          $ref: '#/responses/error'
  /repos/{owner}/{repo}/git/trees/{sha}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Gets the tree of a repository.
      operationId: GetTree
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: sha of the commit
          name: sha
          in: path
          required: true
        - type: boolean
          description: show all directories and files
          name: recursive
          in: query
        - type: integer
          description: >-
            page number; the 'truncated' field in the response will be true if
            there are still more items after this page, false if the last page
          name: page
          in: query
        - type: integer
          description: number of items per page
          name: per_page
          in: query
      responses:
        '200':
          $ref: '#/responses/GitTreeResponse'
        '400':
          $ref: '#/responses/error'
  /repos/{owner}/{repo}/hooks:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: List the hooks in a repository
      operationId: repoListHooks
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/HookList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - repository
      summary: Create a hook
      operationId: repoCreateHook
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateHookOption'
      responses:
        '201':
          $ref: '#/responses/Hook'
  /repos/{owner}/{repo}/hooks/git:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: List the Git hooks in a repository
      operationId: repoListGitHooks
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/GitHookList'
  /repos/{owner}/{repo}/hooks/git/{id}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a Git hook
      operationId: repoGetGitHook
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: id of the hook to get
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/GitHook'
        '404':
          $ref: '#/responses/notFound'
    delete:
      produces:
        - application/json
      tags:
        - repository
      summary: Delete a Git hook in a repository
      operationId: repoDeleteGitHook
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: id of the hook to get
          name: id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/notFound'
    patch:
      produces:
        - application/json
      tags:
        - repository
      summary: Edit a Git hook in a repository
      operationId: repoEditGitHook
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: id of the hook to get
          name: id
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/EditGitHookOption'
      responses:
        '200':
          $ref: '#/responses/GitHook'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/hooks/{id}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a hook
      operationId: repoGetHook
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the hook to get
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Hook'
        '404':
          $ref: '#/responses/notFound'
    delete:
      produces:
        - application/json
      tags:
        - repository
      summary: Delete a hook in a repository
      operationId: repoDeleteHook
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the hook to delete
          name: id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/notFound'
    patch:
      produces:
        - application/json
      tags:
        - repository
      summary: Edit a hook in a repository
      operationId: repoEditHook
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the hook
          name: id
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/EditHookOption'
      responses:
        '200':
          $ref: '#/responses/Hook'
  /repos/{owner}/{repo}/hooks/{id}/tests:
    post:
      produces:
        - application/json
      tags:
        - repository
      summary: Test a push webhook
      operationId: repoTestHook
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the hook to test
          name: id
          in: path
          required: true
        - type: string
          description: >-
            The name of the commit/branch/tag, indicates which commit will be
            loaded to the webhook payload.
          name: ref
          in: query
      responses:
        '204':
          $ref: '#/responses/empty'
  /repos/{owner}/{repo}/issue_templates:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get available issue templates for a repository
      operationId: repoGetIssueTemplates
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/IssueTemplates'
  /repos/{owner}/{repo}/issues:
    get:
      produces:
        - application/json
      tags:
        - issue
      summary: List a repository's issues
      operationId: issueListIssues
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - enum:
            - closed
            - open
            - all
          type: string
          description: whether issue is open or closed
          name: state
          in: query
        - type: string
          description: >-
            comma separated list of labels. Fetch only issues that have any of
            this labels. Non existent labels are discarded
          name: labels
          in: query
        - type: string
          description: search string
          name: q
          in: query
        - enum:
            - issues
            - pulls
          type: string
          description: filter by type (issues / pulls) if set
          name: type
          in: query
        - type: string
          description: >-
            comma separated list of milestone names or ids. It uses names and
            fall back to ids. Fetch only issues that have any of this
            milestones. Non existent milestones are discarded
          name: milestones
          in: query
        - type: string
          format: date-time
          description: >-
            Only show items updated after the given time. This is a timestamp in
            RFC 3339 format
          name: since
          in: query
        - type: string
          format: date-time
          description: >-
            Only show items updated before the given time. This is a timestamp
            in RFC 3339 format
          name: before
          in: query
        - type: string
          description: Only show items which were created by the the given user
          name: created_by
          in: query
        - type: string
          description: Only show items for which the given user is assigned
          name: assigned_by
          in: query
        - type: string
          description: Only show items in which the given user was mentioned
          name: mentioned_by
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/IssueList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: >-
        Create an issue. If using deadline only the date will be taken into
        account, and time of day ignored.
      operationId: issueCreateIssue
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateIssueOption'
      responses:
        '201':
          $ref: '#/responses/Issue'
        '403':
          $ref: '#/responses/forbidden'
        '412':
          $ref: '#/responses/error'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/issues/comments:
    get:
      produces:
        - application/json
      tags:
        - issue
      summary: List all comments in a repository
      operationId: issueGetRepoComments
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          format: date-time
          description: >-
            if provided, only comments updated since the provided time are
            returned.
          name: since
          in: query
        - type: string
          format: date-time
          description: >-
            if provided, only comments updated before the provided time are
            returned.
          name: before
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/CommentList'
  /repos/{owner}/{repo}/issues/comments/{id}:
    get:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Get a comment
      operationId: issueGetComment
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the comment
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Comment'
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
    delete:
      tags:
        - issue
      summary: Delete a comment
      operationId: issueDeleteComment
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of comment to delete
          name: id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
    patch:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Edit a comment
      operationId: issueEditComment
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the comment to edit
          name: id
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/EditIssueCommentOption'
      responses:
        '200':
          $ref: '#/responses/Comment'
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/issues/comments/{id}/assets:
    get:
      produces:
        - application/json
      tags:
        - issue
      summary: List comment's attachments
      operationId: issueListIssueCommentAttachments
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the comment
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/AttachmentList'
        '404':
          $ref: '#/responses/error'
    post:
      consumes:
        - multipart/form-data
      produces:
        - application/json
      tags:
        - issue
      summary: Create a comment attachment
      operationId: issueCreateIssueCommentAttachment
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the comment
          name: id
          in: path
          required: true
        - type: string
          description: name of the attachment
          name: name
          in: query
        - type: file
          description: attachment to upload
          name: attachment
          in: formData
          required: true
      responses:
        '201':
          $ref: '#/responses/Attachment'
        '400':
          $ref: '#/responses/error'
        '404':
          $ref: '#/responses/error'
  /repos/{owner}/{repo}/issues/comments/{id}/assets/{attachment_id}:
    get:
      produces:
        - application/json
      tags:
        - issue
      summary: Get a comment attachment
      operationId: issueGetIssueCommentAttachment
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the comment
          name: id
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the attachment to get
          name: attachment_id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Attachment'
        '404':
          $ref: '#/responses/error'
    delete:
      produces:
        - application/json
      tags:
        - issue
      summary: Delete a comment attachment
      operationId: issueDeleteIssueCommentAttachment
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the comment
          name: id
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the attachment to delete
          name: attachment_id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/error'
    patch:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Edit a comment attachment
      operationId: issueEditIssueCommentAttachment
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the comment
          name: id
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the attachment to edit
          name: attachment_id
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/EditAttachmentOptions'
      responses:
        '201':
          $ref: '#/responses/Attachment'
        '404':
          $ref: '#/responses/error'
  /repos/{owner}/{repo}/issues/comments/{id}/reactions:
    get:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Get a list of reactions from a comment of an issue
      operationId: issueGetCommentReactions
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the comment to edit
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/ReactionList'
        '403':
          $ref: '#/responses/forbidden'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Add a reaction to a comment of an issue
      operationId: issuePostCommentReaction
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the comment to edit
          name: id
          in: path
          required: true
        - name: content
          in: body
          schema:
            $ref: '#/definitions/EditReactionOption'
      responses:
        '200':
          $ref: '#/responses/Reaction'
        '201':
          $ref: '#/responses/Reaction'
        '403':
          $ref: '#/responses/forbidden'
    delete:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Remove a reaction from a comment of an issue
      operationId: issueDeleteCommentReaction
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the comment to edit
          name: id
          in: path
          required: true
        - name: content
          in: body
          schema:
            $ref: '#/definitions/EditReactionOption'
      responses:
        '200':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
  /repos/{owner}/{repo}/issues/{index}:
    get:
      produces:
        - application/json
      tags:
        - issue
      summary: Get an issue
      operationId: issueGetIssue
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue to get
          name: index
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Issue'
        '404':
          $ref: '#/responses/notFound'
    delete:
      tags:
        - issue
      summary: Delete an issue
      operationId: issueDelete
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of issue to delete
          name: index
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
    patch:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: >-
        Edit an issue. If using deadline only the date will be taken into
        account, and time of day ignored.
      operationId: issueEditIssue
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue to edit
          name: index
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/EditIssueOption'
      responses:
        '201':
          $ref: '#/responses/Issue'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
        '412':
          $ref: '#/responses/error'
  /repos/{owner}/{repo}/issues/{index}/assets:
    get:
      produces:
        - application/json
      tags:
        - issue
      summary: List issue's attachments
      operationId: issueListIssueAttachments
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/AttachmentList'
        '404':
          $ref: '#/responses/error'
    post:
      consumes:
        - multipart/form-data
      produces:
        - application/json
      tags:
        - issue
      summary: Create an issue attachment
      operationId: issueCreateIssueAttachment
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
        - type: string
          description: name of the attachment
          name: name
          in: query
        - type: file
          description: attachment to upload
          name: attachment
          in: formData
          required: true
      responses:
        '201':
          $ref: '#/responses/Attachment'
        '400':
          $ref: '#/responses/error'
        '404':
          $ref: '#/responses/error'
  /repos/{owner}/{repo}/issues/{index}/assets/{attachment_id}:
    get:
      produces:
        - application/json
      tags:
        - issue
      summary: Get an issue attachment
      operationId: issueGetIssueAttachment
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the attachment to get
          name: attachment_id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Attachment'
        '404':
          $ref: '#/responses/error'
    delete:
      produces:
        - application/json
      tags:
        - issue
      summary: Delete an issue attachment
      operationId: issueDeleteIssueAttachment
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the attachment to delete
          name: attachment_id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/error'
    patch:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Edit an issue attachment
      operationId: issueEditIssueAttachment
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the attachment to edit
          name: attachment_id
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/EditAttachmentOptions'
      responses:
        '201':
          $ref: '#/responses/Attachment'
        '404':
          $ref: '#/responses/error'
  /repos/{owner}/{repo}/issues/{index}/comments:
    get:
      produces:
        - application/json
      tags:
        - issue
      summary: List all comments on an issue
      operationId: issueGetComments
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
        - type: string
          format: date-time
          description: >-
            if provided, only comments updated since the specified time are
            returned.
          name: since
          in: query
        - type: string
          format: date-time
          description: >-
            if provided, only comments updated before the provided time are
            returned.
          name: before
          in: query
      responses:
        '200':
          $ref: '#/responses/CommentList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Add a comment to an issue
      operationId: issueCreateComment
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateIssueCommentOption'
      responses:
        '201':
          $ref: '#/responses/Comment'
        '403':
          $ref: '#/responses/forbidden'
  /repos/{owner}/{repo}/issues/{index}/comments/{id}:
    delete:
      tags:
        - issue
      summary: Delete a comment
      operationId: issueDeleteCommentDeprecated
      deprecated: true
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          description: this parameter is ignored
          name: index
          in: path
          required: true
        - type: integer
          format: int64
          description: id of comment to delete
          name: id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
    patch:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Edit a comment
      operationId: issueEditCommentDeprecated
      deprecated: true
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          description: this parameter is ignored
          name: index
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the comment to edit
          name: id
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/EditIssueCommentOption'
      responses:
        '200':
          $ref: '#/responses/Comment'
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/issues/{index}/deadline:
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: >-
        Set an issue deadline. If set to null, the deadline is deleted. If using
        deadline only the date will be taken into account, and time of day
        ignored.
      operationId: issueEditIssueDeadline
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue to create or update a deadline on
          name: index
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/EditDeadlineOption'
      responses:
        '201':
          $ref: '#/responses/IssueDeadline'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/issues/{index}/labels:
    get:
      produces:
        - application/json
      tags:
        - issue
      summary: Get an issue's labels
      operationId: issueGetLabels
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/LabelList'
        '404':
          $ref: '#/responses/notFound'
    put:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Replace an issue's labels
      operationId: issueReplaceLabels
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/IssueLabelsOption'
      responses:
        '200':
          $ref: '#/responses/LabelList'
        '403':
          $ref: '#/responses/forbidden'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Add a label to an issue
      operationId: issueAddLabel
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/IssueLabelsOption'
      responses:
        '200':
          $ref: '#/responses/LabelList'
        '403':
          $ref: '#/responses/forbidden'
    delete:
      produces:
        - application/json
      tags:
        - issue
      summary: Remove all labels from an issue
      operationId: issueClearLabels
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
  /repos/{owner}/{repo}/issues/{index}/labels/{id}:
    delete:
      produces:
        - application/json
      tags:
        - issue
      summary: Remove a label from an issue
      operationId: issueRemoveLabel
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the label to remove
          name: id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/issues/{index}/reactions:
    get:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Get a list reactions of an issue
      operationId: issueGetIssueReactions
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/ReactionList'
        '403':
          $ref: '#/responses/forbidden'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Add a reaction to an issue
      operationId: issuePostIssueReaction
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
        - name: content
          in: body
          schema:
            $ref: '#/definitions/EditReactionOption'
      responses:
        '200':
          $ref: '#/responses/Reaction'
        '201':
          $ref: '#/responses/Reaction'
        '403':
          $ref: '#/responses/forbidden'
    delete:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Remove a reaction from an issue
      operationId: issueDeleteIssueReaction
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
        - name: content
          in: body
          schema:
            $ref: '#/definitions/EditReactionOption'
      responses:
        '200':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
  /repos/{owner}/{repo}/issues/{index}/stopwatch/delete:
    delete:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Delete an issue's existing stopwatch.
      operationId: issueDeleteStopWatch
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue to stop the stopwatch on
          name: index
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          description: Not repo writer, user does not have rights to toggle stopwatch
        '404':
          $ref: '#/responses/notFound'
        '409':
          description: Cannot cancel a non existent stopwatch
  /repos/{owner}/{repo}/issues/{index}/stopwatch/start:
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Start stopwatch on an issue.
      operationId: issueStartStopWatch
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue to create the stopwatch on
          name: index
          in: path
          required: true
      responses:
        '201':
          $ref: '#/responses/empty'
        '403':
          description: Not repo writer, user does not have rights to toggle stopwatch
        '404':
          $ref: '#/responses/notFound'
        '409':
          description: Cannot start a stopwatch again if it already exists
  /repos/{owner}/{repo}/issues/{index}/stopwatch/stop:
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Stop an issue's existing stopwatch.
      operationId: issueStopStopWatch
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue to stop the stopwatch on
          name: index
          in: path
          required: true
      responses:
        '201':
          $ref: '#/responses/empty'
        '403':
          description: Not repo writer, user does not have rights to toggle stopwatch
        '404':
          $ref: '#/responses/notFound'
        '409':
          description: Cannot stop a non existent stopwatch
  /repos/{owner}/{repo}/issues/{index}/subscriptions:
    get:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Get users who subscribed on an issue.
      operationId: issueSubscriptions
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/UserList'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/issues/{index}/subscriptions/check:
    get:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Check if user is subscribed to an issue
      operationId: issueCheckSubscription
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/WatchInfo'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/issues/{index}/subscriptions/{user}:
    put:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Subscribe user to issue
      operationId: issueAddSubscription
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
        - type: string
          description: user to subscribe
          name: user
          in: path
          required: true
      responses:
        '200':
          description: Already subscribed
        '201':
          description: Successfully Subscribed
        '304':
          description: User can only subscribe itself if he is no admin
        '404':
          $ref: '#/responses/notFound'
    delete:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Unsubscribe user from issue
      operationId: issueDeleteSubscription
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
        - type: string
          description: user witch unsubscribe
          name: user
          in: path
          required: true
      responses:
        '200':
          description: Already unsubscribed
        '201':
          description: Successfully Unsubscribed
        '304':
          description: User can only subscribe itself if he is no admin
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/issues/{index}/timeline:
    get:
      produces:
        - application/json
      tags:
        - issue
      summary: List all comments and events on an issue
      operationId: issueGetCommentsAndTimeline
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
        - type: string
          format: date-time
          description: >-
            if provided, only comments updated since the specified time are
            returned.
          name: since
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
        - type: string
          format: date-time
          description: >-
            if provided, only comments updated before the provided time are
            returned.
          name: before
          in: query
      responses:
        '200':
          $ref: '#/responses/TimelineList'
  /repos/{owner}/{repo}/issues/{index}/times:
    get:
      produces:
        - application/json
      tags:
        - issue
      summary: List an issue's tracked times
      operationId: issueTrackedTimes
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
        - type: string
          description: optional filter by user (available for issue managers)
          name: user
          in: query
        - type: string
          format: date-time
          description: >-
            Only show times updated after the given time. This is a timestamp in
            RFC 3339 format
          name: since
          in: query
        - type: string
          format: date-time
          description: >-
            Only show times updated before the given time. This is a timestamp
            in RFC 3339 format
          name: before
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/TrackedTimeList'
        '404':
          $ref: '#/responses/notFound'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Add tracked time to a issue
      operationId: issueAddTime
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/AddTimeOption'
      responses:
        '200':
          $ref: '#/responses/TrackedTime'
        '400':
          $ref: '#/responses/error'
        '403':
          $ref: '#/responses/forbidden'
    delete:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Reset a tracked time of an issue
      operationId: issueResetTime
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue to add tracked time to
          name: index
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '400':
          $ref: '#/responses/error'
        '403':
          $ref: '#/responses/forbidden'
  /repos/{owner}/{repo}/issues/{index}/times/{id}:
    delete:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Delete specific tracked time
      operationId: issueDeleteTime
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the issue
          name: index
          in: path
          required: true
        - type: integer
          format: int64
          description: id of time to delete
          name: id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '400':
          $ref: '#/responses/error'
        '403':
          $ref: '#/responses/forbidden'
  /repos/{owner}/{repo}/keys:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: List a repository's keys
      operationId: repoListKeys
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          description: the key_id to search for
          name: key_id
          in: query
        - type: string
          description: fingerprint of the key
          name: fingerprint
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/DeployKeyList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - repository
      summary: Add a key to a repository
      operationId: repoCreateKey
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateKeyOption'
      responses:
        '201':
          $ref: '#/responses/DeployKey'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/keys/{id}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a repository's key by id
      operationId: repoGetKey
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the key to get
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/DeployKey'
    delete:
      tags:
        - repository
      summary: Delete a key from a repository
      operationId: repoDeleteKey
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the key to delete
          name: id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
  /repos/{owner}/{repo}/labels:
    get:
      produces:
        - application/json
      tags:
        - issue
      summary: Get all of a repository's labels
      operationId: issueListLabels
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/LabelList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Create a label
      operationId: issueCreateLabel
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateLabelOption'
      responses:
        '201':
          $ref: '#/responses/Label'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/labels/{id}:
    get:
      produces:
        - application/json
      tags:
        - issue
      summary: Get a single label
      operationId: issueGetLabel
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the label to get
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Label'
    delete:
      tags:
        - issue
      summary: Delete a label
      operationId: issueDeleteLabel
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the label to delete
          name: id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
    patch:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Update a label
      operationId: issueEditLabel
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the label to edit
          name: id
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/EditLabelOption'
      responses:
        '200':
          $ref: '#/responses/Label'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/languages:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get languages and number of bytes of code written
      operationId: repoGetLanguages
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/LanguageStatistics'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/media/{filepath}:
    get:
      tags:
        - repository
      summary: Get a file or it's LFS object from a repository
      operationId: repoGetRawFileOrLFS
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: filepath of the file to get
          name: filepath
          in: path
          required: true
        - type: string
          description: >-
            The name of the commit/branch/tag. Default the repository’s default
            branch (usually master)
          name: ref
          in: query
      responses:
        '200':
          description: Returns raw file content.
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/milestones:
    get:
      produces:
        - application/json
      tags:
        - issue
      summary: Get all of a repository's opened milestones
      operationId: issueGetMilestonesList
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: >-
            Milestone state, Recognized values are open, closed and all.
            Defaults to "open"
          name: state
          in: query
        - type: string
          description: filter by milestone name
          name: name
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/MilestoneList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Create a milestone
      operationId: issueCreateMilestone
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateMilestoneOption'
      responses:
        '201':
          $ref: '#/responses/Milestone'
  /repos/{owner}/{repo}/milestones/{id}:
    get:
      produces:
        - application/json
      tags:
        - issue
      summary: Get a milestone
      operationId: issueGetMilestone
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: the milestone to get, identified by ID and if not available by name
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Milestone'
    delete:
      tags:
        - issue
      summary: Delete a milestone
      operationId: issueDeleteMilestone
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: >-
            the milestone to delete, identified by ID and if not available by
            name
          name: id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
    patch:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - issue
      summary: Update a milestone
      operationId: issueEditMilestone
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: the milestone to edit, identified by ID and if not available by name
          name: id
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/EditMilestoneOption'
      responses:
        '200':
          $ref: '#/responses/Milestone'
  /repos/{owner}/{repo}/mirror-sync:
    post:
      produces:
        - application/json
      tags:
        - repository
      summary: Sync a mirrored repository
      operationId: repoMirrorSync
      parameters:
        - type: string
          description: owner of the repo to sync
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo to sync
          name: repo
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
  /repos/{owner}/{repo}/notifications:
    get:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - notification
      summary: List users's notification threads on a specific repo
      operationId: notifyGetRepoList
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: boolean
          description: If true, show notifications marked as read. Default value is false
          name: all
          in: query
        - type: array
          items:
            type: string
          collectionFormat: multi
          description: >-
            Show notifications with the provided status types. Options are:
            unread, read and/or pinned. Defaults to unread & pinned
          name: status-types
          in: query
        - type: array
          items:
            enum:
              - issue
              - pull
              - commit
              - repository
            type: string
          collectionFormat: multi
          description: filter notifications by subject type
          name: subject-type
          in: query
        - type: string
          format: date-time
          description: >-
            Only show notifications updated after the given time. This is a
            timestamp in RFC 3339 format
          name: since
          in: query
        - type: string
          format: date-time
          description: >-
            Only show notifications updated before the given time. This is a
            timestamp in RFC 3339 format
          name: before
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/NotificationThreadList'
    put:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - notification
      summary: Mark notification threads as read, pinned or unread on a specific repo
      operationId: notifyReadRepoList
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: If true, mark all notifications on this repo. Default value is false
          name: all
          in: query
        - type: array
          items:
            type: string
          collectionFormat: multi
          description: >-
            Mark notifications with the provided status types. Options are:
            unread, read and/or pinned. Defaults to unread.
          name: status-types
          in: query
        - type: string
          description: Status to mark notifications as. Defaults to read.
          name: to-status
          in: query
        - type: string
          format: date-time
          description: >-
            Describes the last point that notifications were checked. Anything
            updated since this time will not be updated.
          name: last_read_at
          in: query
      responses:
        '205':
          $ref: '#/responses/NotificationThreadList'
  /repos/{owner}/{repo}/pulls:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: List a repo's pull requests
      operationId: repoListPullRequests
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - enum:
            - closed
            - open
            - all
          type: string
          description: 'State of pull request: open or closed (optional)'
          name: state
          in: query
        - enum:
            - oldest
            - recentupdate
            - leastupdate
            - mostcomment
            - leastcomment
            - priority
          type: string
          description: Type of sort
          name: sort
          in: query
        - type: integer
          format: int64
          description: ID of the milestone
          name: milestone
          in: query
        - type: array
          items:
            type: integer
            format: int64
          collectionFormat: multi
          description: Label IDs
          name: labels
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/PullRequestList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - repository
      summary: Create a pull request
      operationId: repoCreatePullRequest
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreatePullRequestOption'
      responses:
        '201':
          $ref: '#/responses/PullRequest'
        '409':
          $ref: '#/responses/error'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/pulls/{index}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a pull request
      operationId: repoGetPullRequest
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the pull request to get
          name: index
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/PullRequest'
        '404':
          $ref: '#/responses/notFound'
    patch:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - repository
      summary: >-
        Update a pull request. If using deadline only the date will be taken
        into account, and time of day ignored.
      operationId: repoEditPullRequest
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the pull request to edit
          name: index
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/EditPullRequestOption'
      responses:
        '201':
          $ref: '#/responses/PullRequest'
        '403':
          $ref: '#/responses/forbidden'
        '409':
          $ref: '#/responses/error'
        '412':
          $ref: '#/responses/error'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/pulls/{index}.{diffType}:
    get:
      produces:
        - text/plain
      tags:
        - repository
      summary: Get a pull request diff or patch
      operationId: repoDownloadPullDiffOrPatch
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the pull request to get
          name: index
          in: path
          required: true
        - enum:
            - diff
            - patch
          type: string
          description: whether the output is diff or patch
          name: diffType
          in: path
          required: true
        - type: boolean
          description: >-
            whether to include binary file changes. if true, the diff is
            applicable with `git apply`
          name: binary
          in: query
      responses:
        '200':
          $ref: '#/responses/string'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/pulls/{index}/commits:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get commits for a pull request
      operationId: repoGetPullRequestCommits
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the pull request to get
          name: index
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/CommitList'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/pulls/{index}/files:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get changed files for a pull request
      operationId: repoGetPullRequestFiles
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the pull request to get
          name: index
          in: path
          required: true
        - type: string
          description: skip to given file
          name: skip-to
          in: query
        - enum:
            - ignore-all
            - ignore-change
            - ignore-eol
            - show-all
          type: string
          description: whitespace behavior
          name: whitespace
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/ChangedFileList'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/pulls/{index}/merge:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Check if a pull request has been merged
      operationId: repoPullRequestIsMerged
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the pull request
          name: index
          in: path
          required: true
      responses:
        '204':
          description: pull request has been merged
        '404':
          description: pull request has not been merged
    post:
      produces:
        - application/json
      tags:
        - repository
      summary: Merge a pull request
      operationId: repoMergePullRequest
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the pull request to merge
          name: index
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/MergePullRequestOption'
      responses:
        '200':
          $ref: '#/responses/empty'
        '405':
          $ref: '#/responses/empty'
        '409':
          $ref: '#/responses/error'
    delete:
      produces:
        - application/json
      tags:
        - repository
      summary: Cancel the scheduled auto merge for the given pull request
      operationId: repoCancelScheduledAutoMerge
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the pull request to merge
          name: index
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/pulls/{index}/requested_reviewers:
    post:
      produces:
        - application/json
      tags:
        - repository
      summary: create review requests for a pull request
      operationId: repoCreatePullReviewRequests
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the pull request
          name: index
          in: path
          required: true
        - name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/PullReviewRequestOptions'
      responses:
        '201':
          $ref: '#/responses/PullReviewList'
        '404':
          $ref: '#/responses/notFound'
        '422':
          $ref: '#/responses/validationError'
    delete:
      produces:
        - application/json
      tags:
        - repository
      summary: cancel review requests for a pull request
      operationId: repoDeletePullReviewRequests
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the pull request
          name: index
          in: path
          required: true
        - name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/PullReviewRequestOptions'
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/notFound'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/pulls/{index}/reviews:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: List all reviews for a pull request
      operationId: repoListPullReviews
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the pull request
          name: index
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/PullReviewList'
        '404':
          $ref: '#/responses/notFound'
    post:
      produces:
        - application/json
      tags:
        - repository
      summary: Create a review to an pull request
      operationId: repoCreatePullReview
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the pull request
          name: index
          in: path
          required: true
        - name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/CreatePullReviewOptions'
      responses:
        '200':
          $ref: '#/responses/PullReview'
        '404':
          $ref: '#/responses/notFound'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/pulls/{index}/reviews/{id}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a specific review for a pull request
      operationId: repoGetPullReview
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the pull request
          name: index
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the review
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/PullReview'
        '404':
          $ref: '#/responses/notFound'
    post:
      produces:
        - application/json
      tags:
        - repository
      summary: Submit a pending review to an pull request
      operationId: repoSubmitPullReview
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the pull request
          name: index
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the review
          name: id
          in: path
          required: true
        - name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/SubmitPullReviewOptions'
      responses:
        '200':
          $ref: '#/responses/PullReview'
        '404':
          $ref: '#/responses/notFound'
        '422':
          $ref: '#/responses/validationError'
    delete:
      produces:
        - application/json
      tags:
        - repository
      summary: Delete a specific review from a pull request
      operationId: repoDeletePullReview
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the pull request
          name: index
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the review
          name: id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/pulls/{index}/reviews/{id}/comments:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a specific review for a pull request
      operationId: repoGetPullReviewComments
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the pull request
          name: index
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the review
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/PullReviewCommentList'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/pulls/{index}/reviews/{id}/dismissals:
    post:
      produces:
        - application/json
      tags:
        - repository
      summary: Dismiss a review for a pull request
      operationId: repoDismissPullReview
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the pull request
          name: index
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the review
          name: id
          in: path
          required: true
        - name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/DismissPullReviewOptions'
      responses:
        '200':
          $ref: '#/responses/PullReview'
        '403':
          $ref: '#/responses/forbidden'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/pulls/{index}/reviews/{id}/undismissals:
    post:
      produces:
        - application/json
      tags:
        - repository
      summary: Cancel to dismiss a review for a pull request
      operationId: repoUnDismissPullReview
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the pull request
          name: index
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the review
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/PullReview'
        '403':
          $ref: '#/responses/forbidden'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/pulls/{index}/update:
    post:
      produces:
        - application/json
      tags:
        - repository
      summary: Merge PR's baseBranch into headBranch
      operationId: repoUpdatePullRequest
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: index of the pull request to get
          name: index
          in: path
          required: true
        - enum:
            - merge
            - rebase
          type: string
          description: how to update pull request
          name: style
          in: query
      responses:
        '200':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
        '409':
          $ref: '#/responses/error'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/push_mirrors:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get all push mirrors of the repository
      operationId: repoListPushMirrors
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/PushMirrorList'
        '400':
          $ref: '#/responses/error'
        '403':
          $ref: '#/responses/forbidden'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - repository
      summary: add a push mirror to the repository
      operationId: repoAddPushMirror
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreatePushMirrorOption'
      responses:
        '201':
          $ref: '#/responses/PushMirror'
        '400':
          $ref: '#/responses/error'
        '403':
          $ref: '#/responses/forbidden'
  /repos/{owner}/{repo}/push_mirrors-sync:
    post:
      produces:
        - application/json
      tags:
        - repository
      summary: Sync all push mirrored repository
      operationId: repoPushMirrorSync
      parameters:
        - type: string
          description: owner of the repo to sync
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo to sync
          name: repo
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/empty'
        '400':
          $ref: '#/responses/error'
        '403':
          $ref: '#/responses/forbidden'
  /repos/{owner}/{repo}/push_mirrors/{name}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get push mirror of the repository by remoteName
      operationId: repoGetPushMirrorByRemoteName
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: remote name of push mirror
          name: name
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/PushMirror'
        '400':
          $ref: '#/responses/error'
        '403':
          $ref: '#/responses/forbidden'
    delete:
      produces:
        - application/json
      tags:
        - repository
      summary: deletes a push mirror from a repository by remoteName
      operationId: repoDeletePushMirror
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: remote name of the pushMirror
          name: name
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '400':
          $ref: '#/responses/error'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/raw/{filepath}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a file from a repository
      operationId: repoGetRawFile
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: filepath of the file to get
          name: filepath
          in: path
          required: true
        - type: string
          description: >-
            The name of the commit/branch/tag. Default the repository’s default
            branch (usually master)
          name: ref
          in: query
      responses:
        '200':
          description: Returns raw file content.
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/releases:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: List a repo's releases
      operationId: repoListReleases
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: boolean
          description: >-
            filter (exclude / include) drafts, if you dont have repo write
            access none will show
          name: draft
          in: query
        - type: boolean
          description: filter (exclude / include) pre-releases
          name: pre-release
          in: query
        - type: integer
          description: page size of results, deprecated - use limit
          name: per_page
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/ReleaseList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - repository
      summary: Create a release
      operationId: repoCreateRelease
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateReleaseOption'
      responses:
        '201':
          $ref: '#/responses/Release'
        '404':
          $ref: '#/responses/notFound'
        '409':
          $ref: '#/responses/error'
  /repos/{owner}/{repo}/releases/latest:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: >-
        Gets the most recent non-prerelease, non-draft release of a repository,
        sorted by created_at
      operationId: repoGetLatestRelease
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Release'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/releases/tags/{tag}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a release by tag name
      operationId: repoGetReleaseByTag
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: tag name of the release to get
          name: tag
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Release'
        '404':
          $ref: '#/responses/notFound'
    delete:
      tags:
        - repository
      summary: Delete a release by tag name
      operationId: repoDeleteReleaseByTag
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: tag name of the release to delete
          name: tag
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/notFound'
        '405':
          $ref: '#/responses/empty'
  /repos/{owner}/{repo}/releases/{id}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a release
      operationId: repoGetRelease
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the release to get
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Release'
        '404':
          $ref: '#/responses/notFound'
    delete:
      tags:
        - repository
      summary: Delete a release
      operationId: repoDeleteRelease
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the release to delete
          name: id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/notFound'
        '405':
          $ref: '#/responses/empty'
    patch:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - repository
      summary: Update a release
      operationId: repoEditRelease
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the release to edit
          name: id
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/EditReleaseOption'
      responses:
        '200':
          $ref: '#/responses/Release'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/releases/{id}/assets:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: List release's attachments
      operationId: repoListReleaseAttachments
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the release
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/AttachmentList'
    post:
      consumes:
        - multipart/form-data
      produces:
        - application/json
      tags:
        - repository
      summary: Create a release attachment
      operationId: repoCreateReleaseAttachment
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the release
          name: id
          in: path
          required: true
        - type: string
          description: name of the attachment
          name: name
          in: query
        - type: file
          description: attachment to upload
          name: attachment
          in: formData
          required: true
      responses:
        '201':
          $ref: '#/responses/Attachment'
        '400':
          $ref: '#/responses/error'
  /repos/{owner}/{repo}/releases/{id}/assets/{attachment_id}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a release attachment
      operationId: repoGetReleaseAttachment
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the release
          name: id
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the attachment to get
          name: attachment_id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Attachment'
    delete:
      produces:
        - application/json
      tags:
        - repository
      summary: Delete a release attachment
      operationId: repoDeleteReleaseAttachment
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the release
          name: id
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the attachment to delete
          name: attachment_id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
    patch:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - repository
      summary: Edit a release attachment
      operationId: repoEditReleaseAttachment
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the release
          name: id
          in: path
          required: true
        - type: integer
          format: int64
          description: id of the attachment to edit
          name: attachment_id
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/EditAttachmentOptions'
      responses:
        '201':
          $ref: '#/responses/Attachment'
  /repos/{owner}/{repo}/reviewers:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Return all users that can be requested to review in this repo
      operationId: repoGetReviewers
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/UserList'
  /repos/{owner}/{repo}/signing-key.gpg:
    get:
      produces:
        - text/plain
      tags:
        - repository
      summary: Get signing-key.gpg for given repository
      operationId: repoSigningKey
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
      responses:
        '200':
          description: GPG armored public key
          schema:
            type: string
  /repos/{owner}/{repo}/stargazers:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: List a repo's stargazers
      operationId: repoListStargazers
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/UserList'
  /repos/{owner}/{repo}/statuses/{sha}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a commit's statuses
      operationId: repoListStatuses
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: sha of the commit
          name: sha
          in: path
          required: true
        - enum:
            - oldest
            - recentupdate
            - leastupdate
            - leastindex
            - highestindex
          type: string
          description: type of sort
          name: sort
          in: query
        - enum:
            - pending
            - success
            - error
            - failure
            - warning
          type: string
          description: type of state
          name: state
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/CommitStatusList'
        '400':
          $ref: '#/responses/error'
    post:
      produces:
        - application/json
      tags:
        - repository
      summary: Create a commit status
      operationId: repoCreateStatus
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: sha of the commit
          name: sha
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateStatusOption'
      responses:
        '201':
          $ref: '#/responses/CommitStatus'
        '400':
          $ref: '#/responses/error'
  /repos/{owner}/{repo}/subscribers:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: List a repo's watchers
      operationId: repoListSubscribers
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/UserList'
  /repos/{owner}/{repo}/subscription:
    get:
      tags:
        - repository
      summary: Check if the current user is watching a repo
      operationId: userCurrentCheckSubscription
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/WatchInfo'
        '404':
          description: User is not watching this repo or repo do not exist
    put:
      tags:
        - repository
      summary: Watch a repo
      operationId: userCurrentPutSubscription
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/WatchInfo'
    delete:
      tags:
        - repository
      summary: Unwatch a repo
      operationId: userCurrentDeleteSubscription
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
  /repos/{owner}/{repo}/tags:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: List a repository's tags
      operationId: repoListTags
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results, default maximum page size is 50
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/TagList'
    post:
      produces:
        - application/json
      tags:
        - repository
      summary: Create a new git tag in a repository
      operationId: repoCreateTag
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateTagOption'
      responses:
        '200':
          $ref: '#/responses/Tag'
        '404':
          $ref: '#/responses/notFound'
        '405':
          $ref: '#/responses/empty'
        '409':
          $ref: '#/responses/conflict'
  /repos/{owner}/{repo}/tags/{tag}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get the tag of a repository by tag name
      operationId: repoGetTag
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: name of tag
          name: tag
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Tag'
        '404':
          $ref: '#/responses/notFound'
    delete:
      produces:
        - application/json
      tags:
        - repository
      summary: Delete a repository's tag by name
      operationId: repoDeleteTag
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: name of tag to delete
          name: tag
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/notFound'
        '405':
          $ref: '#/responses/empty'
        '409':
          $ref: '#/responses/conflict'
  /repos/{owner}/{repo}/teams:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: List a repository's teams
      operationId: repoListTeams
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/TeamList'
  /repos/{owner}/{repo}/teams/{team}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Check if a team is assigned to a repository
      operationId: repoCheckTeam
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: team name
          name: team
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Team'
        '404':
          $ref: '#/responses/notFound'
        '405':
          $ref: '#/responses/error'
    put:
      produces:
        - application/json
      tags:
        - repository
      summary: Add a team to a repository
      operationId: repoAddTeam
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: team name
          name: team
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '405':
          $ref: '#/responses/error'
        '422':
          $ref: '#/responses/validationError'
    delete:
      produces:
        - application/json
      tags:
        - repository
      summary: Delete a team from a repository
      operationId: repoDeleteTeam
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: team name
          name: team
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '405':
          $ref: '#/responses/error'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/times:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: List a repo's tracked times
      operationId: repoTrackedTimes
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: optional filter by user (available for issue managers)
          name: user
          in: query
        - type: string
          format: date-time
          description: >-
            Only show times updated after the given time. This is a timestamp in
            RFC 3339 format
          name: since
          in: query
        - type: string
          format: date-time
          description: >-
            Only show times updated before the given time. This is a timestamp
            in RFC 3339 format
          name: before
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/TrackedTimeList'
        '400':
          $ref: '#/responses/error'
        '403':
          $ref: '#/responses/forbidden'
  /repos/{owner}/{repo}/times/{user}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: List a user's tracked times in a repo
      operationId: userTrackedTimes
      deprecated: true
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: username of user
          name: user
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/TrackedTimeList'
        '400':
          $ref: '#/responses/error'
        '403':
          $ref: '#/responses/forbidden'
  /repos/{owner}/{repo}/topics:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get list of topics that a repository has
      operationId: repoListTopics
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/TopicNames'
    put:
      produces:
        - application/json
      tags:
        - repository
      summary: Replace list of topics for a repository
      operationId: repoUpdateTopics
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/RepoTopicOptions'
      responses:
        '204':
          $ref: '#/responses/empty'
        '422':
          $ref: '#/responses/invalidTopicsError'
  /repos/{owner}/{repo}/topics/{topic}:
    put:
      produces:
        - application/json
      tags:
        - repository
      summary: Add a topic to a repository
      operationId: repoAddTopic
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: name of the topic to add
          name: topic
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '422':
          $ref: '#/responses/invalidTopicsError'
    delete:
      produces:
        - application/json
      tags:
        - repository
      summary: Delete a topic from a repository
      operationId: repoDeleteTopic
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: name of the topic to delete
          name: topic
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '422':
          $ref: '#/responses/invalidTopicsError'
  /repos/{owner}/{repo}/transfer:
    post:
      produces:
        - application/json
      tags:
        - repository
      summary: Transfer a repo ownership
      operationId: repoTransfer
      parameters:
        - type: string
          description: owner of the repo to transfer
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo to transfer
          name: repo
          in: path
          required: true
        - description: Transfer Options
          name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/TransferRepoOption'
      responses:
        '202':
          $ref: '#/responses/Repository'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
        '422':
          $ref: '#/responses/validationError'
  /repos/{owner}/{repo}/transfer/accept:
    post:
      produces:
        - application/json
      tags:
        - repository
      summary: Accept a repo transfer
      operationId: acceptRepoTransfer
      parameters:
        - type: string
          description: owner of the repo to transfer
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo to transfer
          name: repo
          in: path
          required: true
      responses:
        '202':
          $ref: '#/responses/Repository'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/transfer/reject:
    post:
      produces:
        - application/json
      tags:
        - repository
      summary: Reject a repo transfer
      operationId: rejectRepoTransfer
      parameters:
        - type: string
          description: owner of the repo to transfer
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo to transfer
          name: repo
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Repository'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/wiki/new:
    post:
      consumes:
        - application/json
      tags:
        - repository
      summary: Create a wiki page
      operationId: repoCreateWikiPage
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateWikiPageOptions'
      responses:
        '201':
          $ref: '#/responses/WikiPage'
        '400':
          $ref: '#/responses/error'
        '403':
          $ref: '#/responses/forbidden'
  /repos/{owner}/{repo}/wiki/page/{pageName}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a wiki page
      operationId: repoGetWikiPage
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: name of the page
          name: pageName
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/WikiPage'
        '404':
          $ref: '#/responses/notFound'
    delete:
      tags:
        - repository
      summary: Delete a wiki page
      operationId: repoDeleteWikiPage
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: name of the page
          name: pageName
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
    patch:
      consumes:
        - application/json
      tags:
        - repository
      summary: Edit a wiki page
      operationId: repoEditWikiPage
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: name of the page
          name: pageName
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateWikiPageOptions'
      responses:
        '200':
          $ref: '#/responses/WikiPage'
        '400':
          $ref: '#/responses/error'
        '403':
          $ref: '#/responses/forbidden'
  /repos/{owner}/{repo}/wiki/pages:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get all wiki pages
      operationId: repoGetWikiPages
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/WikiPageList'
        '404':
          $ref: '#/responses/notFound'
  /repos/{owner}/{repo}/wiki/revisions/{pageName}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get revisions of a wiki page
      operationId: repoGetWikiPageRevisions
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
        - type: string
          description: name of the page
          name: pageName
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
      responses:
        '200':
          $ref: '#/responses/WikiCommitList'
        '404':
          $ref: '#/responses/notFound'
  /repos/{template_owner}/{template_repo}/generate:
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - repository
      summary: Create a repository using a template
      operationId: generateRepo
      parameters:
        - type: string
          description: name of the template repository owner
          name: template_owner
          in: path
          required: true
        - type: string
          description: name of the template repository
          name: template_repo
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/GenerateRepoOption'
      responses:
        '201':
          $ref: '#/responses/Repository'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
        '409':
          description: The repository with the same name already exists.
        '422':
          $ref: '#/responses/validationError'
  /repositories/{id}:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: Get a repository by id
      operationId: repoGetByID
      parameters:
        - type: integer
          format: int64
          description: id of the repo to get
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Repository'
  /settings/api:
    get:
      produces:
        - application/json
      tags:
        - settings
      summary: Get instance's global settings for api
      operationId: getGeneralAPISettings
      responses:
        '200':
          $ref: '#/responses/GeneralAPISettings'
  /settings/attachment:
    get:
      produces:
        - application/json
      tags:
        - settings
      summary: Get instance's global settings for Attachment
      operationId: getGeneralAttachmentSettings
      responses:
        '200':
          $ref: '#/responses/GeneralAttachmentSettings'
  /settings/repository:
    get:
      produces:
        - application/json
      tags:
        - settings
      summary: Get instance's global settings for repositories
      operationId: getGeneralRepositorySettings
      responses:
        '200':
          $ref: '#/responses/GeneralRepoSettings'
  /settings/ui:
    get:
      produces:
        - application/json
      tags:
        - settings
      summary: Get instance's global settings for ui
      operationId: getGeneralUISettings
      responses:
        '200':
          $ref: '#/responses/GeneralUISettings'
  /signing-key.gpg:
    get:
      produces:
        - text/plain
      tags:
        - miscellaneous
      summary: Get default signing-key.gpg
      operationId: getSigningKey
      responses:
        '200':
          description: GPG armored public key
          schema:
            type: string
  /teams/{id}:
    get:
      produces:
        - application/json
      tags:
        - organization
      summary: Get a team
      operationId: orgGetTeam
      parameters:
        - type: integer
          format: int64
          description: id of the team to get
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Team'
    delete:
      tags:
        - organization
      summary: Delete a team
      operationId: orgDeleteTeam
      parameters:
        - type: integer
          format: int64
          description: id of the team to delete
          name: id
          in: path
          required: true
      responses:
        '204':
          description: team deleted
    patch:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - organization
      summary: Edit a team
      operationId: orgEditTeam
      parameters:
        - type: integer
          description: id of the team to edit
          name: id
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/EditTeamOption'
      responses:
        '200':
          $ref: '#/responses/Team'
  /teams/{id}/members:
    get:
      produces:
        - application/json
      tags:
        - organization
      summary: List a team's members
      operationId: orgListTeamMembers
      parameters:
        - type: integer
          format: int64
          description: id of the team
          name: id
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/UserList'
  /teams/{id}/members/{username}:
    get:
      produces:
        - application/json
      tags:
        - organization
      summary: List a particular member of team
      operationId: orgListTeamMember
      parameters:
        - type: integer
          format: int64
          description: id of the team
          name: id
          in: path
          required: true
        - type: string
          description: username of the member to list
          name: username
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/User'
        '404':
          $ref: '#/responses/notFound'
    put:
      produces:
        - application/json
      tags:
        - organization
      summary: Add a team member
      operationId: orgAddTeamMember
      parameters:
        - type: integer
          format: int64
          description: id of the team
          name: id
          in: path
          required: true
        - type: string
          description: username of the user to add
          name: username
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/notFound'
    delete:
      produces:
        - application/json
      tags:
        - organization
      summary: Remove a team member
      operationId: orgRemoveTeamMember
      parameters:
        - type: integer
          format: int64
          description: id of the team
          name: id
          in: path
          required: true
        - type: string
          description: username of the user to remove
          name: username
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/notFound'
  /teams/{id}/repos:
    get:
      produces:
        - application/json
      tags:
        - organization
      summary: List a team's repos
      operationId: orgListTeamRepos
      parameters:
        - type: integer
          format: int64
          description: id of the team
          name: id
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/RepositoryList'
  /teams/{id}/repos/{org}/{repo}:
    get:
      produces:
        - application/json
      tags:
        - organization
      summary: List a particular repo of team
      operationId: orgListTeamRepo
      parameters:
        - type: integer
          format: int64
          description: id of the team
          name: id
          in: path
          required: true
        - type: string
          description: organization that owns the repo to list
          name: org
          in: path
          required: true
        - type: string
          description: name of the repo to list
          name: repo
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/Repository'
        '404':
          $ref: '#/responses/notFound'
    put:
      produces:
        - application/json
      tags:
        - organization
      summary: Add a repository to a team
      operationId: orgAddTeamRepository
      parameters:
        - type: integer
          format: int64
          description: id of the team
          name: id
          in: path
          required: true
        - type: string
          description: organization that owns the repo to add
          name: org
          in: path
          required: true
        - type: string
          description: name of the repo to add
          name: repo
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
    delete:
      description: >-
        This does not delete the repository, it only removes the repository from
        the team.
      produces:
        - application/json
      tags:
        - organization
      summary: Remove a repository from a team
      operationId: orgRemoveTeamRepository
      parameters:
        - type: integer
          format: int64
          description: id of the team
          name: id
          in: path
          required: true
        - type: string
          description: organization that owns the repo to remove
          name: org
          in: path
          required: true
        - type: string
          description: name of the repo to remove
          name: repo
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
  /topics/search:
    get:
      produces:
        - application/json
      tags:
        - repository
      summary: search topics via keyword
      operationId: topicSearch
      parameters:
        - type: string
          description: keywords to search
          name: q
          in: query
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/TopicListResponse'
        '403':
          $ref: '#/responses/forbidden'
  /user:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: Get the authenticated user
      operationId: userGetCurrent
      responses:
        '200':
          $ref: '#/responses/User'
  /user/applications/oauth2:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: List the authenticated user's oauth2 applications
      operationId: userGetOauth2Application
      parameters:
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/OAuth2ApplicationList'
    post:
      produces:
        - application/json
      tags:
        - user
      summary: creates a new OAuth2 application
      operationId: userCreateOAuth2Application
      parameters:
        - name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/CreateOAuth2ApplicationOptions'
      responses:
        '201':
          $ref: '#/responses/OAuth2Application'
        '400':
          $ref: '#/responses/error'
  /user/applications/oauth2/{id}:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: get an OAuth2 Application
      operationId: userGetOAuth2Application
      parameters:
        - type: integer
          format: int64
          description: Application ID to be found
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/OAuth2Application'
        '404':
          $ref: '#/responses/notFound'
    delete:
      produces:
        - application/json
      tags:
        - user
      summary: delete an OAuth2 Application
      operationId: userDeleteOAuth2Application
      parameters:
        - type: integer
          format: int64
          description: token to be deleted
          name: id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/notFound'
    patch:
      produces:
        - application/json
      tags:
        - user
      summary: >-
        update an OAuth2 Application, this includes regenerating the client
        secret
      operationId: userUpdateOAuth2Application
      parameters:
        - type: integer
          format: int64
          description: application to be updated
          name: id
          in: path
          required: true
        - name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/CreateOAuth2ApplicationOptions'
      responses:
        '200':
          $ref: '#/responses/OAuth2Application'
        '404':
          $ref: '#/responses/notFound'
  /user/emails:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: List the authenticated user's email addresses
      operationId: userListEmails
      responses:
        '200':
          $ref: '#/responses/EmailList'
    post:
      produces:
        - application/json
      tags:
        - user
      summary: Add email addresses
      operationId: userAddEmail
      parameters:
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateEmailOption'
      responses:
        '201':
          $ref: '#/responses/EmailList'
        '422':
          $ref: '#/responses/validationError'
    delete:
      produces:
        - application/json
      tags:
        - user
      summary: Delete email addresses
      operationId: userDeleteEmail
      parameters:
        - name: body
          in: body
          schema:
            $ref: '#/definitions/DeleteEmailOption'
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/notFound'
  /user/followers:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: List the authenticated user's followers
      operationId: userCurrentListFollowers
      parameters:
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/UserList'
  /user/following:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: List the users that the authenticated user is following
      operationId: userCurrentListFollowing
      parameters:
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/UserList'
  /user/following/{username}:
    get:
      tags:
        - user
      summary: Check whether a user is followed by the authenticated user
      operationId: userCurrentCheckFollowing
      parameters:
        - type: string
          description: username of followed user
          name: username
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/notFound'
    put:
      tags:
        - user
      summary: Follow a user
      operationId: userCurrentPutFollow
      parameters:
        - type: string
          description: username of user to follow
          name: username
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
    delete:
      tags:
        - user
      summary: Unfollow a user
      operationId: userCurrentDeleteFollow
      parameters:
        - type: string
          description: username of user to unfollow
          name: username
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
  /user/gpg_key_token:
    get:
      produces:
        - text/plain
      tags:
        - user
      summary: Get a Token to verify
      operationId: getVerificationToken
      responses:
        '200':
          $ref: '#/responses/string'
        '404':
          $ref: '#/responses/notFound'
  /user/gpg_key_verify:
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - user
      summary: Verify a GPG key
      operationId: userVerifyGPGKey
      responses:
        '201':
          $ref: '#/responses/GPGKey'
        '404':
          $ref: '#/responses/notFound'
        '422':
          $ref: '#/responses/validationError'
  /user/gpg_keys:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: List the authenticated user's GPG keys
      operationId: userCurrentListGPGKeys
      parameters:
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/GPGKeyList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - user
      summary: Create a GPG key
      operationId: userCurrentPostGPGKey
      parameters:
        - name: Form
          in: body
          schema:
            $ref: '#/definitions/CreateGPGKeyOption'
      responses:
        '201':
          $ref: '#/responses/GPGKey'
        '404':
          $ref: '#/responses/notFound'
        '422':
          $ref: '#/responses/validationError'
  /user/gpg_keys/{id}:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: Get a GPG key
      operationId: userCurrentGetGPGKey
      parameters:
        - type: integer
          format: int64
          description: id of key to get
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/GPGKey'
        '404':
          $ref: '#/responses/notFound'
    delete:
      produces:
        - application/json
      tags:
        - user
      summary: Remove a GPG key
      operationId: userCurrentDeleteGPGKey
      parameters:
        - type: integer
          format: int64
          description: id of key to delete
          name: id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
  /user/keys:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: List the authenticated user's public keys
      operationId: userCurrentListKeys
      parameters:
        - type: string
          description: fingerprint of the key
          name: fingerprint
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/PublicKeyList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - user
      summary: Create a public key
      operationId: userCurrentPostKey
      parameters:
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateKeyOption'
      responses:
        '201':
          $ref: '#/responses/PublicKey'
        '422':
          $ref: '#/responses/validationError'
  /user/keys/{id}:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: Get a public key
      operationId: userCurrentGetKey
      parameters:
        - type: integer
          format: int64
          description: id of key to get
          name: id
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/PublicKey'
        '404':
          $ref: '#/responses/notFound'
    delete:
      produces:
        - application/json
      tags:
        - user
      summary: Delete a public key
      operationId: userCurrentDeleteKey
      parameters:
        - type: integer
          format: int64
          description: id of key to delete
          name: id
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
  /user/orgs:
    get:
      produces:
        - application/json
      tags:
        - organization
      summary: List the current user's organizations
      operationId: orgListCurrentUserOrgs
      parameters:
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/OrganizationList'
  /user/repos:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: List the repos that the authenticated user owns
      operationId: userCurrentListRepos
      parameters:
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/RepositoryList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - repository
        - user
      summary: Create a repository
      operationId: createCurrentUserRepo
      parameters:
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateRepoOption'
      responses:
        '201':
          $ref: '#/responses/Repository'
        '400':
          $ref: '#/responses/error'
        '409':
          description: The repository with the same name already exists.
        '422':
          $ref: '#/responses/validationError'
  /user/settings:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: Get user settings
      operationId: getUserSettings
      responses:
        '200':
          $ref: '#/responses/UserSettings'
    patch:
      produces:
        - application/json
      tags:
        - user
      summary: Update user settings
      operationId: updateUserSettings
      parameters:
        - name: body
          in: body
          schema:
            $ref: '#/definitions/UserSettingsOptions'
      responses:
        '200':
          $ref: '#/responses/UserSettings'
  /user/starred:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: The repos that the authenticated user has starred
      operationId: userCurrentListStarred
      parameters:
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/RepositoryList'
  /user/starred/{owner}/{repo}:
    get:
      tags:
        - user
      summary: Whether the authenticated is starring the repo
      operationId: userCurrentCheckStarring
      parameters:
        - type: string
          description: owner of the repo
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo
          name: repo
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/notFound'
    put:
      tags:
        - user
      summary: Star the given repo
      operationId: userCurrentPutStar
      parameters:
        - type: string
          description: owner of the repo to star
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo to star
          name: repo
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
    delete:
      tags:
        - user
      summary: Unstar the given repo
      operationId: userCurrentDeleteStar
      parameters:
        - type: string
          description: owner of the repo to unstar
          name: owner
          in: path
          required: true
        - type: string
          description: name of the repo to unstar
          name: repo
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
  /user/stopwatches:
    get:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - user
      summary: Get list of all existing stopwatches
      operationId: userGetStopWatches
      parameters:
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/StopWatchList'
  /user/subscriptions:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: List repositories watched by the authenticated user
      operationId: userCurrentListSubscriptions
      parameters:
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/RepositoryList'
  /user/teams:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: List all the teams a user belongs to
      operationId: userListTeams
      parameters:
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/TeamList'
  /user/times:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: List the current user's tracked times
      operationId: userCurrentTrackedTimes
      parameters:
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
        - type: string
          format: date-time
          description: >-
            Only show times updated after the given time. This is a timestamp in
            RFC 3339 format
          name: since
          in: query
        - type: string
          format: date-time
          description: >-
            Only show times updated before the given time. This is a timestamp
            in RFC 3339 format
          name: before
          in: query
      responses:
        '200':
          $ref: '#/responses/TrackedTimeList'
  /users/search:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: Search for users
      operationId: userSearch
      parameters:
        - type: string
          description: keyword
          name: q
          in: query
        - type: integer
          format: int64
          description: ID of the user to search for
          name: uid
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          description: SearchResults of a successful search
          schema:
            type: object
            properties:
              data:
                type: array
                items:
                  $ref: '#/definitions/User'
              ok:
                type: boolean
  /users/{username}:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: Get a user
      operationId: userGet
      parameters:
        - type: string
          description: username of user to get
          name: username
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/User'
        '404':
          $ref: '#/responses/notFound'
  /users/{username}/followers:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: List the given user's followers
      operationId: userListFollowers
      parameters:
        - type: string
          description: username of user
          name: username
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/UserList'
  /users/{username}/following:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: List the users that the given user is following
      operationId: userListFollowing
      parameters:
        - type: string
          description: username of user
          name: username
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/UserList'
  /users/{username}/following/{target}:
    get:
      tags:
        - user
      summary: Check if one user is following another user
      operationId: userCheckFollowing
      parameters:
        - type: string
          description: username of following user
          name: username
          in: path
          required: true
        - type: string
          description: username of followed user
          name: target
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/notFound'
  /users/{username}/gpg_keys:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: List the given user's GPG keys
      operationId: userListGPGKeys
      parameters:
        - type: string
          description: username of user
          name: username
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/GPGKeyList'
  /users/{username}/heatmap:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: Get a user's heatmap
      operationId: userGetHeatmapData
      parameters:
        - type: string
          description: username of user to get
          name: username
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/UserHeatmapData'
        '404':
          $ref: '#/responses/notFound'
  /users/{username}/keys:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: List the given user's public keys
      operationId: userListKeys
      parameters:
        - type: string
          description: username of user
          name: username
          in: path
          required: true
        - type: string
          description: fingerprint of the key
          name: fingerprint
          in: query
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/PublicKeyList'
  /users/{username}/orgs:
    get:
      produces:
        - application/json
      tags:
        - organization
      summary: List a user's organizations
      operationId: orgListUserOrgs
      parameters:
        - type: string
          description: username of user
          name: username
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/OrganizationList'
  /users/{username}/orgs/{org}/permissions:
    get:
      produces:
        - application/json
      tags:
        - organization
      summary: Get user permissions in organization
      operationId: orgGetUserPermissions
      parameters:
        - type: string
          description: username of user
          name: username
          in: path
          required: true
        - type: string
          description: name of the organization
          name: org
          in: path
          required: true
      responses:
        '200':
          $ref: '#/responses/OrganizationPermissions'
        '403':
          $ref: '#/responses/forbidden'
        '404':
          $ref: '#/responses/notFound'
  /users/{username}/repos:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: List the repos owned by the given user
      operationId: userListRepos
      parameters:
        - type: string
          description: username of user
          name: username
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/RepositoryList'
  /users/{username}/starred:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: The repos that the given user has starred
      operationId: userListStarred
      parameters:
        - type: string
          description: username of user
          name: username
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/RepositoryList'
  /users/{username}/subscriptions:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: List the repositories watched by a user
      operationId: userListSubscriptions
      parameters:
        - type: string
          description: username of the user
          name: username
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/RepositoryList'
  /users/{username}/tokens:
    get:
      produces:
        - application/json
      tags:
        - user
      summary: List the authenticated user's access tokens
      operationId: userGetTokens
      parameters:
        - type: string
          description: username of user
          name: username
          in: path
          required: true
        - type: integer
          description: page number of results to return (1-based)
          name: page
          in: query
        - type: integer
          description: page size of results
          name: limit
          in: query
      responses:
        '200':
          $ref: '#/responses/AccessTokenList'
    post:
      consumes:
        - application/json
      produces:
        - application/json
      tags:
        - user
      summary: Create an access token
      operationId: userCreateToken
      parameters:
        - type: string
          description: username of user
          name: username
          in: path
          required: true
        - name: body
          in: body
          schema:
            $ref: '#/definitions/CreateAccessTokenOption'
      responses:
        '201':
          $ref: '#/responses/AccessToken'
        '400':
          $ref: '#/responses/error'
  /users/{username}/tokens/{token}:
    delete:
      produces:
        - application/json
      tags:
        - user
      summary: delete an access token
      operationId: userDeleteAccessToken
      parameters:
        - type: string
          description: username of user
          name: username
          in: path
          required: true
        - type: string
          description: token to be deleted, identified by ID and if not available by name
          name: token
          in: path
          required: true
      responses:
        '204':
          $ref: '#/responses/empty'
        '404':
          $ref: '#/responses/notFound'
        '422':
          $ref: '#/responses/error'
  /version:
    get:
      produces:
        - application/json
      tags:
        - miscellaneous
      summary: Returns the version of the Gitea application
      operationId: getVersion
      responses:
        '200':
          $ref: '#/responses/ServerVersion'
definitions:
  APIError:
    description: APIError is an api error with a message
    type: object
    properties:
      message:
        type: string
        x-go-name: Message
      url:
        type: string
        x-go-name: URL
    x-go-package: code.gitea.io/gitea/modules/structs
  AccessToken:
    type: object
    title: AccessToken represents an API access token.
    properties:
      id:
        type: integer
        format: int64
        x-go-name: ID
      name:
        type: string
        x-go-name: Name
      scopes:
        type: array
        items:
          type: string
        x-go-name: Scopes
      sha1:
        type: string
        x-go-name: Token
      token_last_eight:
        type: string
        x-go-name: TokenLastEight
    x-go-package: code.gitea.io/gitea/modules/structs
  ActivityPub:
    description: ActivityPub type
    type: object
    properties:
      '@context':
        type: string
        x-go-name: Context
    x-go-package: code.gitea.io/gitea/modules/structs
  AddCollaboratorOption:
    description: >-
      AddCollaboratorOption options when adding a user as a collaborator of a
      repository
    type: object
    properties:
      permission:
        type: string
        x-go-name: Permission
    x-go-package: code.gitea.io/gitea/modules/structs
  AddTimeOption:
    description: AddTimeOption options for adding time to an issue
    type: object
    required:
      - time
    properties:
      created:
        type: string
        format: date-time
        x-go-name: Created
      time:
        description: time in seconds
        type: integer
        format: int64
        x-go-name: Time
      user_name:
        description: User who spent the time (optional)
        type: string
        x-go-name: User
    x-go-package: code.gitea.io/gitea/modules/structs
  AnnotatedTag:
    description: AnnotatedTag represents an annotated tag
    type: object
    properties:
      message:
        type: string
        x-go-name: Message
      object:
        $ref: '#/definitions/AnnotatedTagObject'
      sha:
        type: string
        x-go-name: SHA
      tag:
        type: string
        x-go-name: Tag
      tagger:
        $ref: '#/definitions/CommitUser'
      url:
        type: string
        x-go-name: URL
      verification:
        $ref: '#/definitions/PayloadCommitVerification'
    x-go-package: code.gitea.io/gitea/modules/structs
  AnnotatedTagObject:
    description: AnnotatedTagObject contains meta information of the tag object
    type: object
    properties:
      sha:
        type: string
        x-go-name: SHA
      type:
        type: string
        x-go-name: Type
      url:
        type: string
        x-go-name: URL
    x-go-package: code.gitea.io/gitea/modules/structs
  Attachment:
    description: Attachment a generic attachment
    type: object
    properties:
      browser_download_url:
        type: string
        x-go-name: DownloadURL
      created_at:
        type: string
        format: date-time
        x-go-name: Created
      download_count:
        type: integer
        format: int64
        x-go-name: DownloadCount
      id:
        type: integer
        format: int64
        x-go-name: ID
      name:
        type: string
        x-go-name: Name
      size:
        type: integer
        format: int64
        x-go-name: Size
      uuid:
        type: string
        x-go-name: UUID
    x-go-package: code.gitea.io/gitea/modules/structs
  Branch:
    description: Branch represents a repository branch
    type: object
    properties:
      commit:
        $ref: '#/definitions/PayloadCommit'
      effective_branch_protection_name:
        type: string
        x-go-name: EffectiveBranchProtectionName
      enable_status_check:
        type: boolean
        x-go-name: EnableStatusCheck
      name:
        type: string
        x-go-name: Name
      protected:
        type: boolean
        x-go-name: Protected
      required_approvals:
        type: integer
        format: int64
        x-go-name: RequiredApprovals
      status_check_contexts:
        type: array
        items:
          type: string
        x-go-name: StatusCheckContexts
      user_can_merge:
        type: boolean
        x-go-name: UserCanMerge
      user_can_push:
        type: boolean
        x-go-name: UserCanPush
    x-go-package: code.gitea.io/gitea/modules/structs
  BranchProtection:
    description: BranchProtection represents a branch protection for a repository
    type: object
    properties:
      approvals_whitelist_teams:
        type: array
        items:
          type: string
        x-go-name: ApprovalsWhitelistTeams
      approvals_whitelist_username:
        type: array
        items:
          type: string
        x-go-name: ApprovalsWhitelistUsernames
      block_on_official_review_requests:
        type: boolean
        x-go-name: BlockOnOfficialReviewRequests
      block_on_outdated_branch:
        type: boolean
        x-go-name: BlockOnOutdatedBranch
      block_on_rejected_reviews:
        type: boolean
        x-go-name: BlockOnRejectedReviews
      branch_name:
        description: 'Deprecated: true'
        type: string
        x-go-name: BranchName
      created_at:
        type: string
        format: date-time
        x-go-name: Created
      dismiss_stale_approvals:
        type: boolean
        x-go-name: DismissStaleApprovals
      enable_approvals_whitelist:
        type: boolean
        x-go-name: EnableApprovalsWhitelist
      enable_merge_whitelist:
        type: boolean
        x-go-name: EnableMergeWhitelist
      enable_push:
        type: boolean
        x-go-name: EnablePush
      enable_push_whitelist:
        type: boolean
        x-go-name: EnablePushWhitelist
      enable_status_check:
        type: boolean
        x-go-name: EnableStatusCheck
      merge_whitelist_teams:
        type: array
        items:
          type: string
        x-go-name: MergeWhitelistTeams
      merge_whitelist_usernames:
        type: array
        items:
          type: string
        x-go-name: MergeWhitelistUsernames
      protected_file_patterns:
        type: string
        x-go-name: ProtectedFilePatterns
      push_whitelist_deploy_keys:
        type: boolean
        x-go-name: PushWhitelistDeployKeys
      push_whitelist_teams:
        type: array
        items:
          type: string
        x-go-name: PushWhitelistTeams
      push_whitelist_usernames:
        type: array
        items:
          type: string
        x-go-name: PushWhitelistUsernames
      require_signed_commits:
        type: boolean
        x-go-name: RequireSignedCommits
      required_approvals:
        type: integer
        format: int64
        x-go-name: RequiredApprovals
      rule_name:
        type: string
        x-go-name: RuleName
      status_check_contexts:
        type: array
        items:
          type: string
        x-go-name: StatusCheckContexts
      unprotected_file_patterns:
        type: string
        x-go-name: UnprotectedFilePatterns
      updated_at:
        type: string
        format: date-time
        x-go-name: Updated
    x-go-package: code.gitea.io/gitea/modules/structs
  ChangedFile:
    description: ChangedFile store information about files affected by the pull request
    type: object
    properties:
      additions:
        type: integer
        format: int64
        x-go-name: Additions
      changes:
        type: integer
        format: int64
        x-go-name: Changes
      contents_url:
        type: string
        x-go-name: ContentsURL
      deletions:
        type: integer
        format: int64
        x-go-name: Deletions
      filename:
        type: string
        x-go-name: Filename
      html_url:
        type: string
        x-go-name: HTMLURL
      previous_filename:
        type: string
        x-go-name: PreviousFilename
      raw_url:
        type: string
        x-go-name: RawURL
      status:
        type: string
        x-go-name: Status
    x-go-package: code.gitea.io/gitea/modules/structs
  CombinedStatus:
    description: >-
      CombinedStatus holds the combined state of several statuses for a single
      commit
    type: object
    properties:
      commit_url:
        type: string
        x-go-name: CommitURL
      repository:
        $ref: '#/definitions/Repository'
      sha:
        type: string
        x-go-name: SHA
      state:
        $ref: '#/definitions/CommitStatusState'
      statuses:
        type: array
        items:
          $ref: '#/definitions/CommitStatus'
        x-go-name: Statuses
      total_count:
        type: integer
        format: int64
        x-go-name: TotalCount
      url:
        type: string
        x-go-name: URL
    x-go-package: code.gitea.io/gitea/modules/structs
  Comment:
    description: Comment represents a comment on a commit or issue
    type: object
    properties:
      assets:
        type: array
        items:
          $ref: '#/definitions/Attachment'
        x-go-name: Attachments
      body:
        type: string
        x-go-name: Body
      created_at:
        type: string
        format: date-time
        x-go-name: Created
      html_url:
        type: string
        x-go-name: HTMLURL
      id:
        type: integer
        format: int64
        x-go-name: ID
      issue_url:
        type: string
        x-go-name: IssueURL
      original_author:
        type: string
        x-go-name: OriginalAuthor
      original_author_id:
        type: integer
        format: int64
        x-go-name: OriginalAuthorID
      pull_request_url:
        type: string
        x-go-name: PRURL
      updated_at:
        type: string
        format: date-time
        x-go-name: Updated
      user:
        $ref: '#/definitions/User'
    x-go-package: code.gitea.io/gitea/modules/structs
  Commit:
    type: object
    title: Commit contains information generated from a Git commit.
    properties:
      author:
        $ref: '#/definitions/User'
      commit:
        $ref: '#/definitions/RepoCommit'
      committer:
        $ref: '#/definitions/User'
      created:
        type: string
        format: date-time
        x-go-name: Created
      files:
        type: array
        items:
          $ref: '#/definitions/CommitAffectedFiles'
        x-go-name: Files
      html_url:
        type: string
        x-go-name: HTMLURL
      parents:
        type: array
        items:
          $ref: '#/definitions/CommitMeta'
        x-go-name: Parents
      sha:
        type: string
        x-go-name: SHA
      stats:
        $ref: '#/definitions/CommitStats'
      url:
        type: string
        x-go-name: URL
    x-go-package: code.gitea.io/gitea/modules/structs
  CommitAffectedFiles:
    description: CommitAffectedFiles store information about files affected by the commit
    type: object
    properties:
      filename:
        type: string
        x-go-name: Filename
    x-go-package: code.gitea.io/gitea/modules/structs
  CommitDateOptions:
    description: CommitDateOptions store dates for GIT_AUTHOR_DATE and GIT_COMMITTER_DATE
    type: object
    properties:
      author:
        type: string
        format: date-time
        x-go-name: Author
      committer:
        type: string
        format: date-time
        x-go-name: Committer
    x-go-package: code.gitea.io/gitea/modules/structs
  CommitMeta:
    type: object
    title: CommitMeta contains meta information of a commit in terms of API.
    properties:
      created:
        type: string
        format: date-time
        x-go-name: Created
      sha:
        type: string
        x-go-name: SHA
      url:
        type: string
        x-go-name: URL
    x-go-package: code.gitea.io/gitea/modules/structs
  CommitStats:
    description: CommitStats is statistics for a RepoCommit
    type: object
    properties:
      additions:
        type: integer
        format: int64
        x-go-name: Additions
      deletions:
        type: integer
        format: int64
        x-go-name: Deletions
      total:
        type: integer
        format: int64
        x-go-name: Total
    x-go-package: code.gitea.io/gitea/modules/structs
  CommitStatus:
    description: CommitStatus holds a single status of a single Commit
    type: object
    properties:
      context:
        type: string
        x-go-name: Context
      created_at:
        type: string
        format: date-time
        x-go-name: Created
      creator:
        $ref: '#/definitions/User'
      description:
        type: string
        x-go-name: Description
      id:
        type: integer
        format: int64
        x-go-name: ID
      status:
        $ref: '#/definitions/CommitStatusState'
      target_url:
        type: string
        x-go-name: TargetURL
      updated_at:
        type: string
        format: date-time
        x-go-name: Updated
      url:
        type: string
        x-go-name: URL
    x-go-package: code.gitea.io/gitea/modules/structs
  CommitStatusState:
    description: |-
      CommitStatusState holds the state of a CommitStatus
      It can be "pending", "success", "error", "failure", and "warning"
    type: string
    x-go-package: code.gitea.io/gitea/modules/structs
  CommitUser:
    type: object
    title: CommitUser contains information of a user in the context of a commit.
    properties:
      date:
        type: string
        x-go-name: Date
      email:
        type: string
        format: email
        x-go-name: Email
      name:
        type: string
        x-go-name: Name
    x-go-package: code.gitea.io/gitea/modules/structs
  ContentsResponse:
    description: >-
      ContentsResponse contains information about a repo's entry's (dir, file,
      symlink, submodule) metadata and content
    type: object
    properties:
      _links:
        $ref: '#/definitions/FileLinksResponse'
      content:
        description: '`content` is populated when `type` is `file`, otherwise null'
        type: string
        x-go-name: Content
      download_url:
        type: string
        x-go-name: DownloadURL
      encoding:
        description: '`encoding` is populated when `type` is `file`, otherwise null'
        type: string
        x-go-name: Encoding
      git_url:
        type: string
        x-go-name: GitURL
      html_url:
        type: string
        x-go-name: HTMLURL
      last_commit_sha:
        type: string
        x-go-name: LastCommitSHA
      name:
        type: string
        x-go-name: Name
      path:
        type: string
        x-go-name: Path
      sha:
        type: string
        x-go-name: SHA
      size:
        type: integer
        format: int64
        x-go-name: Size
      submodule_git_url:
        description: >-
          `submodule_git_url` is populated when `type` is `submodule`, otherwise
          null
        type: string
        x-go-name: SubmoduleGitURL
      target:
        description: '`target` is populated when `type` is `symlink`, otherwise null'
        type: string
        x-go-name: Target
      type:
        description: '`type` will be `file`, `dir`, `symlink`, or `submodule`'
        type: string
        x-go-name: Type
      url:
        type: string
        x-go-name: URL
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateAccessTokenOption:
    description: CreateAccessTokenOption options when create access token
    type: object
    required:
      - name
    properties:
      name:
        type: string
        x-go-name: Name
      scopes:
        type: array
        items:
          type: string
        x-go-name: Scopes
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateBranchProtectionOption:
    description: CreateBranchProtectionOption options for creating a branch protection
    type: object
    properties:
      approvals_whitelist_teams:
        type: array
        items:
          type: string
        x-go-name: ApprovalsWhitelistTeams
      approvals_whitelist_username:
        type: array
        items:
          type: string
        x-go-name: ApprovalsWhitelistUsernames
      block_on_official_review_requests:
        type: boolean
        x-go-name: BlockOnOfficialReviewRequests
      block_on_outdated_branch:
        type: boolean
        x-go-name: BlockOnOutdatedBranch
      block_on_rejected_reviews:
        type: boolean
        x-go-name: BlockOnRejectedReviews
      branch_name:
        description: 'Deprecated: true'
        type: string
        x-go-name: BranchName
      dismiss_stale_approvals:
        type: boolean
        x-go-name: DismissStaleApprovals
      enable_approvals_whitelist:
        type: boolean
        x-go-name: EnableApprovalsWhitelist
      enable_merge_whitelist:
        type: boolean
        x-go-name: EnableMergeWhitelist
      enable_push:
        type: boolean
        x-go-name: EnablePush
      enable_push_whitelist:
        type: boolean
        x-go-name: EnablePushWhitelist
      enable_status_check:
        type: boolean
        x-go-name: EnableStatusCheck
      merge_whitelist_teams:
        type: array
        items:
          type: string
        x-go-name: MergeWhitelistTeams
      merge_whitelist_usernames:
        type: array
        items:
          type: string
        x-go-name: MergeWhitelistUsernames
      protected_file_patterns:
        type: string
        x-go-name: ProtectedFilePatterns
      push_whitelist_deploy_keys:
        type: boolean
        x-go-name: PushWhitelistDeployKeys
      push_whitelist_teams:
        type: array
        items:
          type: string
        x-go-name: PushWhitelistTeams
      push_whitelist_usernames:
        type: array
        items:
          type: string
        x-go-name: PushWhitelistUsernames
      require_signed_commits:
        type: boolean
        x-go-name: RequireSignedCommits
      required_approvals:
        type: integer
        format: int64
        x-go-name: RequiredApprovals
      rule_name:
        type: string
        x-go-name: RuleName
      status_check_contexts:
        type: array
        items:
          type: string
        x-go-name: StatusCheckContexts
      unprotected_file_patterns:
        type: string
        x-go-name: UnprotectedFilePatterns
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateBranchRepoOption:
    description: CreateBranchRepoOption options when creating a branch in a repository
    type: object
    required:
      - new_branch_name
    properties:
      new_branch_name:
        description: Name of the branch to create
        type: string
        uniqueItems: true
        x-go-name: BranchName
      old_branch_name:
        description: Name of the old branch to create from
        type: string
        uniqueItems: true
        x-go-name: OldBranchName
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateEmailOption:
    description: CreateEmailOption options when creating email addresses
    type: object
    properties:
      emails:
        description: email addresses to add
        type: array
        items:
          type: string
        x-go-name: Emails
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateFileOptions:
    description: >-
      CreateFileOptions options for creating files

      Note: `author` and `committer` are optional (if only one is given, it will
      be used for the other, otherwise the authenticated user will be used)
    type: object
    required:
      - content
    properties:
      author:
        $ref: '#/definitions/Identity'
      branch:
        description: >-
          branch (optional) to base this file from. if not given, the default
          branch is used
        type: string
        x-go-name: BranchName
      committer:
        $ref: '#/definitions/Identity'
      content:
        description: content must be base64 encoded
        type: string
        x-go-name: Content
      dates:
        $ref: '#/definitions/CommitDateOptions'
      message:
        description: >-
          message (optional) for the commit of this file. if not supplied, a
          default message will be used
        type: string
        x-go-name: Message
      new_branch:
        description: >-
          new_branch (optional) will make a new branch from `branch` before
          creating the file
        type: string
        x-go-name: NewBranchName
      signoff:
        description: >-
          Add a Signed-off-by trailer by the committer at the end of the commit
          log message.
        type: boolean
        x-go-name: Signoff
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateForkOption:
    description: CreateForkOption options for creating a fork
    type: object
    properties:
      name:
        description: name of the forked repository
        type: string
        x-go-name: Name
      organization:
        description: organization name, if forking into an organization
        type: string
        x-go-name: Organization
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateGPGKeyOption:
    description: CreateGPGKeyOption options create user GPG key
    type: object
    required:
      - armored_public_key
    properties:
      armored_public_key:
        description: An armored GPG key to add
        type: string
        uniqueItems: true
        x-go-name: ArmoredKey
      armored_signature:
        type: string
        x-go-name: Signature
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateHookOption:
    description: CreateHookOption options when create a hook
    type: object
    required:
      - type
      - config
    properties:
      active:
        type: boolean
        default: false
        x-go-name: Active
      authorization_header:
        type: string
        x-go-name: AuthorizationHeader
      branch_filter:
        type: string
        x-go-name: BranchFilter
      config:
        $ref: '#/definitions/CreateHookOptionConfig'
      events:
        type: array
        items:
          type: string
        x-go-name: Events
      type:
        type: string
        enum:
          - dingtalk
          - discord
          - gitea
          - gogs
          - msteams
          - slack
          - telegram
          - feishu
          - wechatwork
          - packagist
        x-go-name: Type
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateHookOptionConfig:
    description: |-
      CreateHookOptionConfig has all config options in it
      required are "content_type" and "url" Required
    type: object
    additionalProperties:
      type: string
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateIssueCommentOption:
    description: CreateIssueCommentOption options for creating a comment on an issue
    type: object
    required:
      - body
    properties:
      body:
        type: string
        x-go-name: Body
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateIssueOption:
    description: CreateIssueOption options to create one issue
    type: object
    required:
      - title
    properties:
      assignee:
        description: deprecated
        type: string
        x-go-name: Assignee
      assignees:
        type: array
        items:
          type: string
        x-go-name: Assignees
      body:
        type: string
        x-go-name: Body
      closed:
        type: boolean
        x-go-name: Closed
      due_date:
        type: string
        format: date-time
        x-go-name: Deadline
      labels:
        description: list of label ids
        type: array
        items:
          type: integer
          format: int64
        x-go-name: Labels
      milestone:
        description: milestone id
        type: integer
        format: int64
        x-go-name: Milestone
      ref:
        type: string
        x-go-name: Ref
      title:
        type: string
        x-go-name: Title
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateKeyOption:
    description: CreateKeyOption options when creating a key
    type: object
    required:
      - title
      - key
    properties:
      key:
        description: An armored SSH key to add
        type: string
        uniqueItems: true
        x-go-name: Key
      read_only:
        description: Describe if the key has only read access or read/write
        type: boolean
        x-go-name: ReadOnly
      title:
        description: Title of the key to add
        type: string
        uniqueItems: true
        x-go-name: Title
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateLabelOption:
    description: CreateLabelOption options for creating a label
    type: object
    required:
      - name
      - color
    properties:
      color:
        type: string
        x-go-name: Color
        example: '#00aabb'
      description:
        type: string
        x-go-name: Description
      exclusive:
        type: boolean
        x-go-name: Exclusive
        example: false
      name:
        type: string
        x-go-name: Name
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateMilestoneOption:
    description: CreateMilestoneOption options for creating a milestone
    type: object
    properties:
      description:
        type: string
        x-go-name: Description
      due_on:
        type: string
        format: date-time
        x-go-name: Deadline
      state:
        type: string
        enum:
          - open
          - closed
        x-go-name: State
      title:
        type: string
        x-go-name: Title
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateOAuth2ApplicationOptions:
    description: >-
      CreateOAuth2ApplicationOptions holds options to create an oauth2
      application
    type: object
    properties:
      confidential_client:
        type: boolean
        x-go-name: ConfidentialClient
      name:
        type: string
        x-go-name: Name
      redirect_uris:
        type: array
        items:
          type: string
        x-go-name: RedirectURIs
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateOrgOption:
    description: CreateOrgOption options for creating an organization
    type: object
    required:
      - username
    properties:
      description:
        type: string
        x-go-name: Description
      full_name:
        type: string
        x-go-name: FullName
      location:
        type: string
        x-go-name: Location
      repo_admin_change_team_access:
        type: boolean
        x-go-name: RepoAdminChangeTeamAccess
      username:
        type: string
        x-go-name: UserName
      visibility:
        description: possible values are `public` (default), `limited` or `private`
        type: string
        enum:
          - public
          - limited
          - private
        x-go-name: Visibility
      website:
        type: string
        x-go-name: Website
    x-go-package: code.gitea.io/gitea/modules/structs
  CreatePullRequestOption:
    description: CreatePullRequestOption options when creating a pull request
    type: object
    properties:
      assignee:
        type: string
        x-go-name: Assignee
      assignees:
        type: array
        items:
          type: string
        x-go-name: Assignees
      base:
        type: string
        x-go-name: Base
      body:
        type: string
        x-go-name: Body
      due_date:
        type: string
        format: date-time
        x-go-name: Deadline
      head:
        type: string
        x-go-name: Head
      labels:
        type: array
        items:
          type: integer
          format: int64
        x-go-name: Labels
      milestone:
        type: integer
        format: int64
        x-go-name: Milestone
      title:
        type: string
        x-go-name: Title
    x-go-package: code.gitea.io/gitea/modules/structs
  CreatePullReviewComment:
    description: CreatePullReviewComment represent a review comment for creation api
    type: object
    properties:
      body:
        type: string
        x-go-name: Body
      new_position:
        description: if comment to new file line or 0
        type: integer
        format: int64
        x-go-name: NewLineNum
      old_position:
        description: if comment to old file line or 0
        type: integer
        format: int64
        x-go-name: OldLineNum
      path:
        description: the tree path
        type: string
        x-go-name: Path
    x-go-package: code.gitea.io/gitea/modules/structs
  CreatePullReviewOptions:
    description: CreatePullReviewOptions are options to create a pull review
    type: object
    properties:
      body:
        type: string
        x-go-name: Body
      comments:
        type: array
        items:
          $ref: '#/definitions/CreatePullReviewComment'
        x-go-name: Comments
      commit_id:
        type: string
        x-go-name: CommitID
      event:
        $ref: '#/definitions/ReviewStateType'
    x-go-package: code.gitea.io/gitea/modules/structs
  CreatePushMirrorOption:
    type: object
    title: >-
      CreatePushMirrorOption represents need information to create a push mirror
      of a repository.
    properties:
      interval:
        type: string
        x-go-name: Interval
      remote_address:
        type: string
        x-go-name: RemoteAddress
      remote_password:
        type: string
        x-go-name: RemotePassword
      remote_username:
        type: string
        x-go-name: RemoteUsername
      sync_on_commit:
        type: boolean
        x-go-name: SyncOnCommit
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateReleaseOption:
    description: CreateReleaseOption options when creating a release
    type: object
    required:
      - tag_name
    properties:
      body:
        type: string
        x-go-name: Note
      draft:
        type: boolean
        x-go-name: IsDraft
      name:
        type: string
        x-go-name: Title
      prerelease:
        type: boolean
        x-go-name: IsPrerelease
      tag_name:
        type: string
        x-go-name: TagName
      target_commitish:
        type: string
        x-go-name: Target
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateRepoOption:
    description: CreateRepoOption options when creating repository
    type: object
    required:
      - name
    properties:
      auto_init:
        description: Whether the repository should be auto-initialized?
        type: boolean
        x-go-name: AutoInit
      default_branch:
        description: >-
          DefaultBranch of the repository (used when initializes and in
          template)
        type: string
        x-go-name: DefaultBranch
      description:
        description: Description of the repository to create
        type: string
        x-go-name: Description
      gitignores:
        description: Gitignores to use
        type: string
        x-go-name: Gitignores
      issue_labels:
        description: Label-Set to use
        type: string
        x-go-name: IssueLabels
      license:
        description: License to use
        type: string
        x-go-name: License
      name:
        description: Name of the repository to create
        type: string
        uniqueItems: true
        x-go-name: Name
      private:
        description: Whether the repository is private
        type: boolean
        x-go-name: Private
      readme:
        description: Readme of the repository to create
        type: string
        x-go-name: Readme
      template:
        description: Whether the repository is template
        type: boolean
        x-go-name: Template
      trust_model:
        description: TrustModel of the repository
        type: string
        enum:
          - default
          - collaborator
          - committer
          - collaboratorcommitter
        x-go-name: TrustModel
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateStatusOption:
    description: >-
      CreateStatusOption holds the information needed to create a new
      CommitStatus for a Commit
    type: object
    properties:
      context:
        type: string
        x-go-name: Context
      description:
        type: string
        x-go-name: Description
      state:
        $ref: '#/definitions/CommitStatusState'
      target_url:
        type: string
        x-go-name: TargetURL
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateTagOption:
    description: CreateTagOption options when creating a tag
    type: object
    required:
      - tag_name
    properties:
      message:
        type: string
        x-go-name: Message
      tag_name:
        type: string
        x-go-name: TagName
      target:
        type: string
        x-go-name: Target
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateTeamOption:
    description: CreateTeamOption options for creating a team
    type: object
    required:
      - name
    properties:
      can_create_org_repo:
        type: boolean
        x-go-name: CanCreateOrgRepo
      description:
        type: string
        x-go-name: Description
      includes_all_repositories:
        type: boolean
        x-go-name: IncludesAllRepositories
      name:
        type: string
        x-go-name: Name
      permission:
        type: string
        enum:
          - read
          - write
          - admin
        x-go-name: Permission
      units:
        type: array
        items:
          type: string
        x-go-name: Units
        example:
          - repo.code
          - repo.issues
          - repo.ext_issues
          - repo.wiki
          - repo.pulls
          - repo.releases
          - repo.projects
          - repo.ext_wiki
      units_map:
        type: object
        additionalProperties:
          type: string
        x-go-name: UnitsMap
        example:
          repo.code: read
          repo.ext_issues: none
          repo.ext_wiki: none
          repo.issues: write
          repo.projects: none
          repo.pulls: owner
          repo.releases: none
          repo.wiki: admin
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateUserOption:
    description: CreateUserOption create user options
    type: object
    required:
      - username
      - email
      - password
    properties:
      created_at:
        description: >-
          For explicitly setting the user creation timestamp. Useful when users
          are

          migrated from other systems. When omitted, the user's creation
          timestamp

          will be set to "now".
        type: string
        format: date-time
        x-go-name: Created
      email:
        type: string
        format: email
        x-go-name: Email
      full_name:
        type: string
        x-go-name: FullName
      login_name:
        type: string
        x-go-name: LoginName
      must_change_password:
        type: boolean
        x-go-name: MustChangePassword
      password:
        type: string
        x-go-name: Password
      restricted:
        type: boolean
        x-go-name: Restricted
      send_notify:
        type: boolean
        x-go-name: SendNotify
      source_id:
        type: integer
        format: int64
        x-go-name: SourceID
      username:
        type: string
        x-go-name: Username
      visibility:
        type: string
        x-go-name: Visibility
    x-go-package: code.gitea.io/gitea/modules/structs
  CreateWikiPageOptions:
    description: CreateWikiPageOptions form for creating wiki
    type: object
    properties:
      content_base64:
        description: content must be base64 encoded
        type: string
        x-go-name: ContentBase64
      message:
        description: optional commit message summarizing the change
        type: string
        x-go-name: Message
      title:
        description: page title. leave empty to keep unchanged
        type: string
        x-go-name: Title
    x-go-package: code.gitea.io/gitea/modules/structs
  Cron:
    description: Cron represents a Cron task
    type: object
    properties:
      exec_times:
        type: integer
        format: int64
        x-go-name: ExecTimes
      name:
        type: string
        x-go-name: Name
      next:
        type: string
        format: date-time
        x-go-name: Next
      prev:
        type: string
        format: date-time
        x-go-name: Prev
      schedule:
        type: string
        x-go-name: Schedule
    x-go-package: code.gitea.io/gitea/modules/structs
  DeleteEmailOption:
    description: DeleteEmailOption options when deleting email addresses
    type: object
    properties:
      emails:
        description: email addresses to delete
        type: array
        items:
          type: string
        x-go-name: Emails
    x-go-package: code.gitea.io/gitea/modules/structs
  DeleteFileOptions:
    description: >-
      DeleteFileOptions options for deleting files (used for other File structs
      below)

      Note: `author` and `committer` are optional (if only one is given, it will
      be used for the other, otherwise the authenticated user will be used)
    type: object
    required:
      - sha
    properties:
      author:
        $ref: '#/definitions/Identity'
      branch:
        description: >-
          branch (optional) to base this file from. if not given, the default
          branch is used
        type: string
        x-go-name: BranchName
      committer:
        $ref: '#/definitions/Identity'
      dates:
        $ref: '#/definitions/CommitDateOptions'
      message:
        description: >-
          message (optional) for the commit of this file. if not supplied, a
          default message will be used
        type: string
        x-go-name: Message
      new_branch:
        description: >-
          new_branch (optional) will make a new branch from `branch` before
          creating the file
        type: string
        x-go-name: NewBranchName
      sha:
        description: sha is the SHA for the file that already exists
        type: string
        x-go-name: SHA
      signoff:
        description: >-
          Add a Signed-off-by trailer by the committer at the end of the commit
          log message.
        type: boolean
        x-go-name: Signoff
    x-go-package: code.gitea.io/gitea/modules/structs
  DeployKey:
    description: DeployKey a deploy key
    type: object
    properties:
      created_at:
        type: string
        format: date-time
        x-go-name: Created
      fingerprint:
        type: string
        x-go-name: Fingerprint
      id:
        type: integer
        format: int64
        x-go-name: ID
      key:
        type: string
        x-go-name: Key
      key_id:
        type: integer
        format: int64
        x-go-name: KeyID
      read_only:
        type: boolean
        x-go-name: ReadOnly
      repository:
        $ref: '#/definitions/Repository'
      title:
        type: string
        x-go-name: Title
      url:
        type: string
        x-go-name: URL
    x-go-package: code.gitea.io/gitea/modules/structs
  DismissPullReviewOptions:
    description: DismissPullReviewOptions are options to dismiss a pull review
    type: object
    properties:
      message:
        type: string
        x-go-name: Message
      priors:
        type: boolean
        x-go-name: Priors
    x-go-package: code.gitea.io/gitea/modules/structs
  EditAttachmentOptions:
    description: EditAttachmentOptions options for editing attachments
    type: object
    properties:
      name:
        type: string
        x-go-name: Name
    x-go-package: code.gitea.io/gitea/modules/structs
  EditBranchProtectionOption:
    description: EditBranchProtectionOption options for editing a branch protection
    type: object
    properties:
      approvals_whitelist_teams:
        type: array
        items:
          type: string
        x-go-name: ApprovalsWhitelistTeams
      approvals_whitelist_username:
        type: array
        items:
          type: string
        x-go-name: ApprovalsWhitelistUsernames
      block_on_official_review_requests:
        type: boolean
        x-go-name: BlockOnOfficialReviewRequests
      block_on_outdated_branch:
        type: boolean
        x-go-name: BlockOnOutdatedBranch
      block_on_rejected_reviews:
        type: boolean
        x-go-name: BlockOnRejectedReviews
      dismiss_stale_approvals:
        type: boolean
        x-go-name: DismissStaleApprovals
      enable_approvals_whitelist:
        type: boolean
        x-go-name: EnableApprovalsWhitelist
      enable_merge_whitelist:
        type: boolean
        x-go-name: EnableMergeWhitelist
      enable_push:
        type: boolean
        x-go-name: EnablePush
      enable_push_whitelist:
        type: boolean
        x-go-name: EnablePushWhitelist
      enable_status_check:
        type: boolean
        x-go-name: EnableStatusCheck
      merge_whitelist_teams:
        type: array
        items:
          type: string
        x-go-name: MergeWhitelistTeams
      merge_whitelist_usernames:
        type: array
        items:
          type: string
        x-go-name: MergeWhitelistUsernames
      protected_file_patterns:
        type: string
        x-go-name: ProtectedFilePatterns
      push_whitelist_deploy_keys:
        type: boolean
        x-go-name: PushWhitelistDeployKeys
      push_whitelist_teams:
        type: array
        items:
          type: string
        x-go-name: PushWhitelistTeams
      push_whitelist_usernames:
        type: array
        items:
          type: string
        x-go-name: PushWhitelistUsernames
      require_signed_commits:
        type: boolean
        x-go-name: RequireSignedCommits
      required_approvals:
        type: integer
        format: int64
        x-go-name: RequiredApprovals
      status_check_contexts:
        type: array
        items:
          type: string
        x-go-name: StatusCheckContexts
      unprotected_file_patterns:
        type: string
        x-go-name: UnprotectedFilePatterns
    x-go-package: code.gitea.io/gitea/modules/structs
  EditDeadlineOption:
    description: EditDeadlineOption options for creating a deadline
    type: object
    required:
      - due_date
    properties:
      due_date:
        type: string
        format: date-time
        x-go-name: Deadline
    x-go-package: code.gitea.io/gitea/modules/structs
  EditGitHookOption:
    description: EditGitHookOption options when modifying one Git hook
    type: object
    properties:
      content:
        type: string
        x-go-name: Content
    x-go-package: code.gitea.io/gitea/modules/structs
  EditHookOption:
    description: EditHookOption options when modify one hook
    type: object
    properties:
      active:
        type: boolean
        x-go-name: Active
      authorization_header:
        type: string
        x-go-name: AuthorizationHeader
      branch_filter:
        type: string
        x-go-name: BranchFilter
      config:
        type: object
        additionalProperties:
          type: string
        x-go-name: Config
      events:
        type: array
        items:
          type: string
        x-go-name: Events
    x-go-package: code.gitea.io/gitea/modules/structs
  EditIssueCommentOption:
    description: EditIssueCommentOption options for editing a comment
    type: object
    required:
      - body
    properties:
      body:
        type: string
        x-go-name: Body
    x-go-package: code.gitea.io/gitea/modules/structs
  EditIssueOption:
    description: EditIssueOption options for editing an issue
    type: object
    properties:
      assignee:
        description: deprecated
        type: string
        x-go-name: Assignee
      assignees:
        type: array
        items:
          type: string
        x-go-name: Assignees
      body:
        type: string
        x-go-name: Body
      due_date:
        type: string
        format: date-time
        x-go-name: Deadline
      milestone:
        type: integer
        format: int64
        x-go-name: Milestone
      ref:
        type: string
        x-go-name: Ref
      state:
        type: string
        x-go-name: State
      title:
        type: string
        x-go-name: Title
      unset_due_date:
        type: boolean
        x-go-name: RemoveDeadline
    x-go-package: code.gitea.io/gitea/modules/structs
  EditLabelOption:
    description: EditLabelOption options for editing a label
    type: object
    properties:
      color:
        type: string
        x-go-name: Color
        example: '#00aabb'
      description:
        type: string
        x-go-name: Description
      exclusive:
        type: boolean
        x-go-name: Exclusive
        example: false
      name:
        type: string
        x-go-name: Name
    x-go-package: code.gitea.io/gitea/modules/structs
  EditMilestoneOption:
    description: EditMilestoneOption options for editing a milestone
    type: object
    properties:
      description:
        type: string
        x-go-name: Description
      due_on:
        type: string
        format: date-time
        x-go-name: Deadline
      state:
        type: string
        x-go-name: State
      title:
        type: string
        x-go-name: Title
    x-go-package: code.gitea.io/gitea/modules/structs
  EditOrgOption:
    description: EditOrgOption options for editing an organization
    type: object
    properties:
      description:
        type: string
        x-go-name: Description
      full_name:
        type: string
        x-go-name: FullName
      location:
        type: string
        x-go-name: Location
      repo_admin_change_team_access:
        type: boolean
        x-go-name: RepoAdminChangeTeamAccess
      visibility:
        description: possible values are `public`, `limited` or `private`
        type: string
        enum:
          - public
          - limited
          - private
        x-go-name: Visibility
      website:
        type: string
        x-go-name: Website
    x-go-package: code.gitea.io/gitea/modules/structs
  EditPullRequestOption:
    description: EditPullRequestOption options when modify pull request
    type: object
    properties:
      allow_maintainer_edit:
        type: boolean
        x-go-name: AllowMaintainerEdit
      assignee:
        type: string
        x-go-name: Assignee
      assignees:
        type: array
        items:
          type: string
        x-go-name: Assignees
      base:
        type: string
        x-go-name: Base
      body:
        type: string
        x-go-name: Body
      due_date:
        type: string
        format: date-time
        x-go-name: Deadline
      labels:
        type: array
        items:
          type: integer
          format: int64
        x-go-name: Labels
      milestone:
        type: integer
        format: int64
        x-go-name: Milestone
      state:
        type: string
        x-go-name: State
      title:
        type: string
        x-go-name: Title
      unset_due_date:
        type: boolean
        x-go-name: RemoveDeadline
    x-go-package: code.gitea.io/gitea/modules/structs
  EditReactionOption:
    description: EditReactionOption contain the reaction type
    type: object
    properties:
      content:
        type: string
        x-go-name: Reaction
    x-go-package: code.gitea.io/gitea/modules/structs
  EditReleaseOption:
    description: EditReleaseOption options when editing a release
    type: object
    properties:
      body:
        type: string
        x-go-name: Note
      draft:
        type: boolean
        x-go-name: IsDraft
      name:
        type: string
        x-go-name: Title
      prerelease:
        type: boolean
        x-go-name: IsPrerelease
      tag_name:
        type: string
        x-go-name: TagName
      target_commitish:
        type: string
        x-go-name: Target
    x-go-package: code.gitea.io/gitea/modules/structs
  EditRepoOption:
    description: EditRepoOption options when editing a repository's properties
    type: object
    properties:
      allow_manual_merge:
        description: >-
          either `true` to allow mark pr as merged manually, or `false` to
          prevent it.
        type: boolean
        x-go-name: AllowManualMerge
      allow_merge_commits:
        description: >-
          either `true` to allow merging pull requests with a merge commit, or
          `false` to prevent merging pull requests with merge commits.
        type: boolean
        x-go-name: AllowMerge
      allow_rebase:
        description: >-
          either `true` to allow rebase-merging pull requests, or `false` to
          prevent rebase-merging.
        type: boolean
        x-go-name: AllowRebase
      allow_rebase_explicit:
        description: >-
          either `true` to allow rebase with explicit merge commits (--no-ff),
          or `false` to prevent rebase with explicit merge commits.
        type: boolean
        x-go-name: AllowRebaseMerge
      allow_rebase_update:
        description: >-
          either `true` to allow updating pull request branch by rebase, or
          `false` to prevent it.
        type: boolean
        x-go-name: AllowRebaseUpdate
      allow_squash_merge:
        description: >-
          either `true` to allow squash-merging pull requests, or `false` to
          prevent squash-merging.
        type: boolean
        x-go-name: AllowSquash
      archived:
        description: set to `true` to archive this repository.
        type: boolean
        x-go-name: Archived
      autodetect_manual_merge:
        description: >-
          either `true` to enable AutodetectManualMerge, or `false` to prevent
          it. Note: In some special cases, misjudgments can occur.
        type: boolean
        x-go-name: AutodetectManualMerge
      default_allow_maintainer_edit:
        description: set to `true` to allow edits from maintainers by default
        type: boolean
        x-go-name: DefaultAllowMaintainerEdit
      default_branch:
        description: sets the default branch for this repository.
        type: string
        x-go-name: DefaultBranch
      default_delete_branch_after_merge:
        description: set to `true` to delete pr branch after merge by default
        type: boolean
        x-go-name: DefaultDeleteBranchAfterMerge
      default_merge_style:
        description: >-
          set to a merge style to be used by this repository: "merge", "rebase",
          "rebase-merge", or "squash".
        type: string
        x-go-name: DefaultMergeStyle
      description:
        description: a short description of the repository.
        type: string
        x-go-name: Description
      enable_prune:
        description: enable prune - remove obsolete remote-tracking references
        type: boolean
        x-go-name: EnablePrune
      external_tracker:
        $ref: '#/definitions/ExternalTracker'
      external_wiki:
        $ref: '#/definitions/ExternalWiki'
      has_issues:
        description: >-
          either `true` to enable issues for this repository or `false` to
          disable them.
        type: boolean
        x-go-name: HasIssues
      has_projects:
        description: either `true` to enable project unit, or `false` to disable them.
        type: boolean
        x-go-name: HasProjects
      has_pull_requests:
        description: >-
          either `true` to allow pull requests, or `false` to prevent pull
          request.
        type: boolean
        x-go-name: HasPullRequests
      has_wiki:
        description: >-
          either `true` to enable the wiki for this repository or `false` to
          disable it.
        type: boolean
        x-go-name: HasWiki
      ignore_whitespace_conflicts:
        description: >-
          either `true` to ignore whitespace for conflicts, or `false` to not
          ignore whitespace.
        type: boolean
        x-go-name: IgnoreWhitespaceConflicts
      internal_tracker:
        $ref: '#/definitions/InternalTracker'
      mirror_interval:
        description: set to a string like `8h30m0s` to set the mirror interval time
        type: string
        x-go-name: MirrorInterval
      name:
        description: name of the repository
        type: string
        uniqueItems: true
        x-go-name: Name
      private:
        description: >-
          either `true` to make the repository private or `false` to make it
          public.

          Note: you will get a 422 error if the organization restricts changing
          repository visibility to organization

          owners and a non-owner tries to change the value of private.
        type: boolean
        x-go-name: Private
      template:
        description: >-
          either `true` to make this repository a template or `false` to make it
          a normal repository
        type: boolean
        x-go-name: Template
      website:
        description: a URL with more information about the repository.
        type: string
        x-go-name: Website
    x-go-package: code.gitea.io/gitea/modules/structs
  EditTeamOption:
    description: EditTeamOption options for editing a team
    type: object
    required:
      - name
    properties:
      can_create_org_repo:
        type: boolean
        x-go-name: CanCreateOrgRepo
      description:
        type: string
        x-go-name: Description
      includes_all_repositories:
        type: boolean
        x-go-name: IncludesAllRepositories
      name:
        type: string
        x-go-name: Name
      permission:
        type: string
        enum:
          - read
          - write
          - admin
        x-go-name: Permission
      units:
        type: array
        items:
          type: string
        x-go-name: Units
        example:
          - repo.code
          - repo.issues
          - repo.ext_issues
          - repo.wiki
          - repo.pulls
          - repo.releases
          - repo.projects
          - repo.ext_wiki
      units_map:
        type: object
        additionalProperties:
          type: string
        x-go-name: UnitsMap
        example:
          repo.code: read
          repo.ext_issues: none
          repo.ext_wiki: none
          repo.issues: write
          repo.projects: none
          repo.pulls: owner
          repo.releases: none
          repo.wiki: admin
    x-go-package: code.gitea.io/gitea/modules/structs
  EditUserOption:
    description: EditUserOption edit user options
    type: object
    required:
      - source_id
      - login_name
    properties:
      active:
        type: boolean
        x-go-name: Active
      admin:
        type: boolean
        x-go-name: Admin
      allow_create_organization:
        type: boolean
        x-go-name: AllowCreateOrganization
      allow_git_hook:
        type: boolean
        x-go-name: AllowGitHook
      allow_import_local:
        type: boolean
        x-go-name: AllowImportLocal
      description:
        type: string
        x-go-name: Description
      email:
        type: string
        format: email
        x-go-name: Email
      full_name:
        type: string
        x-go-name: FullName
      location:
        type: string
        x-go-name: Location
      login_name:
        type: string
        x-go-name: LoginName
      max_repo_creation:
        type: integer
        format: int64
        x-go-name: MaxRepoCreation
      must_change_password:
        type: boolean
        x-go-name: MustChangePassword
      password:
        type: string
        x-go-name: Password
      prohibit_login:
        type: boolean
        x-go-name: ProhibitLogin
      restricted:
        type: boolean
        x-go-name: Restricted
      source_id:
        type: integer
        format: int64
        x-go-name: SourceID
      visibility:
        type: string
        x-go-name: Visibility
      website:
        type: string
        x-go-name: Website
    x-go-package: code.gitea.io/gitea/modules/structs
  Email:
    description: Email an email address belonging to a user
    type: object
    properties:
      email:
        type: string
        format: email
        x-go-name: Email
      primary:
        type: boolean
        x-go-name: Primary
      verified:
        type: boolean
        x-go-name: Verified
    x-go-package: code.gitea.io/gitea/modules/structs
  ExternalTracker:
    description: ExternalTracker represents settings for external tracker
    type: object
    properties:
      external_tracker_format:
        description: >-
          External Issue Tracker URL Format. Use the placeholders {user}, {repo}
          and {index} for the username, repository name and issue index.
        type: string
        x-go-name: ExternalTrackerFormat
      external_tracker_regexp_pattern:
        description: External Issue Tracker issue regular expression
        type: string
        x-go-name: ExternalTrackerRegexpPattern
      external_tracker_style:
        description: >-
          External Issue Tracker Number Format, either `numeric`,
          `alphanumeric`, or `regexp`
        type: string
        x-go-name: ExternalTrackerStyle
      external_tracker_url:
        description: URL of external issue tracker.
        type: string
        x-go-name: ExternalTrackerURL
    x-go-package: code.gitea.io/gitea/modules/structs
  ExternalWiki:
    description: ExternalWiki represents setting for external wiki
    type: object
    properties:
      external_wiki_url:
        description: URL of external wiki.
        type: string
        x-go-name: ExternalWikiURL
    x-go-package: code.gitea.io/gitea/modules/structs
  FileCommitResponse:
    type: object
    title: >-
      FileCommitResponse contains information generated from a Git commit for a
      repo's file.
    properties:
      author:
        $ref: '#/definitions/CommitUser'
      committer:
        $ref: '#/definitions/CommitUser'
      created:
        type: string
        format: date-time
        x-go-name: Created
      html_url:
        type: string
        x-go-name: HTMLURL
      message:
        type: string
        x-go-name: Message
      parents:
        type: array
        items:
          $ref: '#/definitions/CommitMeta'
        x-go-name: Parents
      sha:
        type: string
        x-go-name: SHA
      tree:
        $ref: '#/definitions/CommitMeta'
      url:
        type: string
        x-go-name: URL
    x-go-package: code.gitea.io/gitea/modules/structs
  FileDeleteResponse:
    description: >-
      FileDeleteResponse contains information about a repo's file that was
      deleted
    type: object
    properties:
      commit:
        $ref: '#/definitions/FileCommitResponse'
      content:
        x-go-name: Content
      verification:
        $ref: '#/definitions/PayloadCommitVerification'
    x-go-package: code.gitea.io/gitea/modules/structs
  FileLinksResponse:
    description: FileLinksResponse contains the links for a repo's file
    type: object
    properties:
      git:
        type: string
        x-go-name: GitURL
      html:
        type: string
        x-go-name: HTMLURL
      self:
        type: string
        x-go-name: Self
    x-go-package: code.gitea.io/gitea/modules/structs
  FileResponse:
    description: FileResponse contains information about a repo's file
    type: object
    properties:
      commit:
        $ref: '#/definitions/FileCommitResponse'
      content:
        $ref: '#/definitions/ContentsResponse'
      verification:
        $ref: '#/definitions/PayloadCommitVerification'
    x-go-package: code.gitea.io/gitea/modules/structs
  GPGKey:
    description: GPGKey a user GPG key to sign commit and tag in repository
    type: object
    properties:
      can_certify:
        type: boolean
        x-go-name: CanCertify
      can_encrypt_comms:
        type: boolean
        x-go-name: CanEncryptComms
      can_encrypt_storage:
        type: boolean
        x-go-name: CanEncryptStorage
      can_sign:
        type: boolean
        x-go-name: CanSign
      created_at:
        type: string
        format: date-time
        x-go-name: Created
      emails:
        type: array
        items:
          $ref: '#/definitions/GPGKeyEmail'
        x-go-name: Emails
      expires_at:
        type: string
        format: date-time
        x-go-name: Expires
      id:
        type: integer
        format: int64
        x-go-name: ID
      key_id:
        type: string
        x-go-name: KeyID
      primary_key_id:
        type: string
        x-go-name: PrimaryKeyID
      public_key:
        type: string
        x-go-name: PublicKey
      subkeys:
        type: array
        items:
          $ref: '#/definitions/GPGKey'
        x-go-name: SubsKey
      verified:
        type: boolean
        x-go-name: Verified
    x-go-package: code.gitea.io/gitea/modules/structs
  GPGKeyEmail:
    description: GPGKeyEmail an email attached to a GPGKey
    type: object
    properties:
      email:
        type: string
        x-go-name: Email
      verified:
        type: boolean
        x-go-name: Verified
    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:
        type: integer
        format: int64
        x-go-name: DefaultGitTreesPerPage
      default_max_blob_size:
        type: integer
        format: int64
        x-go-name: DefaultMaxBlobSize
      default_paging_num:
        type: integer
        format: int64
        x-go-name: DefaultPagingNum
      max_response_items:
        type: integer
        format: int64
        x-go-name: MaxResponseItems
    x-go-package: code.gitea.io/gitea/modules/structs
  GeneralAttachmentSettings:
    description: >-
      GeneralAttachmentSettings contains global Attachment settings exposed by
      API
    type: object
    properties:
      allowed_types:
        type: string
        x-go-name: AllowedTypes
      enabled:
        type: boolean
        x-go-name: Enabled
      max_files:
        type: integer
        format: int64
        x-go-name: MaxFiles
      max_size:
        type: integer
        format: int64
        x-go-name: MaxSize
    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:
        type: boolean
        x-go-name: HTTPGitDisabled
      lfs_disabled:
        type: boolean
        x-go-name: LFSDisabled
      migrations_disabled:
        type: boolean
        x-go-name: MigrationsDisabled
      mirrors_disabled:
        type: boolean
        x-go-name: MirrorsDisabled
      stars_disabled:
        type: boolean
        x-go-name: StarsDisabled
      time_tracking_disabled:
        type: boolean
        x-go-name: TimeTrackingDisabled
    x-go-package: code.gitea.io/gitea/modules/structs
  GeneralUISettings:
    description: GeneralUISettings contains global ui settings exposed by API
    type: object
    properties:
      allowed_reactions:
        type: array
        items:
          type: string
        x-go-name: AllowedReactions
      custom_emojis:
        type: array
        items:
          type: string
        x-go-name: CustomEmojis
      default_theme:
        type: string
        x-go-name: DefaultTheme
    x-go-package: code.gitea.io/gitea/modules/structs
  GenerateRepoOption:
    description: GenerateRepoOption options when creating repository using a template
    type: object
    required:
      - owner
      - name
    properties:
      avatar:
        description: include avatar of the template repo
        type: boolean
        x-go-name: Avatar
      default_branch:
        description: Default branch of the new repository
        type: string
        x-go-name: DefaultBranch
      description:
        description: Description of the repository to create
        type: string
        x-go-name: Description
      git_content:
        description: include git content of default branch in template repo
        type: boolean
        x-go-name: GitContent
      git_hooks:
        description: include git hooks in template repo
        type: boolean
        x-go-name: GitHooks
      labels:
        description: include labels in template repo
        type: boolean
        x-go-name: Labels
      name:
        description: Name of the repository to create
        type: string
        uniqueItems: true
        x-go-name: Name
      owner:
        description: The organization or person who will own the new repository
        type: string
        x-go-name: Owner
      private:
        description: Whether the repository is private
        type: boolean
        x-go-name: Private
      topics:
        description: include topics in template repo
        type: boolean
        x-go-name: Topics
      webhooks:
        description: include webhooks in template repo
        type: boolean
        x-go-name: Webhooks
    x-go-package: code.gitea.io/gitea/modules/structs
  GitBlobResponse:
    description: GitBlobResponse represents a git blob
    type: object
    properties:
      content:
        type: string
        x-go-name: Content
      encoding:
        type: string
        x-go-name: Encoding
      sha:
        type: string
        x-go-name: SHA
      size:
        type: integer
        format: int64
        x-go-name: Size
      url:
        type: string
        x-go-name: URL
    x-go-package: code.gitea.io/gitea/modules/structs
  GitEntry:
    description: GitEntry represents a git tree
    type: object
    properties:
      mode:
        type: string
        x-go-name: Mode
      path:
        type: string
        x-go-name: Path
      sha:
        type: string
        x-go-name: SHA
      size:
        type: integer
        format: int64
        x-go-name: Size
      type:
        type: string
        x-go-name: Type
      url:
        type: string
        x-go-name: URL
    x-go-package: code.gitea.io/gitea/modules/structs
  GitHook:
    description: GitHook represents a Git repository hook
    type: object
    properties:
      content:
        type: string
        x-go-name: Content
      is_active:
        type: boolean
        x-go-name: IsActive
      name:
        type: string
        x-go-name: Name
    x-go-package: code.gitea.io/gitea/modules/structs
  GitObject:
    type: object
    title: GitObject represents a Git object.
    properties:
      sha:
        type: string
        x-go-name: SHA
      type:
        type: string
        x-go-name: Type
      url:
        type: string
        x-go-name: URL
    x-go-package: code.gitea.io/gitea/modules/structs
  GitTreeResponse:
    description: GitTreeResponse returns a git tree
    type: object
    properties:
      page:
        type: integer
        format: int64
        x-go-name: Page
      sha:
        type: string
        x-go-name: SHA
      total_count:
        type: integer
        format: int64
        x-go-name: TotalCount
      tree:
        type: array
        items:
          $ref: '#/definitions/GitEntry'
        x-go-name: Entries
      truncated:
        type: boolean
        x-go-name: Truncated
      url:
        type: string
        x-go-name: URL
    x-go-package: code.gitea.io/gitea/modules/structs
  Hook:
    description: Hook a hook is a web hook when one repository changed
    type: object
    properties:
      active:
        type: boolean
        x-go-name: Active
      authorization_header:
        type: string
        x-go-name: AuthorizationHeader
      config:
        type: object
        additionalProperties:
          type: string
        x-go-name: Config
      created_at:
        type: string
        format: date-time
        x-go-name: Created
      events:
        type: array
        items:
          type: string
        x-go-name: Events
      id:
        type: integer
        format: int64
        x-go-name: ID
      type:
        type: string
        x-go-name: Type
      updated_at:
        type: string
        format: date-time
        x-go-name: Updated
    x-go-package: code.gitea.io/gitea/modules/structs
  Identity:
    description: Identity for a person's identity like an author or committer
    type: object
    properties:
      email:
        type: string
        format: email
        x-go-name: Email
      name:
        type: string
        x-go-name: Name
    x-go-package: code.gitea.io/gitea/modules/structs
  InternalTracker:
    description: InternalTracker represents settings for internal tracker
    type: object
    properties:
      allow_only_contributors_to_track_time:
        description: Let only contributors track time (Built-in issue tracker)
        type: boolean
        x-go-name: AllowOnlyContributorsToTrackTime
      enable_issue_dependencies:
        description: >-
          Enable dependencies for issues and pull requests (Built-in issue
          tracker)
        type: boolean
        x-go-name: EnableIssueDependencies
      enable_time_tracker:
        description: Enable time tracking (Built-in issue tracker)
        type: boolean
        x-go-name: EnableTimeTracker
    x-go-package: code.gitea.io/gitea/modules/structs
  Issue:
    description: Issue represents an issue in a repository
    type: object
    properties:
      assets:
        type: array
        items:
          $ref: '#/definitions/Attachment'
        x-go-name: Attachments
      assignee:
        $ref: '#/definitions/User'
      assignees:
        type: array
        items:
          $ref: '#/definitions/User'
        x-go-name: Assignees
      body:
        type: string
        x-go-name: Body
      closed_at:
        type: string
        format: date-time
        x-go-name: Closed
      comments:
        type: integer
        format: int64
        x-go-name: Comments
      created_at:
        type: string
        format: date-time
        x-go-name: Created
      due_date:
        type: string
        format: date-time
        x-go-name: Deadline
      html_url:
        type: string
        x-go-name: HTMLURL
      id:
        type: integer
        format: int64
        x-go-name: ID
      is_locked:
        type: boolean
        x-go-name: IsLocked
      labels:
        type: array
        items:
          $ref: '#/definitions/Label'
        x-go-name: Labels
      milestone:
        $ref: '#/definitions/Milestone'
      number:
        type: integer
        format: int64
        x-go-name: Index
      original_author:
        type: string
        x-go-name: OriginalAuthor
      original_author_id:
        type: integer
        format: int64
        x-go-name: OriginalAuthorID
      pull_request:
        $ref: '#/definitions/PullRequestMeta'
      ref:
        type: string
        x-go-name: Ref
      repository:
        $ref: '#/definitions/RepositoryMeta'
      state:
        $ref: '#/definitions/StateType'
      title:
        type: string
        x-go-name: Title
      updated_at:
        type: string
        format: date-time
        x-go-name: Updated
      url:
        type: string
        x-go-name: URL
      user:
        $ref: '#/definitions/User'
    x-go-package: code.gitea.io/gitea/modules/structs
  IssueDeadline:
    description: IssueDeadline represents an issue deadline
    type: object
    properties:
      due_date:
        type: string
        format: date-time
        x-go-name: Deadline
    x-go-package: code.gitea.io/gitea/modules/structs
  IssueFormField:
    description: IssueFormField represents a form field
    type: object
    properties:
      attributes:
        type: object
        additionalProperties: {}
        x-go-name: Attributes
      id:
        type: string
        x-go-name: ID
      type:
        $ref: '#/definitions/IssueFormFieldType'
      validations:
        type: object
        additionalProperties: {}
        x-go-name: Validations
    x-go-package: code.gitea.io/gitea/modules/structs
  IssueFormFieldType:
    type: string
    title: >-
      IssueFormFieldType defines issue form field type, can be "markdown",
      "textarea", "input", "dropdown" or "checkboxes"
    x-go-package: code.gitea.io/gitea/modules/structs
  IssueLabelsOption:
    description: IssueLabelsOption a collection of labels
    type: object
    properties:
      labels:
        description: list of label IDs
        type: array
        items:
          type: integer
          format: int64
        x-go-name: Labels
    x-go-package: code.gitea.io/gitea/modules/structs
  IssueTemplate:
    description: IssueTemplate represents an issue template for a repository
    type: object
    properties:
      about:
        type: string
        x-go-name: About
      body:
        type: array
        items:
          $ref: '#/definitions/IssueFormField'
        x-go-name: Fields
      content:
        type: string
        x-go-name: Content
      file_name:
        type: string
        x-go-name: FileName
      labels:
        $ref: '#/definitions/IssueTemplateLabels'
      name:
        type: string
        x-go-name: Name
      ref:
        type: string
        x-go-name: Ref
      title:
        type: string
        x-go-name: Title
    x-go-package: code.gitea.io/gitea/modules/structs
  IssueTemplateLabels:
    type: array
    items:
      type: string
    x-go-package: code.gitea.io/gitea/modules/structs
  Label:
    description: Label a label to an issue or a pr
    type: object
    properties:
      color:
        type: string
        x-go-name: Color
        example: 00aabb
      description:
        type: string
        x-go-name: Description
      exclusive:
        type: boolean
        x-go-name: Exclusive
        example: false
      id:
        type: integer
        format: int64
        x-go-name: ID
      name:
        type: string
        x-go-name: Name
      url:
        type: string
        x-go-name: URL
    x-go-package: code.gitea.io/gitea/modules/structs
  MarkdownOption:
    description: MarkdownOption markdown options
    type: object
    properties:
      Context:
        description: |-
          Context to render

          in: body
        type: string
      Mode:
        description: |-
          Mode to render

          in: body
        type: string
      Text:
        description: |-
          Text markdown to render

          in: body
        type: string
      Wiki:
        description: |-
          Is it a wiki page ?

          in: body
        type: boolean
    x-go-package: code.gitea.io/gitea/modules/structs
  MergePullRequestOption:
    description: MergePullRequestForm form for merging Pull Request
    type: object
    required:
      - Do
    properties:
      Do:
        type: string
        enum:
          - merge
          - rebase
          - rebase-merge
          - squash
          - manually-merged
      MergeCommitID:
        type: string
      MergeMessageField:
        type: string
      MergeTitleField:
        type: string
      delete_branch_after_merge:
        type: boolean
        x-go-name: DeleteBranchAfterMerge
      force_merge:
        type: boolean
        x-go-name: ForceMerge
      head_commit_id:
        type: string
        x-go-name: HeadCommitID
      merge_when_checks_succeed:
        type: boolean
        x-go-name: MergeWhenChecksSucceed
    x-go-name: MergePullRequestForm
    x-go-package: code.gitea.io/gitea/services/forms
  MigrateRepoOptions:
    description: |-
      MigrateRepoOptions options for migrating repository's
      this is used to interact with api v1
    type: object
    required:
      - clone_addr
      - repo_name
    properties:
      auth_password:
        type: string
        x-go-name: AuthPassword
      auth_token:
        type: string
        x-go-name: AuthToken
      auth_username:
        type: string
        x-go-name: AuthUsername
      clone_addr:
        type: string
        x-go-name: CloneAddr
      description:
        type: string
        x-go-name: Description
      issues:
        type: boolean
        x-go-name: Issues
      labels:
        type: boolean
        x-go-name: Labels
      lfs:
        type: boolean
        x-go-name: LFS
      lfs_endpoint:
        type: string
        x-go-name: LFSEndpoint
      milestones:
        type: boolean
        x-go-name: Milestones
      mirror:
        type: boolean
        x-go-name: Mirror
      mirror_interval:
        type: string
        x-go-name: MirrorInterval
      private:
        type: boolean
        x-go-name: Private
      pull_requests:
        type: boolean
        x-go-name: PullRequests
      releases:
        type: boolean
        x-go-name: Releases
      repo_name:
        type: string
        x-go-name: RepoName
      repo_owner:
        description: Name of User or Organisation who will own Repo after migration
        type: string
        x-go-name: RepoOwner
      service:
        type: string
        enum:
          - git
          - github
          - gitea
          - gitlab
        x-go-name: Service
      uid:
        description: deprecated (only for backwards compatibility)
        type: integer
        format: int64
        x-go-name: RepoOwnerID
      wiki:
        type: boolean
        x-go-name: Wiki
    x-go-package: code.gitea.io/gitea/modules/structs
  Milestone:
    description: Milestone milestone is a collection of issues on one repository
    type: object
    properties:
      closed_at:
        type: string
        format: date-time
        x-go-name: Closed
      closed_issues:
        type: integer
        format: int64
        x-go-name: ClosedIssues
      created_at:
        type: string
        format: date-time
        x-go-name: Created
      description:
        type: string
        x-go-name: Description
      due_on:
        type: string
        format: date-time
        x-go-name: Deadline
      id:
        type: integer
        format: int64
        x-go-name: ID
      open_issues:
        type: integer
        format: int64
        x-go-name: OpenIssues
      state:
        $ref: '#/definitions/StateType'
      title:
        type: string
        x-go-name: Title
      updated_at:
        type: string
        format: date-time
        x-go-name: Updated
    x-go-package: code.gitea.io/gitea/modules/structs
  NodeInfo:
    description: >-
      NodeInfo contains standardized way of exposing metadata about a server
      running one of the distributed social networks
    type: object
    properties:
      metadata:
        type: object
        x-go-name: Metadata
      openRegistrations:
        type: boolean
        x-go-name: OpenRegistrations
      protocols:
        type: array
        items:
          type: string
        x-go-name: Protocols
      services:
        $ref: '#/definitions/NodeInfoServices'
      software:
        $ref: '#/definitions/NodeInfoSoftware'
      usage:
        $ref: '#/definitions/NodeInfoUsage'
      version:
        type: string
        x-go-name: Version
    x-go-package: code.gitea.io/gitea/modules/structs
  NodeInfoServices:
    description: >-
      NodeInfoServices contains the third party sites this server can connect to
      via their application API
    type: object
    properties:
      inbound:
        type: array
        items:
          type: string
        x-go-name: Inbound
      outbound:
        type: array
        items:
          type: string
        x-go-name: Outbound
    x-go-package: code.gitea.io/gitea/modules/structs
  NodeInfoSoftware:
    description: NodeInfoSoftware contains Metadata about server software in use
    type: object
    properties:
      homepage:
        type: string
        x-go-name: Homepage
      name:
        type: string
        x-go-name: Name
      repository:
        type: string
        x-go-name: Repository
      version:
        type: string
        x-go-name: Version
    x-go-package: code.gitea.io/gitea/modules/structs
  NodeInfoUsage:
    description: NodeInfoUsage contains usage statistics for this server
    type: object
    properties:
      localComments:
        type: integer
        format: int64
        x-go-name: LocalComments
      localPosts:
        type: integer
        format: int64
        x-go-name: LocalPosts
      users:
        $ref: '#/definitions/NodeInfoUsageUsers'
    x-go-package: code.gitea.io/gitea/modules/structs
  NodeInfoUsageUsers:
    description: NodeInfoUsageUsers contains statistics about the users of this server
    type: object
    properties:
      activeHalfyear:
        type: integer
        format: int64
        x-go-name: ActiveHalfyear
      activeMonth:
        type: integer
        format: int64
        x-go-name: ActiveMonth
      total:
        type: integer
        format: int64
        x-go-name: Total
    x-go-package: code.gitea.io/gitea/modules/structs
  Note:
    description: Note contains information related to a git note
    type: object
    properties:
      commit:
        $ref: '#/definitions/Commit'
      message:
        type: string
        x-go-name: Message
    x-go-package: code.gitea.io/gitea/modules/structs
  NotificationCount:
    description: NotificationCount number of unread notifications
    type: object
    properties:
      new:
        type: integer
        format: int64
        x-go-name: New
    x-go-package: code.gitea.io/gitea/modules/structs
  NotificationSubject:
    description: NotificationSubject contains the notification subject (Issue/Pull/Commit)
    type: object
    properties:
      html_url:
        type: string
        x-go-name: HTMLURL
      latest_comment_html_url:
        type: string
        x-go-name: LatestCommentHTMLURL
      latest_comment_url:
        type: string
        x-go-name: LatestCommentURL
      state:
        $ref: '#/definitions/StateType'
      title:
        type: string
        x-go-name: Title
      type:
        $ref: '#/definitions/NotifySubjectType'
      url:
        type: string
        x-go-name: URL
    x-go-package: code.gitea.io/gitea/modules/structs
  NotificationThread:
    description: NotificationThread expose Notification on API
    type: object
    properties:
      id:
        type: integer
        format: int64
        x-go-name: ID
      pinned:
        type: boolean
        x-go-name: Pinned
      repository:
        $ref: '#/definitions/Repository'
      subject:
        $ref: '#/definitions/NotificationSubject'
      unread:
        type: boolean
        x-go-name: Unread
      updated_at:
        type: string
        format: date-time
        x-go-name: UpdatedAt
      url:
        type: string
        x-go-name: URL
    x-go-package: code.gitea.io/gitea/modules/structs
  NotifySubjectType:
    description: NotifySubjectType represent type of notification subject
    type: string
    x-go-package: code.gitea.io/gitea/modules/structs
  OAuth2Application:
    type: object
    title: OAuth2Application represents an OAuth2 application.
    properties:
      client_id:
        type: string
        x-go-name: ClientID
      client_secret:
        type: string
        x-go-name: ClientSecret
      confidential_client:
        type: boolean
        x-go-name: ConfidentialClient
      created:
        type: string
        format: date-time
        x-go-name: Created
      id:
        type: integer
        format: int64
        x-go-name: ID
      name:
        type: string
        x-go-name: Name
      redirect_uris:
        type: array
        items:
          type: string
        x-go-name: RedirectURIs
    x-go-package: code.gitea.io/gitea/modules/structs
  Organization:
    description: Organization represents an organization
    type: object
    properties:
      avatar_url:
        type: string
        x-go-name: AvatarURL
      description:
        type: string
        x-go-name: Description
      full_name:
        type: string
        x-go-name: FullName
      id:
        type: integer
        format: int64
        x-go-name: ID
      location:
        type: string
        x-go-name: Location
      name:
        type: string
        x-go-name: Name
      repo_admin_change_team_access:
        type: boolean
        x-go-name: RepoAdminChangeTeamAccess
      username:
        description: deprecated
        type: string
        x-go-name: UserName
      visibility:
        type: string
        x-go-name: Visibility
      website:
        type: string
        x-go-name: Website
    x-go-package: code.gitea.io/gitea/modules/structs
  OrganizationPermissions:
    description: >-
      OrganizationPermissions list different users permissions on an
      organization
    type: object
    properties:
      can_create_repository:
        type: boolean
        x-go-name: CanCreateRepository
      can_read:
        type: boolean
        x-go-name: CanRead
      can_write:
        type: boolean
        x-go-name: CanWrite
      is_admin:
        type: boolean
        x-go-name: IsAdmin
      is_owner:
        type: boolean
        x-go-name: IsOwner
    x-go-package: code.gitea.io/gitea/modules/structs
  PRBranchInfo:
    description: PRBranchInfo information about a branch
    type: object
    properties:
      label:
        type: string
        x-go-name: Name
      ref:
        type: string
        x-go-name: Ref
      repo:
        $ref: '#/definitions/Repository'
      repo_id:
        type: integer
        format: int64
        x-go-name: RepoID
      sha:
        type: string
        x-go-name: Sha
    x-go-package: code.gitea.io/gitea/modules/structs
  Package:
    description: Package represents a package
    type: object
    properties:
      created_at:
        type: string
        format: date-time
        x-go-name: CreatedAt
      creator:
        $ref: '#/definitions/User'
      id:
        type: integer
        format: int64
        x-go-name: ID
      name:
        type: string
        x-go-name: Name
      owner:
        $ref: '#/definitions/User'
      repository:
        $ref: '#/definitions/Repository'
      type:
        type: string
        x-go-name: Type
      version:
        type: string
        x-go-name: Version
    x-go-package: code.gitea.io/gitea/modules/structs
  PackageFile:
    description: PackageFile represents a package file
    type: object
    properties:
      Size:
        type: integer
        format: int64
      id:
        type: integer
        format: int64
        x-go-name: ID
      md5:
        type: string
        x-go-name: HashMD5
      name:
        type: string
        x-go-name: Name
      sha1:
        type: string
        x-go-name: HashSHA1
      sha256:
        type: string
        x-go-name: HashSHA256
      sha512:
        type: string
        x-go-name: HashSHA512
    x-go-package: code.gitea.io/gitea/modules/structs
  PayloadCommit:
    description: PayloadCommit represents a commit
    type: object
    properties:
      added:
        type: array
        items:
          type: string
        x-go-name: Added
      author:
        $ref: '#/definitions/PayloadUser'
      committer:
        $ref: '#/definitions/PayloadUser'
      id:
        description: sha1 hash of the commit
        type: string
        x-go-name: ID
      message:
        type: string
        x-go-name: Message
      modified:
        type: array
        items:
          type: string
        x-go-name: Modified
      removed:
        type: array
        items:
          type: string
        x-go-name: Removed
      timestamp:
        type: string
        format: date-time
        x-go-name: Timestamp
      url:
        type: string
        x-go-name: URL
      verification:
        $ref: '#/definitions/PayloadCommitVerification'
    x-go-package: code.gitea.io/gitea/modules/structs
  PayloadCommitVerification:
    description: PayloadCommitVerification represents the GPG verification of a commit
    type: object
    properties:
      payload:
        type: string
        x-go-name: Payload
      reason:
        type: string
        x-go-name: Reason
      signature:
        type: string
        x-go-name: Signature
      signer:
        $ref: '#/definitions/PayloadUser'
      verified:
        type: boolean
        x-go-name: Verified
    x-go-package: code.gitea.io/gitea/modules/structs
  PayloadUser:
    description: PayloadUser represents the author or committer of a commit
    type: object
    properties:
      email:
        type: string
        format: email
        x-go-name: Email
      name:
        description: Full name of the commit author
        type: string
        x-go-name: Name
      username:
        type: string
        x-go-name: UserName
    x-go-package: code.gitea.io/gitea/modules/structs
  Permission:
    description: Permission represents a set of permissions
    type: object
    properties:
      admin:
        type: boolean
        x-go-name: Admin
      pull:
        type: boolean
        x-go-name: Pull
      push:
        type: boolean
        x-go-name: Push
    x-go-package: code.gitea.io/gitea/modules/structs
  PublicKey:
    description: PublicKey publickey is a user key to push code to repository
    type: object
    properties:
      created_at:
        type: string
        format: date-time
        x-go-name: Created
      fingerprint:
        type: string
        x-go-name: Fingerprint
      id:
        type: integer
        format: int64
        x-go-name: ID
      key:
        type: string
        x-go-name: Key
      key_type:
        type: string
        x-go-name: KeyType
      read_only:
        type: boolean
        x-go-name: ReadOnly
      title:
        type: string
        x-go-name: Title
      url:
        type: string
        x-go-name: URL
      user:
        $ref: '#/definitions/User'
    x-go-package: code.gitea.io/gitea/modules/structs
  PullRequest:
    description: PullRequest represents a pull request
    type: object
    properties:
      allow_maintainer_edit:
        type: boolean
        x-go-name: AllowMaintainerEdit
      assignee:
        $ref: '#/definitions/User'
      assignees:
        type: array
        items:
          $ref: '#/definitions/User'
        x-go-name: Assignees
      base:
        $ref: '#/definitions/PRBranchInfo'
      body:
        type: string
        x-go-name: Body
      closed_at:
        type: string
        format: date-time
        x-go-name: Closed
      comments:
        type: integer
        format: int64
        x-go-name: Comments
      created_at:
        type: string
        format: date-time
        x-go-name: Created
      diff_url:
        type: string
        x-go-name: DiffURL
      due_date:
        type: string
        format: date-time
        x-go-name: Deadline
      head:
        $ref: '#/definitions/PRBranchInfo'
      html_url:
        type: string
        x-go-name: HTMLURL
      id:
        type: integer
        format: int64
        x-go-name: ID
      is_locked:
        type: boolean
        x-go-name: IsLocked
      labels:
        type: array
        items:
          $ref: '#/definitions/Label'
        x-go-name: Labels
      merge_base:
        type: string
        x-go-name: MergeBase
      merge_commit_sha:
        type: string
        x-go-name: MergedCommitID
      mergeable:
        type: boolean
        x-go-name: Mergeable
      merged:
        type: boolean
        x-go-name: HasMerged
      merged_at:
        type: string
        format: date-time
        x-go-name: Merged
      merged_by:
        $ref: '#/definitions/User'
      milestone:
        $ref: '#/definitions/Milestone'
      number:
        type: integer
        format: int64
        x-go-name: Index
      patch_url:
        type: string
        x-go-name: PatchURL
      state:
        $ref: '#/definitions/StateType'
      title:
        type: string
        x-go-name: Title
      updated_at:
        type: string
        format: date-time
        x-go-name: Updated
      url:
        type: string
        x-go-name: URL
      user:
        $ref: '#/definitions/User'
    x-go-package: code.gitea.io/gitea/modules/structs
  PullRequestMeta:
    description: PullRequestMeta PR info if an issue is a PR
    type: object
    properties:
      merged:
        type: boolean
        x-go-name: HasMerged
      merged_at:
        type: string
        format: date-time
        x-go-name: Merged
    x-go-package: code.gitea.io/gitea/modules/structs
  PullReview:
    description: PullReview represents a pull request review
    type: object
    properties:
      body:
        type: string
        x-go-name: Body
      comments_count:
        type: integer
        format: int64
        x-go-name: CodeCommentsCount
      commit_id:
        type: string
        x-go-name: CommitID
      dismissed:
        type: boolean
        x-go-name: Dismissed
      html_url:
        type: string
        x-go-name: HTMLURL
      id:
        type: integer
        format: int64
        x-go-name: ID
      official:
        type: boolean
        x-go-name: Official
      pull_request_url:
        type: string
        x-go-name: HTMLPullURL
      stale:
        type: boolean
        x-go-name: Stale
      state:
        $ref: '#/definitions/ReviewStateType'
      submitted_at:
        type: string
        format: date-time
        x-go-name: Submitted
      team:
        $ref: '#/definitions/Team'
      updated_at:
        type: string
        format: date-time
        x-go-name: Updated
      user:
        $ref: '#/definitions/User'
    x-go-package: code.gitea.io/gitea/modules/structs
  PullReviewComment:
    description: PullReviewComment represents a comment on a pull request review
    type: object
    properties:
      body:
        type: string
        x-go-name: Body
      commit_id:
        type: string
        x-go-name: CommitID
      created_at:
        type: string
        format: date-time
        x-go-name: Created
      diff_hunk:
        type: string
        x-go-name: DiffHunk
      html_url:
        type: string
        x-go-name: HTMLURL
      id:
        type: integer
        format: int64
        x-go-name: ID
      original_commit_id:
        type: string
        x-go-name: OrigCommitID
      original_position:
        type: integer
        format: uint64
        x-go-name: OldLineNum
      path:
        type: string
        x-go-name: Path
      position:
        type: integer
        format: uint64
        x-go-name: LineNum
      pull_request_review_id:
        type: integer
        format: int64
        x-go-name: ReviewID
      pull_request_url:
        type: string
        x-go-name: HTMLPullURL
      resolver:
        $ref: '#/definitions/User'
      updated_at:
        type: string
        format: date-time
        x-go-name: Updated
      user:
        $ref: '#/definitions/User'
    x-go-package: code.gitea.io/gitea/modules/structs
  PullReviewRequestOptions:
    description: PullReviewRequestOptions are options to add or remove pull review requests
    type: object
    properties:
      reviewers:
        type: array
        items:
          type: string
        x-go-name: Reviewers
      team_reviewers:
        type: array
        items:
          type: string
        x-go-name: TeamReviewers
    x-go-package: code.gitea.io/gitea/modules/structs
  PushMirror:
    description: PushMirror represents information of a push mirror
    type: object
    properties:
      created:
        type: string
        x-go-name: CreatedUnix
      interval:
        type: string
        x-go-name: Interval
      last_error:
        type: string
        x-go-name: LastError
      last_update:
        type: string
        x-go-name: LastUpdateUnix
      remote_address:
        type: string
        x-go-name: RemoteAddress
      remote_name:
        type: string
        x-go-name: RemoteName
      repo_name:
        type: string
        x-go-name: RepoName
      sync_on_commit:
        type: boolean
        x-go-name: SyncOnCommit
    x-go-package: code.gitea.io/gitea/modules/structs
  Reaction:
    description: Reaction contain one reaction
    type: object
    properties:
      content:
        type: string
        x-go-name: Reaction
      created_at:
        type: string
        format: date-time
        x-go-name: Created
      user:
        $ref: '#/definitions/User'
    x-go-package: code.gitea.io/gitea/modules/structs
  Reference:
    type: object
    title: Reference represents a Git reference.
    properties:
      object:
        $ref: '#/definitions/GitObject'
      ref:
        type: string
        x-go-name: Ref
      url:
        type: string
        x-go-name: URL
    x-go-package: code.gitea.io/gitea/modules/structs
  Release:
    description: Release represents a repository release
    type: object
    properties:
      assets:
        type: array
        items:
          $ref: '#/definitions/Attachment'
        x-go-name: Attachments
      author:
        $ref: '#/definitions/User'
      body:
        type: string
        x-go-name: Note
      created_at:
        type: string
        format: date-time
        x-go-name: CreatedAt
      draft:
        type: boolean
        x-go-name: IsDraft
      html_url:
        type: string
        x-go-name: HTMLURL
      id:
        type: integer
        format: int64
        x-go-name: ID
      name:
        type: string
        x-go-name: Title
      prerelease:
        type: boolean
        x-go-name: IsPrerelease
      published_at:
        type: string
        format: date-time
        x-go-name: PublishedAt
      tag_name:
        type: string
        x-go-name: TagName
      tarball_url:
        type: string
        x-go-name: TarURL
      target_commitish:
        type: string
        x-go-name: Target
      url:
        type: string
        x-go-name: URL
      zipball_url:
        type: string
        x-go-name: ZipURL
    x-go-package: code.gitea.io/gitea/modules/structs
  RepoCollaboratorPermission:
    description: RepoCollaboratorPermission to get repository permission for a collaborator
    type: object
    properties:
      permission:
        type: string
        x-go-name: Permission
      role_name:
        type: string
        x-go-name: RoleName
      user:
        $ref: '#/definitions/User'
    x-go-package: code.gitea.io/gitea/modules/structs
  RepoCommit:
    type: object
    title: >-
      RepoCommit contains information of a commit in the context of a
      repository.
    properties:
      author:
        $ref: '#/definitions/CommitUser'
      committer:
        $ref: '#/definitions/CommitUser'
      message:
        type: string
        x-go-name: Message
      tree:
        $ref: '#/definitions/CommitMeta'
      url:
        type: string
        x-go-name: URL
      verification:
        $ref: '#/definitions/PayloadCommitVerification'
    x-go-package: code.gitea.io/gitea/modules/structs
  RepoTopicOptions:
    description: RepoTopicOptions a collection of repo topic names
    type: object
    properties:
      topics:
        description: list of topic names
        type: array
        items:
          type: string
        x-go-name: Topics
    x-go-package: code.gitea.io/gitea/modules/structs
  RepoTransfer:
    description: RepoTransfer represents a pending repo transfer
    type: object
    properties:
      doer:
        $ref: '#/definitions/User'
      recipient:
        $ref: '#/definitions/User'
      teams:
        type: array
        items:
          $ref: '#/definitions/Team'
        x-go-name: Teams
    x-go-package: code.gitea.io/gitea/modules/structs
  Repository:
    description: Repository represents a repository
    type: object
    properties:
      allow_merge_commits:
        type: boolean
        x-go-name: AllowMerge
      allow_rebase:
        type: boolean
        x-go-name: AllowRebase
      allow_rebase_explicit:
        type: boolean
        x-go-name: AllowRebaseMerge
      allow_rebase_update:
        type: boolean
        x-go-name: AllowRebaseUpdate
      allow_squash_merge:
        type: boolean
        x-go-name: AllowSquash
      archived:
        type: boolean
        x-go-name: Archived
      avatar_url:
        type: string
        x-go-name: AvatarURL
      clone_url:
        type: string
        x-go-name: CloneURL
      created_at:
        type: string
        format: date-time
        x-go-name: Created
      default_allow_maintainer_edit:
        type: boolean
        x-go-name: DefaultAllowMaintainerEdit
      default_branch:
        type: string
        x-go-name: DefaultBranch
      default_delete_branch_after_merge:
        type: boolean
        x-go-name: DefaultDeleteBranchAfterMerge
      default_merge_style:
        type: string
        x-go-name: DefaultMergeStyle
      description:
        type: string
        x-go-name: Description
      empty:
        type: boolean
        x-go-name: Empty
      external_tracker:
        $ref: '#/definitions/ExternalTracker'
      external_wiki:
        $ref: '#/definitions/ExternalWiki'
      fork:
        type: boolean
        x-go-name: Fork
      forks_count:
        type: integer
        format: int64
        x-go-name: Forks
      full_name:
        type: string
        x-go-name: FullName
      has_issues:
        type: boolean
        x-go-name: HasIssues
      has_projects:
        type: boolean
        x-go-name: HasProjects
      has_pull_requests:
        type: boolean
        x-go-name: HasPullRequests
      has_wiki:
        type: boolean
        x-go-name: HasWiki
      html_url:
        type: string
        x-go-name: HTMLURL
      id:
        type: integer
        format: int64
        x-go-name: ID
      ignore_whitespace_conflicts:
        type: boolean
        x-go-name: IgnoreWhitespaceConflicts
      internal:
        type: boolean
        x-go-name: Internal
      internal_tracker:
        $ref: '#/definitions/InternalTracker'
      language:
        type: string
        x-go-name: Language
      languages_url:
        type: string
        x-go-name: LanguagesURL
      link:
        type: string
        x-go-name: Link
      mirror:
        type: boolean
        x-go-name: Mirror
      mirror_interval:
        type: string
        x-go-name: MirrorInterval
      mirror_updated:
        type: string
        format: date-time
        x-go-name: MirrorUpdated
      name:
        type: string
        x-go-name: Name
      open_issues_count:
        type: integer
        format: int64
        x-go-name: OpenIssues
      open_pr_counter:
        type: integer
        format: int64
        x-go-name: OpenPulls
      original_url:
        type: string
        x-go-name: OriginalURL
      owner:
        $ref: '#/definitions/User'
      parent:
        $ref: '#/definitions/Repository'
      permissions:
        $ref: '#/definitions/Permission'
      private:
        type: boolean
        x-go-name: Private
      release_counter:
        type: integer
        format: int64
        x-go-name: Releases
      repo_transfer:
        $ref: '#/definitions/RepoTransfer'
      size:
        type: integer
        format: int64
        x-go-name: Size
      ssh_url:
        type: string
        x-go-name: SSHURL
      stars_count:
        type: integer
        format: int64
        x-go-name: Stars
      template:
        type: boolean
        x-go-name: Template
      updated_at:
        type: string
        format: date-time
        x-go-name: Updated
      watchers_count:
        type: integer
        format: int64
        x-go-name: Watchers
      website:
        type: string
        x-go-name: Website
    x-go-package: code.gitea.io/gitea/modules/structs
  RepositoryMeta:
    description: RepositoryMeta basic repository information
    type: object
    properties:
      full_name:
        type: string
        x-go-name: FullName
      id:
        type: integer
        format: int64
        x-go-name: ID
      name:
        type: string
        x-go-name: Name
      owner:
        type: string
        x-go-name: Owner
    x-go-package: code.gitea.io/gitea/modules/structs
  ReviewStateType:
    description: ReviewStateType review state type
    type: string
    x-go-package: code.gitea.io/gitea/modules/structs
  SearchResults:
    description: SearchResults results of a successful search
    type: object
    properties:
      data:
        type: array
        items:
          $ref: '#/definitions/Repository'
        x-go-name: Data
      ok:
        type: boolean
        x-go-name: OK
    x-go-package: code.gitea.io/gitea/modules/structs
  ServerVersion:
    description: ServerVersion wraps the version of the server
    type: object
    properties:
      version:
        type: string
        x-go-name: Version
    x-go-package: code.gitea.io/gitea/modules/structs
  StateType:
    description: StateType issue state type
    type: string
    x-go-package: code.gitea.io/gitea/modules/structs
  StopWatch:
    description: StopWatch represent a running stopwatch
    type: object
    properties:
      created:
        type: string
        format: date-time
        x-go-name: Created
      duration:
        type: string
        x-go-name: Duration
      issue_index:
        type: integer
        format: int64
        x-go-name: IssueIndex
      issue_title:
        type: string
        x-go-name: IssueTitle
      repo_name:
        type: string
        x-go-name: RepoName
      repo_owner_name:
        type: string
        x-go-name: RepoOwnerName
      seconds:
        type: integer
        format: int64
        x-go-name: Seconds
    x-go-package: code.gitea.io/gitea/modules/structs
  SubmitPullReviewOptions:
    description: SubmitPullReviewOptions are options to submit a pending pull review
    type: object
    properties:
      body:
        type: string
        x-go-name: Body
      event:
        $ref: '#/definitions/ReviewStateType'
    x-go-package: code.gitea.io/gitea/modules/structs
  Tag:
    description: Tag represents a repository tag
    type: object
    properties:
      commit:
        $ref: '#/definitions/CommitMeta'
      id:
        type: string
        x-go-name: ID
      message:
        type: string
        x-go-name: Message
      name:
        type: string
        x-go-name: Name
      tarball_url:
        type: string
        x-go-name: TarballURL
      zipball_url:
        type: string
        x-go-name: ZipballURL
    x-go-package: code.gitea.io/gitea/modules/structs
  Team:
    description: Team represents a team in an organization
    type: object
    properties:
      can_create_org_repo:
        type: boolean
        x-go-name: CanCreateOrgRepo
      description:
        type: string
        x-go-name: Description
      id:
        type: integer
        format: int64
        x-go-name: ID
      includes_all_repositories:
        type: boolean
        x-go-name: IncludesAllRepositories
      name:
        type: string
        x-go-name: Name
      organization:
        $ref: '#/definitions/Organization'
      permission:
        type: string
        enum:
          - none
          - read
          - write
          - admin
          - owner
        x-go-name: Permission
      units:
        type: array
        items:
          type: string
        x-go-name: Units
        example:
          - repo.code
          - repo.issues
          - repo.ext_issues
          - repo.wiki
          - repo.pulls
          - repo.releases
          - repo.projects
          - repo.ext_wiki
      units_map:
        type: object
        additionalProperties:
          type: string
        x-go-name: UnitsMap
        example:
          repo.code: read
          repo.ext_issues: none
          repo.ext_wiki: none
          repo.issues: write
          repo.projects: none
          repo.pulls: owner
          repo.releases: none
          repo.wiki: admin
    x-go-package: code.gitea.io/gitea/modules/structs
  TimeStamp:
    description: TimeStamp defines a timestamp
    type: integer
    format: int64
    x-go-package: code.gitea.io/gitea/modules/timeutil
  TimelineComment:
    description: >-
      TimelineComment represents a timeline comment (comment of any type) on a
      commit or issue
    type: object
    properties:
      assignee:
        $ref: '#/definitions/User'
      assignee_team:
        $ref: '#/definitions/Team'
      body:
        type: string
        x-go-name: Body
      created_at:
        type: string
        format: date-time
        x-go-name: Created
      dependent_issue:
        $ref: '#/definitions/Issue'
      html_url:
        type: string
        x-go-name: HTMLURL
      id:
        type: integer
        format: int64
        x-go-name: ID
      issue_url:
        type: string
        x-go-name: IssueURL
      label:
        $ref: '#/definitions/Label'
      milestone:
        $ref: '#/definitions/Milestone'
      new_ref:
        type: string
        x-go-name: NewRef
      new_title:
        type: string
        x-go-name: NewTitle
      old_milestone:
        $ref: '#/definitions/Milestone'
      old_project_id:
        type: integer
        format: int64
        x-go-name: OldProjectID
      old_ref:
        type: string
        x-go-name: OldRef
      old_title:
        type: string
        x-go-name: OldTitle
      project_id:
        type: integer
        format: int64
        x-go-name: ProjectID
      pull_request_url:
        type: string
        x-go-name: PRURL
      ref_action:
        type: string
        x-go-name: RefAction
      ref_comment:
        $ref: '#/definitions/Comment'
      ref_commit_sha:
        description: commit SHA where issue/PR was referenced
        type: string
        x-go-name: RefCommitSHA
      ref_issue:
        $ref: '#/definitions/Issue'
      removed_assignee:
        description: whether the assignees were removed or added
        type: boolean
        x-go-name: RemovedAssignee
      resolve_doer:
        $ref: '#/definitions/User'
      review_id:
        type: integer
        format: int64
        x-go-name: ReviewID
      tracked_time:
        $ref: '#/definitions/TrackedTime'
      type:
        type: string
        x-go-name: Type
      updated_at:
        type: string
        format: date-time
        x-go-name: Updated
      user:
        $ref: '#/definitions/User'
    x-go-package: code.gitea.io/gitea/modules/structs
  TopicName:
    description: TopicName a list of repo topic names
    type: object
    properties:
      topics:
        type: array
        items:
          type: string
        x-go-name: TopicNames
    x-go-package: code.gitea.io/gitea/modules/structs
  TopicResponse:
    description: TopicResponse for returning topics
    type: object
    properties:
      created:
        type: string
        format: date-time
        x-go-name: Created
      id:
        type: integer
        format: int64
        x-go-name: ID
      repo_count:
        type: integer
        format: int64
        x-go-name: RepoCount
      topic_name:
        type: string
        x-go-name: Name
      updated:
        type: string
        format: date-time
        x-go-name: Updated
    x-go-package: code.gitea.io/gitea/modules/structs
  TrackedTime:
    description: TrackedTime worked time for an issue / pr
    type: object
    properties:
      created:
        type: string
        format: date-time
        x-go-name: Created
      id:
        type: integer
        format: int64
        x-go-name: ID
      issue:
        $ref: '#/definitions/Issue'
      issue_id:
        description: deprecated (only for backwards compatibility)
        type: integer
        format: int64
        x-go-name: IssueID
      time:
        description: Time in seconds
        type: integer
        format: int64
        x-go-name: Time
      user_id:
        description: deprecated (only for backwards compatibility)
        type: integer
        format: int64
        x-go-name: UserID
      user_name:
        type: string
        x-go-name: UserName
    x-go-package: code.gitea.io/gitea/modules/structs
  TransferRepoOption:
    description: TransferRepoOption options when transfer a repository's ownership
    type: object
    required:
      - new_owner
    properties:
      new_owner:
        type: string
        x-go-name: NewOwner
      team_ids:
        description: >-
          ID of the team or teams to add to the repository. Teams can only be
          added to organization-owned repositories.
        type: array
        items:
          type: integer
          format: int64
        x-go-name: TeamIDs
    x-go-package: code.gitea.io/gitea/modules/structs
  UpdateFileOptions:
    description: >-
      UpdateFileOptions options for updating files

      Note: `author` and `committer` are optional (if only one is given, it will
      be used for the other, otherwise the authenticated user will be used)
    type: object
    required:
      - sha
      - content
    properties:
      author:
        $ref: '#/definitions/Identity'
      branch:
        description: >-
          branch (optional) to base this file from. if not given, the default
          branch is used
        type: string
        x-go-name: BranchName
      committer:
        $ref: '#/definitions/Identity'
      content:
        description: content must be base64 encoded
        type: string
        x-go-name: Content
      dates:
        $ref: '#/definitions/CommitDateOptions'
      from_path:
        description: >-
          from_path (optional) is the path of the original file which will be
          moved/renamed to the path in the URL
        type: string
        x-go-name: FromPath
      message:
        description: >-
          message (optional) for the commit of this file. if not supplied, a
          default message will be used
        type: string
        x-go-name: Message
      new_branch:
        description: >-
          new_branch (optional) will make a new branch from `branch` before
          creating the file
        type: string
        x-go-name: NewBranchName
      sha:
        description: sha is the SHA for the file that already exists
        type: string
        x-go-name: SHA
      signoff:
        description: >-
          Add a Signed-off-by trailer by the committer at the end of the commit
          log message.
        type: boolean
        x-go-name: Signoff
    x-go-package: code.gitea.io/gitea/modules/structs
  User:
    description: User represents a user
    type: object
    properties:
      active:
        description: Is user active
        type: boolean
        x-go-name: IsActive
      avatar_url:
        description: URL to the user's avatar
        type: string
        x-go-name: AvatarURL
      created:
        type: string
        format: date-time
        x-go-name: Created
      description:
        description: the user's description
        type: string
        x-go-name: Description
      email:
        type: string
        format: email
        x-go-name: Email
      followers_count:
        description: user counts
        type: integer
        format: int64
        x-go-name: Followers
      following_count:
        type: integer
        format: int64
        x-go-name: Following
      full_name:
        description: the user's full name
        type: string
        x-go-name: FullName
      id:
        description: the user's id
        type: integer
        format: int64
        x-go-name: ID
      is_admin:
        description: Is the user an administrator
        type: boolean
        x-go-name: IsAdmin
      language:
        description: User locale
        type: string
        x-go-name: Language
      last_login:
        type: string
        format: date-time
        x-go-name: LastLogin
      location:
        description: the user's location
        type: string
        x-go-name: Location
      login:
        description: the user's username
        type: string
        x-go-name: UserName
      login_name:
        description: the user's authentication sign-in name.
        type: string
        default: empty
        x-go-name: LoginName
      prohibit_login:
        description: Is user login prohibited
        type: boolean
        x-go-name: ProhibitLogin
      restricted:
        description: Is user restricted
        type: boolean
        x-go-name: Restricted
      starred_repos_count:
        type: integer
        format: int64
        x-go-name: StarredRepos
      visibility:
        description: 'User visibility level option: public, limited, private'
        type: string
        x-go-name: Visibility
      website:
        description: the user's website
        type: string
        x-go-name: Website
    x-go-package: code.gitea.io/gitea/modules/structs
  UserHeatmapData:
    description: UserHeatmapData represents the data needed to create a heatmap
    type: object
    properties:
      contributions:
        type: integer
        format: int64
        x-go-name: Contributions
      timestamp:
        $ref: '#/definitions/TimeStamp'
    x-go-package: code.gitea.io/gitea/models/activities
  UserSettings:
    description: UserSettings represents user settings
    type: object
    properties:
      description:
        type: string
        x-go-name: Description
      diff_view_style:
        type: string
        x-go-name: DiffViewStyle
      full_name:
        type: string
        x-go-name: FullName
      hide_activity:
        type: boolean
        x-go-name: HideActivity
      hide_email:
        description: Privacy
        type: boolean
        x-go-name: HideEmail
      language:
        type: string
        x-go-name: Language
      location:
        type: string
        x-go-name: Location
      theme:
        type: string
        x-go-name: Theme
      website:
        type: string
        x-go-name: Website
    x-go-package: code.gitea.io/gitea/modules/structs
  UserSettingsOptions:
    description: UserSettingsOptions represents options to change user settings
    type: object
    properties:
      description:
        type: string
        x-go-name: Description
      diff_view_style:
        type: string
        x-go-name: DiffViewStyle
      full_name:
        type: string
        x-go-name: FullName
      hide_activity:
        type: boolean
        x-go-name: HideActivity
      hide_email:
        description: Privacy
        type: boolean
        x-go-name: HideEmail
      language:
        type: string
        x-go-name: Language
      location:
        type: string
        x-go-name: Location
      theme:
        type: string
        x-go-name: Theme
      website:
        type: string
        x-go-name: Website
    x-go-package: code.gitea.io/gitea/modules/structs
  WatchInfo:
    description: WatchInfo represents an API watch status of one repository
    type: object
    properties:
      created_at:
        type: string
        format: date-time
        x-go-name: CreatedAt
      ignored:
        type: boolean
        x-go-name: Ignored
      reason:
        x-go-name: Reason
      repository_url:
        type: string
        x-go-name: RepositoryURL
      subscribed:
        type: boolean
        x-go-name: Subscribed
      url:
        type: string
        x-go-name: URL
    x-go-package: code.gitea.io/gitea/modules/structs
  WikiCommit:
    description: WikiCommit page commit/revision
    type: object
    properties:
      author:
        $ref: '#/definitions/CommitUser'
      commiter:
        $ref: '#/definitions/CommitUser'
      message:
        type: string
        x-go-name: Message
      sha:
        type: string
        x-go-name: ID
    x-go-package: code.gitea.io/gitea/modules/structs
  WikiCommitList:
    description: WikiCommitList commit/revision list
    type: object
    properties:
      commits:
        type: array
        items:
          $ref: '#/definitions/WikiCommit'
        x-go-name: WikiCommits
      count:
        type: integer
        format: int64
        x-go-name: Count
    x-go-package: code.gitea.io/gitea/modules/structs
  WikiPage:
    description: WikiPage a wiki page
    type: object
    properties:
      commit_count:
        type: integer
        format: int64
        x-go-name: CommitCount
      content_base64:
        description: Page content, base64 encoded
        type: string
        x-go-name: ContentBase64
      footer:
        type: string
        x-go-name: Footer
      html_url:
        type: string
        x-go-name: HTMLURL
      last_commit:
        $ref: '#/definitions/WikiCommit'
      sidebar:
        type: string
        x-go-name: Sidebar
      sub_url:
        type: string
        x-go-name: SubURL
      title:
        type: string
        x-go-name: Title
    x-go-package: code.gitea.io/gitea/modules/structs
  WikiPageMetaData:
    description: WikiPageMetaData wiki page meta information
    type: object
    properties:
      html_url:
        type: string
        x-go-name: HTMLURL
      last_commit:
        $ref: '#/definitions/WikiCommit'
      sub_url:
        type: string
        x-go-name: SubURL
      title:
        type: string
        x-go-name: Title
    x-go-package: code.gitea.io/gitea/modules/structs
responses:
  AccessToken:
    description: AccessToken represents an API access token.
    schema:
      $ref: '#/definitions/AccessToken'
  AccessTokenList:
    description: AccessTokenList represents a list of API access token.
    schema:
      type: array
      items:
        $ref: '#/definitions/AccessToken'
  ActivityPub:
    description: ActivityPub
    schema:
      $ref: '#/definitions/ActivityPub'
  AnnotatedTag:
    description: AnnotatedTag
    schema:
      $ref: '#/definitions/AnnotatedTag'
  Attachment:
    description: Attachment
    schema:
      $ref: '#/definitions/Attachment'
  AttachmentList:
    description: AttachmentList
    schema:
      type: array
      items:
        $ref: '#/definitions/Attachment'
  Branch:
    description: Branch
    schema:
      $ref: '#/definitions/Branch'
  BranchList:
    description: BranchList
    schema:
      type: array
      items:
        $ref: '#/definitions/Branch'
  BranchProtection:
    description: BranchProtection
    schema:
      $ref: '#/definitions/BranchProtection'
  BranchProtectionList:
    description: BranchProtectionList
    schema:
      type: array
      items:
        $ref: '#/definitions/BranchProtection'
  ChangedFileList:
    description: ChangedFileList
    schema:
      type: array
      items:
        $ref: '#/definitions/ChangedFile'
    headers:
      X-HasMore:
        type: boolean
        description: True if there is another page
      X-Page:
        type: integer
        format: int64
        description: The current page
      X-PageCount:
        type: integer
        format: int64
        description: Total number of pages
      X-PerPage:
        type: integer
        format: int64
        description: Commits per page
      X-Total:
        type: integer
        format: int64
        description: Total commit count
  CombinedStatus:
    description: CombinedStatus
    schema:
      $ref: '#/definitions/CombinedStatus'
  Comment:
    description: Comment
    schema:
      $ref: '#/definitions/Comment'
  CommentList:
    description: CommentList
    schema:
      type: array
      items:
        $ref: '#/definitions/Comment'
  Commit:
    description: Commit
    schema:
      $ref: '#/definitions/Commit'
  CommitList:
    description: CommitList
    schema:
      type: array
      items:
        $ref: '#/definitions/Commit'
    headers:
      X-HasMore:
        type: boolean
        description: True if there is another page
      X-Page:
        type: integer
        format: int64
        description: The current page
      X-PageCount:
        type: integer
        format: int64
        description: Total number of pages
      X-PerPage:
        type: integer
        format: int64
        description: Commits per page
      X-Total:
        type: integer
        format: int64
        description: Total commit count
  CommitStatus:
    description: CommitStatus
    schema:
      $ref: '#/definitions/CommitStatus'
  CommitStatusList:
    description: CommitStatusList
    schema:
      type: array
      items:
        $ref: '#/definitions/CommitStatus'
  ContentsListResponse:
    description: ContentsListResponse
    schema:
      type: array
      items:
        $ref: '#/definitions/ContentsResponse'
  ContentsResponse:
    description: ContentsResponse
    schema:
      $ref: '#/definitions/ContentsResponse'
  CronList:
    description: CronList
    schema:
      type: array
      items:
        $ref: '#/definitions/Cron'
  DeployKey:
    description: DeployKey
    schema:
      $ref: '#/definitions/DeployKey'
  DeployKeyList:
    description: DeployKeyList
    schema:
      type: array
      items:
        $ref: '#/definitions/DeployKey'
  EmailList:
    description: EmailList
    schema:
      type: array
      items:
        $ref: '#/definitions/Email'
  EmptyRepository:
    description: EmptyRepository
    schema:
      $ref: '#/definitions/APIError'
  FileDeleteResponse:
    description: FileDeleteResponse
    schema:
      $ref: '#/definitions/FileDeleteResponse'
  FileResponse:
    description: FileResponse
    schema:
      $ref: '#/definitions/FileResponse'
  GPGKey:
    description: GPGKey
    schema:
      $ref: '#/definitions/GPGKey'
  GPGKeyList:
    description: GPGKeyList
    schema:
      type: array
      items:
        $ref: '#/definitions/GPGKey'
  GeneralAPISettings:
    description: GeneralAPISettings
    schema:
      $ref: '#/definitions/GeneralAPISettings'
  GeneralAttachmentSettings:
    description: GeneralAttachmentSettings
    schema:
      $ref: '#/definitions/GeneralAttachmentSettings'
  GeneralRepoSettings:
    description: GeneralRepoSettings
    schema:
      $ref: '#/definitions/GeneralRepoSettings'
  GeneralUISettings:
    description: GeneralUISettings
    schema:
      $ref: '#/definitions/GeneralUISettings'
  GitBlobResponse:
    description: GitBlobResponse
    schema:
      $ref: '#/definitions/GitBlobResponse'
  GitHook:
    description: GitHook
    schema:
      $ref: '#/definitions/GitHook'
  GitHookList:
    description: GitHookList
    schema:
      type: array
      items:
        $ref: '#/definitions/GitHook'
  GitTreeResponse:
    description: GitTreeResponse
    schema:
      $ref: '#/definitions/GitTreeResponse'
  Hook:
    description: Hook
    schema:
      $ref: '#/definitions/Hook'
  HookList:
    description: HookList
    schema:
      type: array
      items:
        $ref: '#/definitions/Hook'
  Issue:
    description: Issue
    schema:
      $ref: '#/definitions/Issue'
  IssueDeadline:
    description: IssueDeadline
    schema:
      $ref: '#/definitions/IssueDeadline'
  IssueList:
    description: IssueList
    schema:
      type: array
      items:
        $ref: '#/definitions/Issue'
  IssueTemplates:
    description: IssueTemplates
    schema:
      type: array
      items:
        $ref: '#/definitions/IssueTemplate'
  Label:
    description: Label
    schema:
      $ref: '#/definitions/Label'
  LabelList:
    description: LabelList
    schema:
      type: array
      items:
        $ref: '#/definitions/Label'
  LanguageStatistics:
    description: LanguageStatistics
    schema:
      type: object
      additionalProperties:
        type: integer
        format: int64
  MarkdownRender:
    description: MarkdownRender is a rendered markdown document
    schema:
      type: string
  Milestone:
    description: Milestone
    schema:
      $ref: '#/definitions/Milestone'
  MilestoneList:
    description: MilestoneList
    schema:
      type: array
      items:
        $ref: '#/definitions/Milestone'
  NodeInfo:
    description: NodeInfo
    schema:
      $ref: '#/definitions/NodeInfo'
  Note:
    description: Note
    schema:
      $ref: '#/definitions/Note'
  NotificationCount:
    description: Number of unread notifications
    schema:
      $ref: '#/definitions/NotificationCount'
  NotificationThread:
    description: NotificationThread
    schema:
      $ref: '#/definitions/NotificationThread'
  NotificationThreadList:
    description: NotificationThreadList
    schema:
      type: array
      items:
        $ref: '#/definitions/NotificationThread'
  OAuth2Application:
    description: OAuth2Application
    schema:
      $ref: '#/definitions/OAuth2Application'
  OAuth2ApplicationList:
    description: OAuth2ApplicationList represents a list of OAuth2 applications.
    schema:
      type: array
      items:
        $ref: '#/definitions/OAuth2Application'
  Organization:
    description: Organization
    schema:
      $ref: '#/definitions/Organization'
  OrganizationList:
    description: OrganizationList
    schema:
      type: array
      items:
        $ref: '#/definitions/Organization'
  OrganizationPermissions:
    description: OrganizationPermissions
    schema:
      $ref: '#/definitions/OrganizationPermissions'
  Package:
    description: Package
    schema:
      $ref: '#/definitions/Package'
  PackageFileList:
    description: PackageFileList
    schema:
      type: array
      items:
        $ref: '#/definitions/PackageFile'
  PackageList:
    description: PackageList
    schema:
      type: array
      items:
        $ref: '#/definitions/Package'
  PublicKey:
    description: PublicKey
    schema:
      $ref: '#/definitions/PublicKey'
  PublicKeyList:
    description: PublicKeyList
    schema:
      type: array
      items:
        $ref: '#/definitions/PublicKey'
  PullRequest:
    description: PullRequest
    schema:
      $ref: '#/definitions/PullRequest'
  PullRequestList:
    description: PullRequestList
    schema:
      type: array
      items:
        $ref: '#/definitions/PullRequest'
  PullReview:
    description: PullReview
    schema:
      $ref: '#/definitions/PullReview'
  PullReviewComment:
    description: PullComment
    schema:
      $ref: '#/definitions/PullReviewComment'
  PullReviewCommentList:
    description: PullCommentList
    schema:
      type: array
      items:
        $ref: '#/definitions/PullReviewComment'
  PullReviewList:
    description: PullReviewList
    schema:
      type: array
      items:
        $ref: '#/definitions/PullReview'
  PushMirror:
    description: PushMirror
    schema:
      $ref: '#/definitions/PushMirror'
  PushMirrorList:
    description: PushMirrorList
    schema:
      type: array
      items:
        $ref: '#/definitions/PushMirror'
  Reaction:
    description: Reaction
    schema:
      $ref: '#/definitions/Reaction'
  ReactionList:
    description: ReactionList
    schema:
      type: array
      items:
        $ref: '#/definitions/Reaction'
  Reference:
    description: Reference
    schema:
      $ref: '#/definitions/Reference'
  ReferenceList:
    description: ReferenceList
    schema:
      type: array
      items:
        $ref: '#/definitions/Reference'
  Release:
    description: Release
    schema:
      $ref: '#/definitions/Release'
  ReleaseList:
    description: ReleaseList
    schema:
      type: array
      items:
        $ref: '#/definitions/Release'
  RepoCollaboratorPermission:
    description: RepoCollaboratorPermission
    schema:
      $ref: '#/definitions/RepoCollaboratorPermission'
  Repository:
    description: Repository
    schema:
      $ref: '#/definitions/Repository'
  RepositoryList:
    description: RepositoryList
    schema:
      type: array
      items:
        $ref: '#/definitions/Repository'
  SearchResults:
    description: SearchResults
    schema:
      $ref: '#/definitions/SearchResults'
  ServerVersion:
    description: ServerVersion
    schema:
      $ref: '#/definitions/ServerVersion'
  StopWatch:
    description: StopWatch
    schema:
      $ref: '#/definitions/StopWatch'
  StopWatchList:
    description: StopWatchList
    schema:
      type: array
      items:
        $ref: '#/definitions/StopWatch'
  StringSlice:
    description: StringSlice
    schema:
      type: array
      items:
        type: string
  Tag:
    description: Tag
    schema:
      $ref: '#/definitions/Tag'
  TagList:
    description: TagList
    schema:
      type: array
      items:
        $ref: '#/definitions/Tag'
  Team:
    description: Team
    schema:
      $ref: '#/definitions/Team'
  TeamList:
    description: TeamList
    schema:
      type: array
      items:
        $ref: '#/definitions/Team'
  TimelineList:
    description: TimelineList
    schema:
      type: array
      items:
        $ref: '#/definitions/TimelineComment'
  TopicListResponse:
    description: TopicListResponse
    schema:
      type: array
      items:
        $ref: '#/definitions/TopicResponse'
  TopicNames:
    description: TopicNames
    schema:
      $ref: '#/definitions/TopicName'
  TrackedTime:
    description: TrackedTime
    schema:
      $ref: '#/definitions/TrackedTime'
  TrackedTimeList:
    description: TrackedTimeList
    schema:
      type: array
      items:
        $ref: '#/definitions/TrackedTime'
  User:
    description: User
    schema:
      $ref: '#/definitions/User'
  UserHeatmapData:
    description: UserHeatmapData
    schema:
      type: array
      items:
        $ref: '#/definitions/UserHeatmapData'
  UserList:
    description: UserList
    schema:
      type: array
      items:
        $ref: '#/definitions/User'
  UserSettings:
    description: UserSettings
    schema:
      type: array
      items:
        $ref: '#/definitions/UserSettings'
  WatchInfo:
    description: WatchInfo
    schema:
      $ref: '#/definitions/WatchInfo'
  WikiCommitList:
    description: WikiCommitList
    schema:
      $ref: '#/definitions/WikiCommitList'
  WikiPage:
    description: WikiPage
    schema:
      $ref: '#/definitions/WikiPage'
  WikiPageList:
    description: WikiPageList
    schema:
      type: array
      items:
        $ref: '#/definitions/WikiPageMetaData'
  conflict:
    description: APIConflict is a conflict empty response
  empty:
    description: APIEmpty is an empty response
  error:
    description: APIError is error format response
    headers:
      message:
        type: string
      url:
        type: string
  forbidden:
    description: APIForbiddenError is a forbidden error response
    headers:
      message:
        type: string
      url:
        type: string
  invalidTopicsError:
    description: APIInvalidTopicsError is error format response to invalid topics
    headers:
      invalidTopics:
        type: array
        items:
          type: string
      message:
        type: string
  notFound:
    description: APINotFound is a not found empty response
  parameterBodies:
    description: parameterBodies
    schema:
      $ref: '#/definitions/CreatePushMirrorOption'
  redirect:
    description: APIRedirect is a redirect response
  string:
    description: APIString is a string response
    schema:
      type: string
  validationError:
    description: APIValidationError is error format response related to input validation
    headers:
      message:
        type: string
      url:
        type: string
securityDefinitions:
  AccessToken:
    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: 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:
    type: apiKey
    name: token
    in: query
security:
  - BasicAuth: []
  - Token: []
  - AccessToken: []
  - AuthorizationHeaderToken: []
  - SudoParam: []
  - SudoHeader: []
  - TOTPHeader: []