Home • Explore • Blog • Models • CI
☰



ragit
7th chunk of `docs/ragithub/openapi.yaml`
aef1e258f270610efcc395ee60686710d2faac6acd8660620000000100000fa8
 operationId: GetServerVersion
      responses:
        '200':
          description: version of the server
          content:
            text/plain:
              schema:
                type: string
                example: "0.4.0-dev"
  /user-list:
    get:
      operationId: GetUserList
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            default: 50
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            format: int32
            default: 0
      responses:
        '200':
          description: ""
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/UserSimple'
    post:
      description: It creates a new user. If it's the first user, the user becomes an admin.
      operationId: CreateUser
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserCreation'
      responses:
        '200':
          description: The response has no body.
  /user-list/{user}:
    get:
      operationId: GetUser
      parameters:
        - name: user
          in: path
          required: true
          description: user id
          schema:
            type: string
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            default: 50
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            format: int32
            default: 0
      responses:
        '200':
          description: ""
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/UserDetail'
  /user-list/{user}/ai-model-list:
    get:
      description: This was intended for chat interface, but the plan has changed and we're not developing chat interface for ragithub. Please use `GET /ai-model-list` API instead.
    put:
      description: This was intended for chat interface, but the plan has changed and we're not developing chat interface for ragithub. Please use `PUT /ai-model-list` API instead.
  /user-list/{user}/api-key-list:
    get:
      operationId: GetApiKeyList
      parameters:
        - name: user
          in: path
          required: true
          description: user id
          schema:
            type: string
      responses:
        '200':
          description: ""
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ApiKey'
    post:
      operationId: CreateApiKey
      parameters:
        - name: user
          in: path
          required: true
          description: user id
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApiKeyCreation'
      responses:
        '200':
          description: ""
          content:
            text/plain:
              schema:
                type: string
                description: created api key
  /repo-list/{user}:
    get:
      operationId: GetRepoList
      parameters:
        - name: user
          in: path
          required: true
          description: user id
          schema:
            type: string
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
            default: 50
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            format: int32
            default:
Title: API Endpoints for User and Repository Management
Summary
This section describes various API endpoints for managing users, including retrieving user lists, creating new users, and managing API keys, as well as endpoints for retrieving repository lists, with support for query parameters, path parameters, and different response formats like JSON and plain text.