---
openapi: 3.1.0
paths:
  /census/groups:
    get:
      parameters:
      - description: "Lists the group for the groupid, or all if not provided."
        example: vulnerability
        name: groupid
        in: query
        schema:
          type: string
      responses:
        "200":
          description: OK
      summary: Get Groups
      tags:
      - Census Resource
  /census/groups/search:
    get:
      parameters:
      - description: Search query for groups using a regular expression. Searches
          both groupid and group names.
        example: .*uln.*
        name: query
        in: query
        schema:
          type: string
      responses:
        "200":
          description: OK
      summary: Search Groups
      tags:
      - Census Resource
  /census/people:
    get:
      parameters:
      - description: "Lists the person(s) with the specified userid(s). Multiple IDs\
          \ can be provided as a comma-separated list (e.g., 'hirt,duke,iris'). If\
          \ no userid is provided, returns all people in OpenJDK."
        example: "hirt,duke"
        name: userid
        in: query
        schema:
          type: string
      responses:
        "200":
          description: OK
      summary: Get People
      tags:
      - Census Resource
  /census/people/search:
    get:
      parameters:
      - description: Search query for people using a regular expression. Searches
          through both userid and full names.
        example: .*Hirt
        name: query
        in: query
        schema:
          type: string
      responses:
        "200":
          description: OK
      summary: Search People
      tags:
      - Census Resource
  /census/projects:
    get:
      parameters:
      - description: "Lists the project for the projectid, or all projects if not\
          \ provided."
        example: jmc
        name: projectid
        in: query
        schema:
          type: string
      responses:
        "200":
          description: OK
      summary: Get Projects
      tags:
      - Census Resource
  /census/projects/search:
    get:
      parameters:
      - description: Search query for projects using a regular expression. Searches
          both projectid and project names.
        example: .*Mission.*
        name: query
        in: query
        schema:
          type: string
      responses:
        "200":
          description: OK
      summary: Search Projects
      tags:
      - Census Resource
  /github/pulls:
    get:
      parameters:
      - description: "The sort order, [asc|desc]"
        example: desc
        name: direction
        in: query
        schema:
          type: string
          default: desc
      - description: "The maximum number of results. Defaults to -1 which means as\
          \ many as we can get. Tips: to get the oldest PR, set maxresults to 1, sort\
          \ to created and set the sort order to asc. To get the newest, set the sort\
          \ order to desc."
        example: 100
        name: maxresults
        in: query
        schema:
          type: integer
          format: int32
          default: -1
      - description: The owner of the repository
        example: openjdk
        required: true
        name: owner
        in: query
        schema:
          type: string
      - description: The name of the repository
        example: jmc
        required: true
        name: repo
        in: query
        schema:
          type: string
      - description: "In what order to get the results, [created|updated|popularity|long-running]"
        example: created
        name: sort
        in: query
        schema:
          type: string
          default: created
      - description: "The state of the PRs to list, [open|closed|all]"
        example: open
        name: state
        in: query
        schema:
          type: string
          default: open
      - description: The user opening the PR (optional)
        example: thegreystone
        name: user
        in: query
        schema:
          type: string
      responses:
        "200":
          description: OK
      summary: Get Pull Requests
      tags:
      - Git Hub Resource
  /github/repos:
    get:
      parameters:
      - description: The user for which to list the repositories.
        example: thegreystone
        name: user
        in: query
        schema:
          type: string
      responses:
        "200":
          description: OK
      summary: Get Repositories
      tags:
      - Git Hub Resource
  /mcp:
    get:
      responses:
        "200":
          description: OK
      summary: Mcp Root
      tags:
      - MCP Transport Resource
    options:
      responses:
        "200":
          description: OK
      summary: Mcp Options
      tags:
      - MCP Transport Resource
  /version:
    get:
      responses:
        "200":
          description: OK
          content:
            text/plain:
              schema:
                type: string
      summary: Get Version
      tags:
      - Version Resource
info:
  title: openjdk-helper API
  version: 0.1.0
servers:
- url: https://api.hirt.se/openjdk
