University of California, Davis

CAES PEAKS API

The College of Agricultural and Environmental Sciences (CAES) Computing Resources Unit publishes the PEAKS API with Swagger/OpenAPI documentation. PEAKS supports CAES administrative and computing workflows.

GitHub OpenAPI

Documentation

📖
Documentation
https://computing.caes.ucdavis.edu/documentation/peaks/api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/uc-davis/refs/heads/main/openapi/uc-davis-peaks.yaml

Other Resources

🔗
x-json-schema
https://raw.githubusercontent.com/api-evangelist/uc-davis/refs/heads/main/json-schema/uc-davis-key-schema.json
🔗
x-json-structure
https://raw.githubusercontent.com/api-evangelist/uc-davis/refs/heads/main/json-structure/uc-davis-key-structure.json
🔗
x-examples
https://raw.githubusercontent.com/api-evangelist/uc-davis/refs/heads/main/examples/uc-davis-keys-list-example.json
🔗
x-rules
https://raw.githubusercontent.com/api-evangelist/uc-davis/refs/heads/main/rules/uc-davis-rules.yml
🔗
x-vocabulary
https://raw.githubusercontent.com/api-evangelist/uc-davis/refs/heads/main/vocabulary/uc-davis-vocabulary.yml
🔗
x-json-ld
https://raw.githubusercontent.com/api-evangelist/uc-davis/refs/heads/main/json-ld/uc-davis-context.jsonld

OpenAPI Specification

uc-davis-peaks.yaml Raw ↑ 
openapi: 3.0.1
info:
  title: PEAKS API v1
  description: People Equipment Access Keys Space
  contact:
    name: Application Support
    url: https://caeshelp.ucdavis.edu/?appname=Peaks
  license:
    name: MIT
    url: https://github.com/ucdavis/Peaks/blob/master/LICENSE
  version: v1
  ProjectUrl: https://github.com/ucdavis/Peaks/
paths:
  /api/{teamName}/access/Search:
    get:
      tags:
      - Access
      parameters:
      - name: q
        in: query
        schema:
          type: string
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Access'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - AccessMasterAccess
  /api/{teamName}/access/ListAssigned:
    get:
      tags:
      - Access
      parameters:
      - name: personId
        in: query
        schema:
          type: integer
          format: int32
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Access'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - AccessMasterAccess
  /api/{teamName}/access/List:
    get:
      tags:
      - Access
      summary: List Access
      parameters:
      - name: filter
        in: query
        description: 0 = ShowActive, 1 = ShowInactive, 2 = ShowAll. Defaults to Show Active
        schema:
          $ref: '#/components/schemas/Filter'
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Access'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - AccessMasterAccess
  /api/{teamName}/access/Details/{id}:
    get:
      tags:
      - Access
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
          format: int32
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Access'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - AccessMasterAccess
  /api/{teamName}/access/Create:
    post:
      tags:
      - Access
      parameters:
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Access'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Access'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - AccessMasterAccess
  /api/{teamName}/access/Assign:
    post:
      tags:
      - Access
      parameters:
      - name: accessId
        in: query
        schema:
          type: integer
          format: int32
      - name: personId
        in: query
        schema:
          type: integer
          format: int32
      - name: date
        in: query
        schema:
          type: string
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessAssignment'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - AccessMasterAccess
  /api/{teamName}/access/Update:
    post:
      tags:
      - Access
      summary: Only Name, Notes, and Tags fields are updated
      parameters:
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Access'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Access'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - AccessMasterAccess
  /api/{teamName}/access/Revoke/{id}:
    post:
      tags:
      - Access
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
          format: int32
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessAssignment'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - AccessMasterAccess
  /api/{teamName}/access/Delete/{id}:
    post:
      tags:
      - Access
      summary: If there are any assignments, they will be removed before the access record is set to inactive
      parameters:
      - name: id
        in: path
        description: ''
        required: true
        schema:
          type: integer
          format: int32
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Access'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - AccessMasterAccess
  /api/{teamName}/access/GetHistory/{id}:
    get:
      tags:
      - Access
      summary: "Return history records\r\nDefaults to a max of 5 records returned"
      parameters:
      - name: id
        in: path
        description: ''
        required: true
        schema:
          type: integer
          format: int32
      - name: max
        in: query
        description: the max number of record to take. Defaults to 5
        schema:
          type: integer
          format: int32
          default: 5
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/History'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - AccessMasterAccess
  /api/{teamName}/documents/List:
    get:
      tags:
      - Documents
      parameters:
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Document'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - DocumentMasterAccess
  /api/{teamName}/documents/Find/{id}:
    get:
      tags:
      - Documents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
          format: int32
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Document'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - DocumentMasterAccess
  /api/{teamName}/documents/Get/{id}:
    get:
      tags:
      - Documents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
          format: int32
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/pdf:
              schema:
                type: string
                format: binary
            application/json:
              schema:
                type: string
                format: binary
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - DocumentMasterAccess
  /api/{teamName}/documents/TeamSettings:
    get:
      tags:
      - Documents
      parameters:
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/DocumentTemplateInfo'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - DocumentMasterAccess
  /api/{teamName}/documents/Create:
    post:
      tags:
      - Documents
      parameters:
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Document'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Document'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - DocumentMasterAccess
  /api/{teamName}/documents/Delete/{id}:
    post:
      tags:
      - Documents
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
          format: int32
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Document'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - DocumentMasterAccess
  /api/{teamName}/equipment/Search:
    get:
      tags:
      - Equipment
      parameters:
      - name: q
        in: query
        schema:
          type: string
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Equipment'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - EquipMasterAccess
  /api/{teamName}/equipment/SearchAttributes:
    get:
      tags:
      - Equipment
      parameters:
      - name: q
        in: query
        schema:
          type: string
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Equipment'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - EquipMasterAccess
  /api/{teamName}/equipment/GetEquipmentInSpace:
    get:
      tags:
      - Equipment
      parameters:
      - name: spaceId
        in: query
        schema:
          type: integer
          format: int32
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Equipment'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - EquipMasterAccess
  /api/{teamName}/equipment/CommonAttributeKeys:
    get:
      tags:
      - Equipment
      parameters:
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/EquipmentAttributeKey'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - EquipMasterAccess
  /api/{teamName}/equipment/ListEquipmentTypes:
    get:
      tags:
      - Equipment
      parameters:
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Type'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - EquipMasterAccess
  /api/{teamName}/equipment/ListAssigned:
    get:
      tags:
      - Equipment
      parameters:
      - name: personId
        in: query
        schema:
          type: integer
          format: int32
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Equipment'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - EquipMasterAccess
  /api/{teamName}/equipment/List:
    get:
      tags:
      - Equipment
      summary: List all equipments for a team
      parameters:
      - name: filter
        in: query
        description: 0 = ShowActive, 1 = ShowInactive, 2 = ShowAll. Defaults to Show Active
        schema:
          $ref: '#/components/schemas/Filter'
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Equipment'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - EquipMasterAccess
  /api/{teamName}/equipment/Details/{id}:
    get:
      tags:
      - Equipment
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
          format: int32
      - name: showDeleted
        in: query
        schema:
          type: boolean
          default: false
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Equipment'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - EquipMasterAccess
  /api/{teamName}/equipment/Create:
    post:
      tags:
      - Equipment
      parameters:
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Equipment'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Equipment'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - EquipMasterAccess
  /api/{teamName}/equipment/Duplicate:
    post:
      tags:
      - Equipment
      parameters:
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Equipment'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Equipment'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - EquipMasterAccess
  /api/{teamName}/equipment/Assign:
    post:
      tags:
      - Equipment
      parameters:
      - name: equipmentId
        in: query
        schema:
          type: integer
          format: int32
      - name: personId
        in: query
        schema:
          type: integer
          format: int32
      - name: date
        in: query
        schema:
          type: string
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Equipment'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - EquipMasterAccess
  /api/{teamName}/equipment/Update:
    post:
      tags:
      - Equipment
      parameters:
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Equipment'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Equipment'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - EquipMasterAccess
  /api/{teamName}/equipment/Revoke/{id}:
    post:
      tags:
      - Equipment
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
          format: int32
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Equipment'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - EquipMasterAccess
  /api/{teamName}/equipment/Delete/{id}:
    post:
      tags:
      - Equipment
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
          format: int32
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Equipment'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - EquipMasterAccess
  /api/{teamName}/equipment/GetHistory/{id}:
    get:
      tags:
      - Equipment
      summary: Takes the top 5 history records
      parameters:
      - name: id
        in: path
        description: ''
        required: true
        schema:
          type: integer
          format: int32
      - name: max
        in: query
        description: Defaults to 5
        schema:
          type: integer
          format: int32
          default: 5
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/History'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - EquipMasterAccess
  /api/{teamName}/equipment/GetComputer/{id}:
    get:
      tags:
      - Equipment
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ServiceNowPropertyWrapper'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - EquipMasterAccess
  /api/{teamName}/equipment/GetComputersBySearch:
    get:
      tags:
      - Equipment
      parameters:
      - name: value
        in: query
        schema:
          type: string
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ServiceNowPropertyWrapper'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - EquipMasterAccess
  /api/{teamName}/keys/Search:
    get:
      tags:
      - Keys
      parameters:
      - name: q
        in: query
        schema:
          type: string
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Key'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - KeyMasterAccess
  /api/{teamName}/keys/List:
    get:
      tags:
      - Keys
      summary: List all keys for a team
      parameters:
      - name: filter
        in: query
        description: 0 = ShowActive, 1 = ShowInactive, 2 = ShowAll. Defaults to Show Active
        schema:
          $ref: '#/components/schemas/Filter'
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Key'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - KeyMasterAccess
  /api/{teamName}/keys/Details/{id}:
    get:
      tags:
      - Keys
      summary: Show details of a key
      parameters:
      - name: id
        in: path
        description: The Key Id
        required: true
        schema:
          type: integer
          format: int32
      - name: includeSerial
        in: query
        description: Includes serials any related assignments, and the person
        schema:
          type: boolean
          default: false
      - name: includeSpace
        in: query
        description: Include any related spaces
        schema:
          type: boolean
          default: false
      - name: teamName
        in: path
        required: true
        schema:
          type: string
      - name: X-Auth-Token
        in: header
        description: access token
        required: true
        schema:
          type: string
          default: ApiKey
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Key'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - ApiKey:
        - KeyMasterAccess
  /api/{team

# --- truncated at 32 KB (136 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/uc-davis/refs/heads/main/openapi/uc-davis-peaks.yaml