PEAKS Person

{
  "x-provenance": {
    "generated": "2026-08-19",
    "method": "derived",
    "operator": "institution",
    "source": "openapi/_original/uc-davis-peaks.yaml (PEAKS API v1, https://peaks.ucdavis.edu/swagger/v1/swagger.json)",
    "note": "Derived by API Evangelist tooling from the institution's own PEAKS contract. Not published by UC Davis."
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/uc-davis/main/json-schema/uc-davis-person-schema.json",
  "title": "PEAKS Person",
  "description": "A person record managed within a UC Davis CAES PEAKS team.",
  "type": "object",
  "required": [
    "email",
    "firstName",
    "lastName"
  ],
  "additionalProperties": false,
  "properties": {
    "id": {
      "type": "integer",
      "format": "int32",
      "description": "System-assigned identifier for the person."
    },
    "active": {
      "type": "boolean",
      "description": "Whether the person record is active."
    },
    "teamId": {
      "type": "integer",
      "format": "int32",
      "description": "Identifier of the owning team."
    },
    "userId": {
      "type": [
        "string",
        "null"
      ],
      "description": "Linked user account identifier."
    },
    "firstName": {
      "type": "string",
      "maxLength": 50,
      "description": "Person's first name."
    },
    "lastName": {
      "type": "string",
      "maxLength": 50,
      "description": "Person's last name."
    },
    "name": {
      "type": [
        "string",
        "null"
      ],
      "maxLength": 256,
      "readOnly": true,
      "description": "Derived full name."
    },
    "email": {
      "type": "string",
      "format": "email",
      "maxLength": 256,
      "description": "Person's email address."
    },
    "tags": {
      "type": [
        "string",
        "null"
      ],
      "description": "Comma-delimited tags."
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "Person's title."
    },
    "homePhone": {
      "type": [
        "string",
        "null"
      ],
      "description": "Home phone number."
    },
    "teamPhone": {
      "type": [
        "string",
        "null"
      ],
      "description": "Team phone number."
    },
    "supervisorId": {
      "type": [
        "integer",
        "null"
      ],
      "format": "int32",
      "description": "Identifier of the supervising person."
    },
    "startDate": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "Person's start date."
    }
  }
}