openapi.yml

openapi: 3.0.3
info:
  title: OSIDB API
  version: 2.3.4
  description: REST API autogenerated docs for the OSIDB and its components
paths:
  /auth/token:
    get:
      operationId: auth_token_retrieve
      description: Takes a kerberos ticket and returns an access and refresh JWT pair.
      tags:
      - auth
      security:
      - KerberosAuthentication: []
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  access:
                    type: string
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  refresh:
                    type: string
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
    post:
      operationId: auth_token_create
      description: |-
        Takes a set of user credentials and returns an access and refresh JSON web
        token pair to prove the authentication of those credentials.
      tags:
      - auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TokenObtainPair'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/TokenObtainPair'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/TokenObtainPair'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/TokenObtainPair'
                - type: object
                  properties:
                    dt:
                      type: string
                      format: date-time
                    env:
                      type: string
                    revision:
                      type: string
                    version:
                      type: string
          description: ''
  /auth/token/refresh:
    post:
      operationId: auth_token_refresh_create
      description: |-
        Takes a refresh type JSON web token and returns an access type JSON web
        token if the refresh token is valid.
      tags:
      - auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TokenRefresh'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/TokenRefresh'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/TokenRefresh'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/TokenRefresh'
                - type: object
                  properties:
                    dt:
                      type: string
                      format: date-time
                    env:
                      type: string
                    revision:
                      type: string
                    version:
                      type: string
          description: ''
  /auth/token/verify:
    post:
      operationId: auth_token_verify_create
      description: |-
        Takes a token and indicates if it is valid.  This view provides no
        information about a token's fitness for a particular use.
      tags:
      - auth
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TokenVerify'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/TokenVerify'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/TokenVerify'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/TokenVerify'
                - type: object
                  properties:
                    dt:
                      type: string
                      format: date-time
                    env:
                      type: string
                    revision:
                      type: string
                    version:
                      type: string
          description: ''
  /collectors/:
    get:
      operationId: collectors_retrieve
      description: index API endpoint listing available collector API endpoints
      tags:
      - collectors
      security:
      - OsidbTokenAuthentication: []
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  index:
                    type: array
                    items:
                      type: string
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /collectors/api/v1/status:
    get:
      operationId: collectors_api_v1_status_retrieve
      description: get the overall status of all collectors and the collected data
      tags:
      - collectors
      security:
      - OsidbTokenAuthentication: []
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  collectors:
                    type: array
                    items:
                      type: object
                      properties:
                        data:
                          type: string
                          enum:
                          - EMPTY
                          - PARTIAL
                          - COMPLETE
                        depends_on:
                          type: array
                          items:
                            type: string
                        error:
                          type: object
                          nullable: true
                        is_complete:
                          type: boolean
                        data_models:
                          type: array
                          items:
                            type: string
                        state:
                          type: string
                          enum:
                          - PENDING
                          - BLOCKED
                          - READY
                          - RUNNING
                        updated_until:
                          type: string
                          format: date-time
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /collectors/healthy:
    get:
      operationId: collectors_healthy_retrieve
      description: unauthenticated health check API endpoint
      tags:
      - collectors
      security:
      - OsidbTokenAuthentication: []
      - {}
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /exploits/api/v1/collect:
    put:
      operationId: exploits_api_v1_collect_update
      description: |-
        API endpoint for re-collecting exploit data.

        **NOTE:** Currently for CISA data only, which is very small and collection is fast.
      tags:
      - exploits
      security:
      - OsidbTokenAuthentication: []
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  result_cisa:
                    type: string
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /exploits/api/v1/cve_map:
    get:
      operationId: exploits_api_v1_cve_map_retrieve
      description: |-
        API endpoint for getting simple exploits information mapped to impacted CVEs.

        The Insights Vulnerability application needs this format.

        Format of results:
        ```
        {
          "page_size": <Number of CVEs on the page>,
          "cves": {
            "CVE-2222-0001": [<List of exploits>],
            "CVE-2222-0002": [<List of exploits>],
            ...
          },
        }
        ```
      tags:
      - exploits
      security:
      - OsidbTokenAuthentication: []
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  cves:
                    type: object
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  page_size:
                    type: integer
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /exploits/api/v1/epss:
    get:
      operationId: exploits_api_v1_epss_list
      description: API endpoint for getting list of Red Hat relevant CVEs with their
        EPSS score.
      parameters:
      - name: limit
        required: false
        in: query
        description: Number of results to return per page.
        schema:
          type: integer
      - name: offset
        required: false
        in: query
        description: The initial index from which to return the results.
        schema:
          type: integer
      tags:
      - exploits
      security:
      - OsidbTokenAuthentication: []
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/PaginatedEPSSList'
                - type: object
                  properties:
                    dt:
                      type: string
                      format: date-time
                    env:
                      type: string
                    revision:
                      type: string
                    version:
                      type: string
          description: ''
  /exploits/api/v1/report/date/{date}:
    get:
      operationId: exploits_api_v1_report_date_retrieve
      description: |-
        API endpoint for getting date based report for Incident Response.

        Format of results:
        ```
        {
          "cutoff_date": <Date>,
          "evaluated_cves": <Number of new CVEs with exploits>,
          "action_required": [<List of affects requiring action>],
          "no_action": [<List of CVEs not requiring action with reason>],
          "not_relevant": [<List of CVEs which are not in the database with reason>],
        }
        ```

        **NOTE:** No pagination is performed on this endpoint as data is limited by date and is expected
                  to be fairly small. Also, because data is broken into three categories it is not
                  exactly obvious how to create pages.
      parameters:
      - in: path
        name: date
        schema:
          type: string
          format: date
        description: 'Date format: YYYY-MM-DD'
        required: true
      tags:
      - exploits
      security:
      - OsidbTokenAuthentication: []
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  action_required:
                    type: array
                    items:
                      type: object
                  cutoff_date:
                    type: string
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  evaluated_cves:
                    type: integer
                  no_action:
                    type: array
                    items:
                      type: object
                  not_relevant:
                    type: array
                    items:
                      type: object
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /exploits/api/v1/report/explanations:
    get:
      operationId: exploits_api_v1_report_explanations_retrieve
      description: |-
        API endpoint for getting a report of all CVEs with exploit and their status
        for Incident Response.

        Format of results:
        ```
        {
           "page_size": <Number of CVEs on the page>,
           "explanations": [<List of CVEs with exploit together with current status explanation>],
        }
        ```
      tags:
      - exploits
      security:
      - OsidbTokenAuthentication: []
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  explanations:
                    type: array
                    items:
                      type: object
                  page_size:
                    type: integer
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /exploits/api/v1/report/pending:
    get:
      operationId: exploits_api_v1_report_pending_retrieve
      description: |-
        API endpoint for getting a report of pending actions for Incident Response.

        Format of results:
        ```
        {
          "pending_actions": [<List of affects requiring action>],
          "pending_actions_count": <Number of affects requiring action>,
        }
        ```

        **NOTE:** No pagination is performed on this endpoint as it is expected that the size of
                  the list of pending actions will be mostly stable. Also, the paging cannot be done on
                  the query level, as additional analysis of every exploit is required before a decision
                  to include it in this report is done.
      tags:
      - exploits
      security:
      - OsidbTokenAuthentication: []
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  pending_actions:
                    type: array
                    items:
                      type: object
                  pending_actions_count:
                    type: integer
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /exploits/api/v1/status:
    get:
      operationId: exploits_api_v1_status_retrieve
      description: |-
        API endpoint for getting basic information about exploits in the database.

        **NOTE:** Everyone is allowed to see basic information.
      tags:
      - exploits
      security:
      - OsidbTokenAuthentication: []
      - {}
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  exploits_count:
                    type: integer
                  exploits_count_relevant:
                    type: integer
                  last_exploit:
                    type: integer
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /osidb/api/v1/affects:
    get:
      operationId: osidb_api_v1_affects_list
      parameters:
      - in: query
        name: affectedness
        schema:
          type: string
          enum:
          - ''
          - AFFECTED
          - NEW
          - NOTAFFECTED
      - in: query
        name: flaw
        schema:
          type: string
          format: uuid
      - in: query
        name: impact
        schema:
          type: string
          enum:
          - ''
          - CRITICAL
          - IMPORTANT
          - LOW
          - MODERATE
      - name: limit
        required: false
        in: query
        description: Number of results to return per page.
        schema:
          type: integer
      - name: offset
        required: false
        in: query
        description: The initial index from which to return the results.
        schema:
          type: integer
      - in: query
        name: ps_component
        schema:
          type: string
      - in: query
        name: ps_module
        schema:
          type: string
      - in: query
        name: resolution
        schema:
          type: string
          enum:
          - ''
          - DEFER
          - DELEGATED
          - FIX
          - OOSS
          - WONTFIX
          - WONTREPORT
      - in: query
        name: type
        schema:
          type: string
          enum:
          - DEFAULT
      - in: query
        name: uuid
        schema:
          type: string
          format: uuid
      tags:
      - osidb
      security:
      - OsidbTokenAuthentication: []
      - {}
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/PaginatedAffectList'
                - type: object
                  properties:
                    dt:
                      type: string
                      format: date-time
                    env:
                      type: string
                    revision:
                      type: string
                    version:
                      type: string
          description: ''
    post:
      operationId: osidb_api_v1_affects_create
      tags:
      - osidb
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Affect'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Affect'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Affect'
        required: true
      security:
      - OsidbTokenAuthentication: []
      responses:
        '201':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Affect'
                - type: object
                  properties:
                    dt:
                      type: string
                      format: date-time
                    env:
                      type: string
                    revision:
                      type: string
                    version:
                      type: string
          description: ''
  /osidb/api/v1/affects/{uuid}:
    get:
      operationId: osidb_api_v1_affects_retrieve
      parameters:
      - in: path
        name: uuid
        schema:
          type: string
          format: uuid
        description: A UUID string identifying this Affect.
        required: true
      tags:
      - osidb
      security:
      - OsidbTokenAuthentication: []
      - {}
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Affect'
                - type: object
                  properties:
                    dt:
                      type: string
                      format: date-time
                    env:
                      type: string
                    revision:
                      type: string
                    version:
                      type: string
          description: ''
    put:
      operationId: osidb_api_v1_affects_update
      parameters:
      - in: path
        name: uuid
        schema:
          type: string
          format: uuid
        description: A UUID string identifying this Affect.
        required: true
      tags:
      - osidb
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Affect'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Affect'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Affect'
        required: true
      security:
      - OsidbTokenAuthentication: []
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Affect'
                - type: object
                  properties:
                    dt:
                      type: string
                      format: date-time
                    env:
                      type: string
                    revision:
                      type: string
                    version:
                      type: string
          description: ''
    delete:
      operationId: osidb_api_v1_affects_destroy
      parameters:
      - in: path
        name: uuid
        schema:
          type: string
          format: uuid
        description: A UUID string identifying this Affect.
        required: true
      tags:
      - osidb
      security:
      - OsidbTokenAuthentication: []
      responses:
        '204':
          content:
            application/json:
              schema:
                type: object
                properties:
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /osidb/api/v1/flaws:
    get:
      operationId: osidb_api_v1_flaws_list
      parameters:
      - in: query
        name: bz_id
        schema:
          type: number
      - in: query
        name: changed_after
        schema:
          type: string
          format: date-time
      - in: query
        name: changed_before
        schema:
          type: string
          format: date-time
      - in: query
        name: created_dt
        schema:
          type: string
          format: date-time
      - in: query
        name: cve_id
        schema:
          type: array
          items:
            type: string
        description: Multiple values may be separated by commas.
        explode: false
        style: form
      - in: query
        name: cvss2
        schema:
          type: string
      - in: query
        name: cvss2_score
        schema:
          type: number
          format: float
      - in: query
        name: cvss3
        schema:
          type: string
      - in: query
        name: cvss3_score
        schema:
          type: number
          format: float
      - in: query
        name: cwe_id
        schema:
          type: string
      - in: query
        name: description
        schema:
          type: string
      - in: query
        name: embargoed
        schema:
          type: boolean
      - in: query
        name: exclude_fields
        schema:
          type: array
          items:
            type: string
        description: 'Exclude specified fields from the response. Multiple values
          may be separated by commas. Dot notation can be used to filter on related
          model fields. Example: `exclude_fields=uuid,affects.uuid,affects.trackers.uuid`'
      - in: query
        name: flaw_meta_type
        schema:
          type: array
          items:
            type: string
        description: 'Include flaw metas with specified type only, multiple values
          may be separated by commas. '
      - in: query
        name: impact
        schema:
          type: string
          enum:
          - ''
          - CRITICAL
          - IMPORTANT
          - LOW
          - MODERATE
      - in: query
        name: include_fields
        schema:
          type: array
          items:
            type: string
        description: 'Include only specified fields in the response. Multiple values
          may be separated by commas. Dot notation can be used to filter on related
          model fields. Example: `include_fields=uuid,affects.uuid,affects.trackers.uuid`'
      - in: query
        name: include_meta_attr
        schema:
          type: array
          items:
            type: string
        description: 'Specify which keys from meta_attr field should be retrieved,
          multiple values may be separated by commas. Dot notation can be used to
          specify meta_attr keys on related models. Example: `include_meta_attr=bz_id,affects.ps_module,affects.trackers.bz_id`Use
          wildcards eg. `include_meta_attr=*,affects.*,affects.trackers.*` for retrieving
          all the keys from meta_attr. Omit this parameter to not include meta_attr
          fields at all. '
      - name: limit
        required: false
        in: query
        description: Number of results to return per page.
        schema:
          type: integer
      - name: offset
        required: false
        in: query
        description: The initial index from which to return the results.
        schema:
          type: integer
      - in: query
        name: reported_dt
        schema:
          type: string
          format: date-time
      - in: query
        name: resolution
        schema:
          type: string
          enum:
          - ''
          - CANTFIX
          - CURRENTRELEASE
          - DEFERRED
          - DUPLICATE
          - EOL
          - ERRATA
          - INSUFFICIENT_DATA
          - NEXTRELEASE
          - NOTABUG
          - RAWHIDE
          - UPSTREAM
          - WONTFIX
          - WORKSFORME
      - in: query
        name: search
        schema:
          type: string
      - in: query
        name: source
        schema:
          type: string
          enum:
          - ''
          - ADOBE
          - APPLE
          - ASF
          - BIND
          - BK
          - BUGTRAQ
          - BUGZILLA
          - CERT
          - CERTIFI
          - CORELABS
          - CUSTOMER
          - CVE
          - DAILYDAVE
          - DEBIAN
          - DISTROS
          - FEDORA
          - FETCHMAIL
          - FREEDESKTOP
          - FREERADIUS
          - FRSIRT
          - FULLDISCLOSURE
          - GAIM
          - GENTOO
          - GENTOOBZ
          - GIT
          - GNOME
          - GNUPG
          - GOOGLE
          - HP
          - HW_VENDOR
          - IBM
          - IDEFENSE
          - INTERNET
          - ISC
          - ISEC
          - IT
          - JBOSS
          - JPCERT
          - KERNELBUGZILLA
          - KERNELSEC
          - LKML
          - LWN
          - MACROMEDIA
          - MAGEIA
          - MAILINGLIST
          - MILW0RM
          - MIT
          - MITRE
          - MOZILLA
          - MUTTDEV
          - NETDEV
          - NISCC
          - OCERT
          - OPENOFFICE
          - OPENSSL
          - OPENSUSE
          - ORACLE
          - OSS
          - OSSSECURITY
          - PHP
          - PIDGIN
          - POSTGRESQL
          - PRESS
          - REAL
          - REDHAT
          - RESEARCHER
          - RT
          - SAMBA
          - SECALERT
          - SECUNIA
          - SECURITYFOCUS
          - SKO
          - SQUID
          - SQUIRRELMAIL
          - SUN
          - SUNSOLVE
          - SUSE
          - TWITTER
          - UBUNTU
          - UPSTREAM
          - VENDORSEC
          - VULNWATCH
          - WIRESHARK
          - XCHAT
          - XEN
          - XPDF
      - in: query
        name: state
        schema:
          type: string
          enum:
          - ASSIGNED
          - CLOSED
          - MODIFIED
          - NEW
          - ON_DEV
          - ON_QA
          - POST
          - RELEASE_PENDING
          - VERIFIED
      - in: query
        name: statement
        schema:
          type: string
      - in: query
        name: summary
        schema:
          type: string
      - in: query
        name: title
        schema:
          type: string
      - in: query
        name: tracker_ids
        schema:
          type: array
          items:
            type: string
        description: Filter only Flaws which are related to specified Trackers (through
          Affects). Multiple tracker IDs may be separated by commas. Also only Affects
          that have the specified Trackers related will be shown.
      - in: query
        name: type
        schema:
          type: string
          enum:
          - VULNERABILITY
          - WEAKNESS
      - in: query
        name: unembargo_dt
        schema:
          type: string
          format: date-time
      - in: query
        name: updated_dt
        schema:
          type: string
          format: date-time
      - in: query
        name: uuid
        schema:
          type: string
          format: uuid
      tags:
      - osidb
      security:
      - OsidbTokenAuthentication: []
      - {}
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/PaginatedFlawList'
                - type: object
                  properties:
                    dt:
                      type: string
                      format: date-time
                    env:
                      type: string
                    revision:
                      type: string
                    version:
                      type: string
          description: ''
    post:
      operationId: osidb_api_v1_flaws_create
      tags:
      - osidb
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Flaw'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Flaw'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Flaw'
        required: true
      security:
      - OsidbTokenAuthentication: []
      responses:
        '201':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Flaw'
                - type: object
                  properties:
                    dt:
                      type: string
                      format: date-time
                    env:
                      type: string
                    revision:
                      type: string
                    version:
                      type: string
          description: ''
  /osidb/api/v1/flaws/{id}:
    get:
      operationId: osidb_api_v1_flaws_retrieve
      parameters:
      - in: query
        name: exclude_fields
        schema:
          type: array
          items:
            type: string
        description: 'Exclude specified fields from the response. Multiple values
          may be separated by commas. Dot notation can be used to filter on related
          model fields. Example: `exclude_fields=uuid,affects.uuid,affects.trackers.uuid`'
      - in: query
        name: flaw_meta_type
        schema:
          type: array
          items:
            type: string
        description: 'Include flaw metas with specified type only, multiple values
          may be separated by commas. '
      - in: path
        name: id
        schema:
          type: string
        description: A string representing either the internal OSIDB UUID of the Flaw
          resource or the CVE number corresponding to a Flaw
        required: true
      - in: query
        name: include_fields
        schema:
          type: array
          items:
            type: string
        description: 'Include only specified fields in the response. Multiple values
          may be separated by commas. Dot notation can be used to filter on related
          model fields. Example: `include_fields=uuid,affects.uuid,affects.trackers.uuid`'
      - in: query
        name: include_meta_attr
        schema:
          type: array
          items:
            type: string
        description: 'Specify which keys from meta_attr field should be retrieved,
          multiple values may be separated by commas. Dot notation can be used to
          specify meta_attr keys on related models. Example: `include_meta_attr=bz_id,affects.ps_module,affects.trackers.bz_id`Use
          wildcards eg. `include_meta_attr=*,affects.*,affects.trackers.*` for retrieving
          all the keys from meta_attr. Omit this parameter to not include meta_attr
          fields at all. '
      - in: query
        name: tracker_ids
        schema:
          type: array
          items:
            type: string
        description: Filter only Flaws which are related to specified Trackers (through
          Affects). Multiple tracker IDs may be separated by commas. Also only Affects
          that have the specified Trackers related will be shown.
      tags:
      - osidb
      security:
      - OsidbTokenAuthentication: []
      - {}
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Flaw'
                - type: object
                  properties:
                    dt:
                      type: string
                      format: date-time
                    env:
                      type: string
                    revision:
                      type: string
                    version:
                      type: string
          description: ''
    put:
      operationId: osidb_api_v1_flaws_update
      parameters:
      - in: path
        name: id
        schema:
          type: string
        description: A string representing either the internal OSIDB UUID of the Flaw
          resource or the CVE number corresponding to a Flaw
        required: true
      tags:
      - osidb
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Flaw'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Flaw'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Flaw'
        required: true
      security:
      - OsidbTokenAuthentication: []
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Flaw'
                - type: object
                  properties:
                    dt:
                      type: string
                      format: date-time
                    env:
                      type: string
                    revision:
                      type: string
                    version:
                      type: string
          description: ''
    delete:
      operationId: osidb_api_v1_flaws_destroy
      parameters:
      - in: path
        name: id
        schema:
          type: string
        description: A string representing either the internal OSIDB UUID of the Flaw
          resource or the CVE number corresponding to a Flaw
        required: true
      tags:
      - osidb
      security:
      - OsidbTokenAuthentication: []
      responses:
        '204':
          content:
            application/json:
              schema:
                type: object
                properties:
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /osidb/api/v1/manifest:
    get:
      operationId: osidb_api_v1_manifest_retrieve
      description: HTTP get /manifest
      tags:
      - osidb
      security:
      - OsidbTokenAuthentication: []
      - {}
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /osidb/api/v1/schema/:
    get:
      operationId: osidb_api_v1_schema_retrieve
      description: |-
        OpenApi3 schema for this API. Format can be selected via content negotiation.

        - YAML: application/vnd.oai.openapi
        - JSON: application/vnd.oai.openapi+json
      parameters:
      - in: query
        name: format
        schema:
          type: string
          enum:
          - json
          - yaml
      - in: query
        name: lang
        schema:
          type: string
          enum:
          - af
          - ar
          - ar-dz
          - ast
          - az
          - be
          - bg
          - bn
          - br
          - bs
          - ca
          - cs
          - cy
          - da
          - de
          - dsb
          - el
          - en
          - en-au
          - en-gb
          - eo
          - es
          - es-ar
          - es-co
          - es-mx
          - es-ni
          - es-ve
          - et
          - eu
          - fa
          - fi
          - fr
          - fy
          - ga
          - gd
          - gl
          - he
          - hi
          - hr
          - hsb
          - hu
          - hy
          - ia
          - id
          - ig
          - io
          - is
          - it
          - ja
          - ka
          - kab
          - kk
          - km
          - kn
          - ko
          - ky
          - lb
          - lt
          - lv
          - mk
          - ml
          - mn
          - mr
          - my
          - nb
          - ne
          - nl
          - nn
          - os
          - pa
          - pl
          - pt
          - pt-br
          - ro
          - ru
          - sk
          - sl
          - sq
          - sr
          - sr-latn
          - sv
          - sw
          - ta
          - te
          - tg
          - th
          - tk
          - tr
          - tt
          - udm
          - uk
          - ur
          - uz
          - vi
          - zh-hans
          - zh-hant
      tags:
      - osidb
      security:
      - KerberosAuthentication: []
      - OsidbTokenAuthentication: []
      - {}
      responses:
        '200':
          content:
            application/vnd.oai.openapi:
              schema:
                type: object
                additionalProperties: {}
            application/yaml:
              schema:
                type: object
                additionalProperties: {}
            application/vnd.oai.openapi+json:
              schema:
                type: object
                additionalProperties: {}
            application/json:
              schema:
                type: object
                additionalProperties: {}
                properties:
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /osidb/api/v1/status:
    get:
      operationId: osidb_api_v1_status_retrieve
      description: HTTP get /status
      tags:
      - osidb
      security:
      - OsidbTokenAuthentication: []
      - {}
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  osidb_data:
                    type: object
                    properties:
                      flaw_count:
                        type: integer
                  osidb_service:
                    type: object
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /osidb/api/v1/trackers:
    get:
      operationId: osidb_api_v1_trackers_list
      parameters:
      - in: query
        name: external_system_id
        schema:
          type: string
      - name: limit
        required: false
        in: query
        description: Number of results to return per page.
        schema:
          type: integer
      - name: offset
        required: false
        in: query
        description: The initial index from which to return the results.
        schema:
          type: integer
      - in: query
        name: ps_update_stream
        schema:
          type: string
      - in: query
        name: resolution
        schema:
          type: string
      - in: query
        name: status
        schema:
          type: string
      - in: query
        name: type
        schema:
          type: string
          enum:
          - BUGZILLA
          - JIRA
      - in: query
        name: uuid
        schema:
          type: string
          format: uuid
      tags:
      - osidb
      security:
      - OsidbTokenAuthentication: []
      - {}
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/PaginatedTrackerList'
                - type: object
                  properties:
                    dt:
                      type: string
                      format: date-time
                    env:
                      type: string
                    revision:
                      type: string
                    version:
                      type: string
          description: ''
    post:
      operationId: osidb_api_v1_trackers_create
      tags:
      - osidb
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Tracker'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Tracker'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Tracker'
        required: true
      security:
      - OsidbTokenAuthentication: []
      responses:
        '201':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Tracker'
                - type: object
                  properties:
                    dt:
                      type: string
                      format: date-time
                    env:
                      type: string
                    revision:
                      type: string
                    version:
                      type: string
          description: ''
  /osidb/api/v1/trackers/{uuid}:
    get:
      operationId: osidb_api_v1_trackers_retrieve
      parameters:
      - in: path
        name: uuid
        schema:
          type: string
          format: uuid
        description: A UUID string identifying this Tracker.
        required: true
      tags:
      - osidb
      security:
      - OsidbTokenAuthentication: []
      - {}
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Tracker'
                - type: object
                  properties:
                    dt:
                      type: string
                      format: date-time
                    env:
                      type: string
                    revision:
                      type: string
                    version:
                      type: string
          description: ''
    put:
      operationId: osidb_api_v1_trackers_update
      parameters:
      - in: path
        name: uuid
        schema:
          type: string
          format: uuid
        description: A UUID string identifying this Tracker.
        required: true
      tags:
      - osidb
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Tracker'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Tracker'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Tracker'
        required: true
      security:
      - OsidbTokenAuthentication: []
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Tracker'
                - type: object
                  properties:
                    dt:
                      type: string
                      format: date-time
                    env:
                      type: string
                    revision:
                      type: string
                    version:
                      type: string
          description: ''
    delete:
      operationId: osidb_api_v1_trackers_destroy
      parameters:
      - in: path
        name: uuid
        schema:
          type: string
          format: uuid
        description: A UUID string identifying this Tracker.
        required: true
      tags:
      - osidb
      security:
      - OsidbTokenAuthentication: []
      responses:
        '204':
          content:
            application/json:
              schema:
                type: object
                properties:
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /osidb/healthy:
    get:
      operationId: osidb_healthy_retrieve
      description: unauthenticated view providing healthcheck on osidb service
      tags:
      - osidb
      security:
      - OsidbTokenAuthentication: []
      - {}
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /osidb/whoami:
    get:
      operationId: osidb_whoami_retrieve
      description: View that provides information about the currently logged-in user
      tags:
      - osidb
      security:
      - OsidbTokenAuthentication: []
      - {}
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  dt:
                    type: string
                    format: date-time
                  email:
                    type: string
                  env:
                    type: string
                  groups:
                    type: array
                    items:
                      type: string
                  profile:
                    type: object
                    properties:
                      bz_user_id:
                        type: string
                      jira_user_id:
                        type: string
                  revision:
                    type: string
                  username:
                    type: string
                  version:
                    type: string
          description: ''
  /osim/:
    get:
      operationId: osim_retrieve
      description: index API endpoint listing available API endpoints
      tags:
      - osim
      security:
      - OsidbTokenAuthentication: []
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /osim/api/v1/workflows:
    get:
      operationId: osim_api_v1_workflows_retrieve
      description: workflow info API endpoint
      tags:
      - osim
      security:
      - OsidbTokenAuthentication: []
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /osim/api/v1/workflows/{id}:
    get:
      operationId: osim_api_v1_workflows_retrieve_2
      description: |-
        workflow classification API endpoint

        for flaw identified by UUID or CVE returns its workflow:state classification

        params:

            verbose - return also workflows with flaw classification
                      which represents the reasoning of the result
      parameters:
      - in: path
        name: id
        schema:
          type: string
        required: true
      - in: query
        name: verbose
        schema:
          type: boolean
        description: Return also workflows with flaw classification which represents
          the reasoning of the result.
      tags:
      - osim
      security:
      - OsidbTokenAuthentication: []
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /osim/api/v1/workflows/{id}/adjust:
    post:
      operationId: osim_api_v1_workflows_adjust_create
      description: |-
        workflow adjustion API endpoint

        adjust workflow classification of flaw identified by UUID or CVE
        and return its workflow:state classification (new if changed and old otherwise)

        adjust operation is idempotent so when the classification
        is already adjusted running it results in no operation
      parameters:
      - in: path
        name: id
        schema:
          type: string
        required: true
      tags:
      - osim
      security:
      - OsidbTokenAuthentication: []
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
  /osim/healthy:
    get:
      operationId: osim_healthy_retrieve
      description: unauthenticated health check API endpoint
      tags:
      - osim
      security:
      - OsidbTokenAuthentication: []
      - {}
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  dt:
                    type: string
                    format: date-time
                  env:
                    type: string
                  revision:
                    type: string
                  version:
                    type: string
          description: ''
components:
  schemas:
    Affect:
      type: object
      description: Affect serializer
      properties:
        uuid:
          type: string
          format: uuid
          readOnly: true
        flaw:
          type: string
          format: uuid
          nullable: true
        type:
          $ref: '#/components/schemas/AffectTypeEnum'
        affectedness:
          oneOf:
          - $ref: '#/components/schemas/AffectednessEnum'
          - $ref: '#/components/schemas/BlankEnum'
        resolution:
          oneOf:
          - $ref: '#/components/schemas/AffectResolutionEnum'
          - $ref: '#/components/schemas/BlankEnum'
        ps_module:
          type: string
          maxLength: 100
        ps_component:
          type: string
          maxLength: 255
        impact:
          oneOf:
          - $ref: '#/components/schemas/ImpactEnum'
          - $ref: '#/components/schemas/BlankEnum'
        cvss2:
          type: string
          maxLength: 100
        cvss2_score:
          type: number
          format: float
          nullable: true
        cvss3:
          type: string
          maxLength: 100
        cvss3_score:
          type: number
          format: float
          nullable: true
        trackers:
          type: array
          items:
            $ref: '#/components/schemas/Tracker'
          readOnly: true
        meta_attr:
          type: object
          properties:
            affectedness:
              type: string
            component:
              type: string
            cvss2:
              type: string
            cvss3:
              type: string
            impact:
              type: string
            module_name:
              type: string
            module_stream:
              type: string
            ps_component:
              type: string
            ps_module:
              type: string
            resolution:
              type: string
          readOnly: true
        delegated_resolution:
          type: string
          readOnly: true
        created_dt:
          type: string
          format: date-time
          readOnly: true
        updated_dt:
          type: string
          format: date-time
          readOnly: true
      required:
      - created_dt
      - delegated_resolution
      - flaw
      - meta_attr
      - ps_component
      - ps_module
      - trackers
      - updated_dt
      - uuid
    AffectResolutionEnum:
      enum:
      - FIX
      - DEFER
      - WONTFIX
      - OOSS
      - DELEGATED
      - WONTREPORT
      type: string
    AffectTypeEnum:
      enum:
      - DEFAULT
      type: string
    AffectednessEnum:
      enum:
      - NEW
      - AFFECTED
      - NOTAFFECTED
      type: string
    BlankEnum:
      enum:
      - ''
    CVEv5PackageVersions:
      type: object
      description: CVEv5 package versions serializer
      properties:
        package:
          type: string
          maxLength: 2058
        versions:
          type: array
          items:
            $ref: '#/components/schemas/CVEv5Versions'
      required:
      - package
      - versions
    CVEv5Versions:
      type: object
      description: CVEv5 Package Version Serializer
      properties:
        version:
          type: string
          maxLength: 1024
        status:
          $ref: '#/components/schemas/StatusEnum'
      required:
      - status
      - version
    Comment:
      type: object
      description: FlawComment serializer
      properties:
        uuid:
          type: string
          format: uuid
          readOnly: true
        type:
          $ref: '#/components/schemas/CommentTypeEnum'
        external_system_id:
          type: string
          maxLength: 100
        order:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
          nullable: true
        meta_attr:
          type: object
          additionalProperties:
            type: string
            nullable: true
        created_dt:
          type: string
          format: date-time
          readOnly: true
        updated_dt:
          type: string
          format: date-time
          readOnly: true
      required:
      - created_dt
      - external_system_id
      - updated_dt
      - uuid
    CommentTypeEnum:
      enum:
      - BUGZILLA
      type: string
    EPSS:
      type: object
      properties:
        cve:
          type: string
          maxLength: 50
        epss:
          type: number
          format: float
      required:
      - cve
      - epss
    Erratum:
      type: object
      description: Erratum serializer
      properties:
        et_id:
          type: integer
          readOnly: true
        advisory_name:
          type: string
          readOnly: true
        created_dt:
          type: string
          format: date-time
          readOnly: true
        updated_dt:
          type: string
          format: date-time
          readOnly: true
      required:
      - advisory_name
      - created_dt
      - et_id
      - updated_dt
    Flaw:
      type: object
      description: serialize flaw model
      properties:
        uuid:
          type: string
          format: uuid
          readOnly: true
        type:
          $ref: '#/components/schemas/FlawTypeEnum'
        cve_id:
          type: string
          nullable: true
        state:
          $ref: '#/components/schemas/StateEnum'
        resolution:
          oneOf:
          - $ref: '#/components/schemas/FlawResolutionEnum'
          - $ref: '#/components/schemas/BlankEnum'
        impact:
          oneOf:
          - $ref: '#/components/schemas/ImpactEnum'
          - $ref: '#/components/schemas/BlankEnum'
        title:
          type: string
        trackers:
          type: array
          items:
            type: string
          readOnly: true
        description:
          type: string
        summary:
          type: string
        statement:
          type: string
        cwe_id:
          type: string
          maxLength: 50
        embargoed:
          type: boolean
          readOnly: true
        unembargo_dt:
          type: string
          format: date-time
          nullable: true
        source:
          oneOf:
          - $ref: '#/components/schemas/SourceEnum'
          - $ref: '#/components/schemas/BlankEnum'
        reported_dt:
          type: string
          format: date-time
          nullable: true
        mitigated_by:
          type: string
          readOnly: true
          deprecated: true
        cvss2:
          type: string
          maxLength: 100
        cvss2_score:
          type: number
          format: float
          nullable: true
        nvd_cvss2:
          type: string
          maxLength: 100
        cvss3:
          type: string
          maxLength: 100
        cvss3_score:
          type: number
          format: float
          nullable: true
        nvd_cvss3:
          type: string
          maxLength: 100
        is_major_incident:
          type: boolean
        affects:
          type: array
          items:
            $ref: '#/components/schemas/Affect'
          readOnly: true
        meta:
          type: array
          items:
            $ref: '#/components/schemas/Meta'
          readOnly: true
        comments:
          type: array
          items:
            $ref: '#/components/schemas/Comment'
          readOnly: true
        meta_attr:
          type: object
          properties:
            acknowledgments:
              type: string
            acks_not_needed:
              type: string
            affects:
              type: string
            alias:
              type: string
            bz_datascore:
              type: string
            bz_id:
              type: string
            checklists:
              type: string
            classification:
              type: string
            cvss2:
              type: string
            cvss2_score:
              type: string
            cvss2_vector:
              type: string
            cvss3:
              type: string
            cvss3_comment:
              type: string
            cvss3_score:
              type: string
            cvss3_vector:
              type: string
            cwe:
              type: string
            depends_on:
              type: string
            impact:
              type: string
            jira_trackers:
              type: string
            mitigate:
              type: string
            mitigation:
              type: string
            prestage_eligible_date:
              type: string
            public:
              type: string
            references:
              type: string
            related_cves:
              type: string
            reported:
              type: string
            source:
              type: string
            statement:
              type: string
            task_owner:
              type: string
          readOnly: true
        package_versions:
          type: array
          items:
            $ref: '#/components/schemas/CVEv5PackageVersions'
          readOnly: true
        created_dt:
          type: string
          format: date-time
          readOnly: true
        updated_dt:
          type: string
          format: date-time
          readOnly: true
        classification:
          type: object
          properties:
            workflow:
              type: string
            state:
              type: string
              enum:
              - DRAFT
              - NEW
              - ANALYSIS
              - REVIEW
              - FIX
              - DONE
          readOnly: true
      required:
      - affects
      - classification
      - comments
      - created_dt
      - description
      - embargoed
      - meta
      - meta_attr
      - mitigated_by
      - package_versions
      - title
      - trackers
      - updated_dt
      - uuid
    FlawResolutionEnum:
      enum:
      - DUPLICATE
      - WONTFIX
      - NOTABUG
      - ERRATA
      - CANTFIX
      - DEFERRED
      - CURRENTRELEASE
      - UPSTREAM
      - RAWHIDE
      - INSUFFICIENT_DATA
      - NEXTRELEASE
      - WORKSFORME
      - EOL
      type: string
    FlawTypeEnum:
      enum:
      - VULNERABILITY
      - WEAKNESS
      type: string
    ImpactEnum:
      enum:
      - LOW
      - MODERATE
      - IMPORTANT
      - CRITICAL
      type: string
    Meta:
      type: object
      description: FlawMeta serializer
      properties:
        uuid:
          type: string
          format: uuid
          readOnly: true
        type:
          $ref: '#/components/schemas/MetaTypeEnum'
        meta_attr:
          type: object
          additionalProperties:
            type: string
            nullable: true
        created_dt:
          type: string
          format: date-time
          readOnly: true
        updated_dt:
          type: string
          format: date-time
          readOnly: true
      required:
      - created_dt
      - type
      - updated_dt
      - uuid
    MetaTypeEnum:
      enum:
      - ERRATA
      - REFERENCE
      - ACKNOWLEDGMENT
      - EXPLOIT
      - MAJOR_INCIDENT
      - MAJOR_INCIDENT_LITE
      - REQUIRES_DOC_TEXT
      - NIST_CVSS_VALIDATION
      - NEED_INFO
      - CHECKLIST
      - NVD_CVSS
      type: string
    PaginatedAffectList:
      type: object
      properties:
        count:
          type: integer
          example: 123
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=400&limit=100
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=200&limit=100
        results:
          type: array
          items:
            $ref: '#/components/schemas/Affect'
    PaginatedEPSSList:
      type: object
      properties:
        count:
          type: integer
          example: 123
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=400&limit=100
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=200&limit=100
        results:
          type: array
          items:
            $ref: '#/components/schemas/EPSS'
    PaginatedFlawList:
      type: object
      properties:
        count:
          type: integer
          example: 123
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=400&limit=100
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=200&limit=100
        results:
          type: array
          items:
            $ref: '#/components/schemas/Flaw'
    PaginatedTrackerList:
      type: object
      properties:
        count:
          type: integer
          example: 123
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=400&limit=100
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=200&limit=100
        results:
          type: array
          items:
            $ref: '#/components/schemas/Tracker'
    SourceEnum:
      enum:
      - ADOBE
      - APPLE
      - ASF
      - BIND
      - BK
      - BUGTRAQ
      - BUGZILLA
      - CERT
      - CERTIFI
      - CORELABS
      - CUSTOMER
      - CVE
      - DAILYDAVE
      - DEBIAN
      - DISTROS
      - FEDORA
      - FETCHMAIL
      - FREEDESKTOP
      - FREERADIUS
      - FRSIRT
      - FULLDISCLOSURE
      - GAIM
      - GENTOO
      - GENTOOBZ
      - GIT
      - GNOME
      - GNUPG
      - GOOGLE
      - HP
      - HW_VENDOR
      - IBM
      - IDEFENSE
      - INTERNET
      - ISC
      - ISEC
      - IT
      - JBOSS
      - JPCERT
      - KERNELBUGZILLA
      - KERNELSEC
      - LKML
      - LWN
      - MACROMEDIA
      - MAGEIA
      - MAILINGLIST
      - MILW0RM
      - MIT
      - MITRE
      - MOZILLA
      - MUTTDEV
      - NETDEV
      - NISCC
      - OCERT
      - OPENOFFICE
      - OPENSSL
      - OPENSUSE
      - ORACLE
      - OSS
      - OSSSECURITY
      - PHP
      - PIDGIN
      - POSTGRESQL
      - PRESS
      - REAL
      - REDHAT
      - RESEARCHER
      - RT
      - SAMBA
      - SECALERT
      - SECUNIA
      - SECURITYFOCUS
      - SKO
      - SQUID
      - SQUIRRELMAIL
      - SUN
      - SUNSOLVE
      - SUSE
      - TWITTER
      - UBUNTU
      - UPSTREAM
      - VENDORSEC
      - VULNWATCH
      - WIRESHARK
      - XCHAT
      - XEN
      - XPDF
      type: string
    StateEnum:
      enum:
      - ASSIGNED
      - CLOSED
      - MODIFIED
      - NEW
      - ON_DEV
      - ON_QA
      - POST
      - RELEASE_PENDING
      - VERIFIED
      type: string
    StatusEnum:
      enum:
      - AFFECTED
      - UNAFFECTED
      - UNKNOWN
      type: string
    TokenObtainPair:
      type: object
      properties:
        username:
          type: string
          writeOnly: true
        password:
          type: string
          writeOnly: true
        access:
          type: string
          readOnly: true
        refresh:
          type: string
          readOnly: true
      required:
      - access
      - password
      - refresh
      - username
    TokenRefresh:
      type: object
      properties:
        access:
          type: string
          readOnly: true
        refresh:
          type: string
          writeOnly: true
      required:
      - access
      - refresh
    TokenVerify:
      type: object
      properties:
        token:
          type: string
          writeOnly: true
      required:
      - token
    Tracker:
      type: object
      description: Tracker serializer
      properties:
        uuid:
          type: string
          format: uuid
          readOnly: true
        type:
          $ref: '#/components/schemas/TrackerTypeEnum'
        external_system_id:
          type: string
          maxLength: 100
        affects:
          type: array
          items:
            type: string
            format: uuid
        status:
          type: string
          maxLength: 100
        resolution:
          type: string
          maxLength: 100
        errata:
          type: array
          items:
            $ref: '#/components/schemas/Erratum'
          readOnly: true
        meta_attr:
          type: object
          properties:
            bz_id:
              type: string
            owner:
              type: string
            qe_owner:
              type: string
            ps_component:
              type: string
            ps_module:
              type: string
            ps_update_stream:
              type: string
            resolution:
              type: string
            status:
              type: string
          readOnly: true
        created_dt:
          type: string
          format: date-time
          readOnly: true
        updated_dt:
          type: string
          format: date-time
          readOnly: true
      required:
      - created_dt
      - errata
      - external_system_id
      - meta_attr
      - status
      - type
      - updated_dt
      - uuid
    TrackerTypeEnum:
      enum:
      - JIRA
      - BUGZILLA
      type: string
  securitySchemes:
    KerberosAuthentication:
      type: http
      scheme: negotiate
      in: header
    OsidbTokenAuthentication:
      type: http
      scheme: bearer
      bearerFormat: JWT