{
    "openapi": "3.1.0",
    "info": {
        "title": "HCM API",
        "version": "0.0.1",
        "description": "HCM API \u2014 see hcm-docs\/04-api-specification.md for the envelope, error-code, and pagination conventions this reference doesn't show on its own."
    },
    "servers": [
        {
            "url": "https:\/\/hr-api.his-global.com\/api"
        }
    ],
    "paths": {
        "\/v1\/api-keys": {
            "get": {
                "operationId": "v1.api-keys.index",
                "tags": [
                    "ApiKey"
                ],
                "responses": {
                    "200": {
                        "description": "Paginated set of `ApiKeyResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/ApiKeyResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "current_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "per_page": {
                                                    "type": "integer",
                                                    "description": "Number of items shown per page.",
                                                    "minimum": 0
                                                },
                                                "total": {
                                                    "type": "integer",
                                                    "description": "Total number of items being paginated.",
                                                    "minimum": 0
                                                },
                                                "last_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "current_page",
                                                "per_page",
                                                "total",
                                                "last_page",
                                                "request_id"
                                            ]
                                        },
                                        "links": {
                                            "type": "object",
                                            "properties": {
                                                "first": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "last": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "prev": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "next": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                }
                                            },
                                            "required": [
                                                "first",
                                                "last",
                                                "prev",
                                                "next"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta",
                                        "links"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            },
            "post": {
                "operationId": "v1.api-keys.store",
                "tags": [
                    "ApiKey"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/ApiKeyStoreRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "`ApiKeyResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/ApiKeyResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/api-keys\/{apiKey}": {
            "patch": {
                "operationId": "v1.api-keys.update",
                "tags": [
                    "ApiKey"
                ],
                "parameters": [
                    {
                        "name": "apiKey",
                        "in": "path",
                        "required": true,
                        "description": "The api key ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/ApiKeyUpdateRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`ApiKeyResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/ApiKeyResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/api-keys\/{apiKey}\/revoke": {
            "post": {
                "operationId": "v1.api-keys.revoke",
                "tags": [
                    "ApiKey"
                ],
                "parameters": [
                    {
                        "name": "apiKey",
                        "in": "path",
                        "required": true,
                        "description": "The api key ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "`ApiKeyResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/ApiKeyResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/approval-delegations": {
            "get": {
                "operationId": "v1.approval-delegations.index",
                "tags": [
                    "ApprovalDelegation"
                ],
                "responses": {
                    "200": {
                        "description": "Array of `ApprovalDelegationResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "allOf": [
                                                    {
                                                        "$ref": "#\/components\/schemas\/ApprovalDelegationResource"
                                                    },
                                                    {
                                                        "type": "object",
                                                        "required": [
                                                            "delegate"
                                                        ]
                                                    }
                                                ]
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            },
            "post": {
                "operationId": "v1.approval-delegations.store",
                "tags": [
                    "ApprovalDelegation"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/ApprovalDelegationStoreRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "`ApprovalDelegationResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "allOf": [
                                                {
                                                    "$ref": "#\/components\/schemas\/ApprovalDelegationResource"
                                                },
                                                {
                                                    "type": "object",
                                                    "required": [
                                                        "delegate"
                                                    ]
                                                }
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/approval-delegations\/{delegation}": {
            "delete": {
                "operationId": "v1.approval-delegations.destroy",
                "tags": [
                    "ApprovalDelegation"
                ],
                "parameters": [
                    {
                        "name": "delegation",
                        "in": "path",
                        "required": true,
                        "description": "The delegation ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "No content"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/attendance\/my": {
            "get": {
                "operationId": "v1.attendance.my",
                "summary": "`GET \/attendance\/my` \u2014 today's record plus the last 14 days, most recent first",
                "tags": [
                    "Attendance"
                ],
                "responses": {
                    "200": {
                        "description": "Array of `AttendanceRecordResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/AttendanceRecordResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/attendance\/daily": {
            "get": {
                "operationId": "v1.attendance.daily",
                "summary": "`GET \/attendance\/daily` \u2014 one day, every employee in the caller's scope, plus a summary\ndoc 04 \u00a73.1's \"rates by ... department\" idea in miniature for the one day requested",
                "tags": [
                    "Attendance"
                ],
                "parameters": [
                    {
                        "name": "date",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "type": "array",
                                                "items": {}
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                },
                                                "summary": {
                                                    "type": "object",
                                                    "properties": {
                                                        "total": {
                                                            "type": "integer",
                                                            "minimum": 0
                                                        },
                                                        "present": {
                                                            "type": "integer",
                                                            "minimum": 0
                                                        },
                                                        "late": {
                                                            "type": "integer",
                                                            "minimum": 0
                                                        },
                                                        "on_leave": {
                                                            "type": "integer",
                                                            "minimum": 0
                                                        },
                                                        "absent": {}
                                                    },
                                                    "required": [
                                                        "total",
                                                        "present",
                                                        "late",
                                                        "on_leave",
                                                        "absent"
                                                    ]
                                                }
                                            },
                                            "required": [
                                                "request_id",
                                                "summary"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/attendance\/clock-in": {
            "post": {
                "operationId": "v1.attendance.clock-in",
                "tags": [
                    "Attendance"
                ],
                "responses": {
                    "200": {
                        "description": "`AttendanceRecordResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "allOf": [
                                                {
                                                    "$ref": "#\/components\/schemas\/AttendanceRecordResource"
                                                },
                                                {
                                                    "type": "object",
                                                    "required": [
                                                        "employee"
                                                    ]
                                                }
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/attendance\/clock-out": {
            "post": {
                "operationId": "v1.attendance.clock-out",
                "tags": [
                    "Attendance"
                ],
                "responses": {
                    "200": {
                        "description": "`AttendanceRecordResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "allOf": [
                                                {
                                                    "$ref": "#\/components\/schemas\/AttendanceRecordResource"
                                                },
                                                {
                                                    "type": "object",
                                                    "required": [
                                                        "employee"
                                                    ]
                                                }
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/auth\/me": {
            "get": {
                "operationId": "auth.me",
                "tags": [
                    "AuthenticatedSession"
                ],
                "responses": {
                    "200": {
                        "description": "`UserResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "allOf": [
                                                {
                                                    "$ref": "#\/components\/schemas\/UserResource"
                                                },
                                                {
                                                    "type": "object",
                                                    "required": [
                                                        "company"
                                                    ]
                                                }
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/auth\/logout": {
            "post": {
                "operationId": "auth.logout",
                "tags": [
                    "AuthenticatedSession"
                ],
                "responses": {
                    "204": {
                        "description": "No content"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/auth\/link-employee": {
            "post": {
                "operationId": "auth.link-employee",
                "summary": "Self-service equivalent of an admin manually setting `users.employee_id` \u2014 see\n`App\\Actions\\Auth\\LinkEmployeeAction` for the matching\/already-linked rules",
                "tags": [
                    "AuthenticatedSession"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/LinkEmployeeRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`UserResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "allOf": [
                                                {
                                                    "$ref": "#\/components\/schemas\/UserResource"
                                                },
                                                {
                                                    "type": "object",
                                                    "required": [
                                                        "company"
                                                    ]
                                                }
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/companies": {
            "get": {
                "operationId": "v1.companies.index",
                "tags": [
                    "Company"
                ],
                "parameters": [
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "default": 100
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Paginated set of `CompanyResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/CompanyResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "current_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "per_page": {
                                                    "type": "integer",
                                                    "description": "Number of items shown per page.",
                                                    "minimum": 0
                                                },
                                                "total": {
                                                    "type": "integer",
                                                    "description": "Total number of items being paginated.",
                                                    "minimum": 0
                                                },
                                                "last_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "current_page",
                                                "per_page",
                                                "total",
                                                "last_page",
                                                "request_id"
                                            ]
                                        },
                                        "links": {
                                            "type": "object",
                                            "properties": {
                                                "first": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "last": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "prev": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "next": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                }
                                            },
                                            "required": [
                                                "first",
                                                "last",
                                                "prev",
                                                "next"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta",
                                        "links"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/companies\/{company}": {
            "get": {
                "operationId": "v1.companies.show",
                "tags": [
                    "Company"
                ],
                "parameters": [
                    {
                        "name": "company",
                        "in": "path",
                        "required": true,
                        "description": "The company ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "`CompanyResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/CompanyResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            },
            "patch": {
                "operationId": "v1.companies.update",
                "tags": [
                    "Company"
                ],
                "parameters": [
                    {
                        "name": "company",
                        "in": "path",
                        "required": true,
                        "description": "The company ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/CompanyUpdateRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`CompanyResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/CompanyResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/departments": {
            "get": {
                "operationId": "v1.departments.index",
                "tags": [
                    "Department"
                ],
                "responses": {
                    "200": {
                        "description": "Paginated set of `DepartmentResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/DepartmentResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "current_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "per_page": {
                                                    "type": "integer",
                                                    "description": "Number of items shown per page.",
                                                    "minimum": 0
                                                },
                                                "total": {
                                                    "type": "integer",
                                                    "description": "Total number of items being paginated.",
                                                    "minimum": 0
                                                },
                                                "last_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "current_page",
                                                "per_page",
                                                "total",
                                                "last_page",
                                                "request_id"
                                            ]
                                        },
                                        "links": {
                                            "type": "object",
                                            "properties": {
                                                "first": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "last": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "prev": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "next": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                }
                                            },
                                            "required": [
                                                "first",
                                                "last",
                                                "prev",
                                                "next"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta",
                                        "links"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            },
            "post": {
                "operationId": "v1.departments.store",
                "tags": [
                    "Department"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/DepartmentStoreRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "`DepartmentResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/DepartmentResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/departments\/{department}": {
            "get": {
                "operationId": "v1.departments.show",
                "tags": [
                    "Department"
                ],
                "parameters": [
                    {
                        "name": "department",
                        "in": "path",
                        "required": true,
                        "description": "The department ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "`DepartmentResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "allOf": [
                                                {
                                                    "$ref": "#\/components\/schemas\/DepartmentResource"
                                                },
                                                {
                                                    "type": "object",
                                                    "required": [
                                                        "parent"
                                                    ]
                                                }
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            },
            "patch": {
                "operationId": "v1.departments.update",
                "tags": [
                    "Department"
                ],
                "parameters": [
                    {
                        "name": "department",
                        "in": "path",
                        "required": true,
                        "description": "The department ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/DepartmentUpdateRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`DepartmentResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "allOf": [
                                                {
                                                    "$ref": "#\/components\/schemas\/DepartmentResource"
                                                },
                                                {
                                                    "type": "object",
                                                    "required": [
                                                        "parent"
                                                    ]
                                                }
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            },
            "delete": {
                "operationId": "v1.departments.destroy",
                "tags": [
                    "Department"
                ],
                "parameters": [
                    {
                        "name": "department",
                        "in": "path",
                        "required": true,
                        "description": "The department ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "No content"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/integration\/employees": {
            "get": {
                "operationId": "v1.integration.employees.index",
                "description": "Paginated employees of the key's company. Supports `filter[status]`, `filter[department_id]`,\n`filter[employment_type]`, `filter[hire_date_from]`, `filter[hire_date_to]`, `search`,\n`sort` (hire_date, last_name, display_name, employee_no), `page` and `per_page` (max 100).\n`include` is not supported.",
                "summary": "List employees",
                "tags": [
                    "Employee"
                ],
                "responses": {
                    "200": {
                        "description": "Paginated set of `IntegrationEmployeeResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/IntegrationEmployeeResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "current_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "per_page": {
                                                    "type": "integer",
                                                    "description": "Number of items shown per page.",
                                                    "minimum": 0
                                                },
                                                "total": {
                                                    "type": "integer",
                                                    "description": "Total number of items being paginated.",
                                                    "minimum": 0
                                                },
                                                "last_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "current_page",
                                                "per_page",
                                                "total",
                                                "last_page",
                                                "request_id"
                                            ]
                                        },
                                        "links": {
                                            "type": "object",
                                            "properties": {
                                                "first": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "last": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "prev": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "next": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                }
                                            },
                                            "required": [
                                                "first",
                                                "last",
                                                "prev",
                                                "next"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta",
                                        "links"
                                    ]
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "ApiKeyAuth": []
                    }
                ]
            }
        },
        "\/v1\/integration\/employees\/by-number\/{employeeNo}": {
            "get": {
                "operationId": "v1.integration.employees.show-by-number",
                "summary": "Get an employee by employee number",
                "tags": [
                    "Employee"
                ],
                "parameters": [
                    {
                        "name": "employeeNo",
                        "in": "path",
                        "required": true,
                        "description": "The employee's `employee_no`.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "`IntegrationEmployeeResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/IntegrationEmployeeResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "ApiKeyAuth": []
                    }
                ]
            }
        },
        "\/v1\/integration\/employees\/{employeeId}": {
            "get": {
                "operationId": "v1.integration.employees.show",
                "summary": "Get an employee by employee_id",
                "tags": [
                    "Employee"
                ],
                "parameters": [
                    {
                        "name": "employeeId",
                        "in": "path",
                        "required": true,
                        "description": "The employee's `id` (as returned by the list endpoint).",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "`IntegrationEmployeeResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/IntegrationEmployeeResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "ApiKeyAuth": []
                    }
                ]
            }
        },
        "\/v1\/employees": {
            "get": {
                "operationId": "v1.employees.index",
                "tags": [
                    "Employee"
                ],
                "responses": {
                    "200": {
                        "description": "Paginated set of `EmployeeResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/EmployeeResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "current_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "per_page": {
                                                    "type": "integer",
                                                    "description": "Number of items shown per page.",
                                                    "minimum": 0
                                                },
                                                "total": {
                                                    "type": "integer",
                                                    "description": "Total number of items being paginated.",
                                                    "minimum": 0
                                                },
                                                "last_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "current_page",
                                                "per_page",
                                                "total",
                                                "last_page",
                                                "request_id"
                                            ]
                                        },
                                        "links": {
                                            "type": "object",
                                            "properties": {
                                                "first": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "last": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "prev": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "next": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                }
                                            },
                                            "required": [
                                                "first",
                                                "last",
                                                "prev",
                                                "next"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta",
                                        "links"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            },
            "post": {
                "operationId": "v1.employees.store",
                "tags": [
                    "Employee"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeStoreRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "`EmployeeResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/employees\/search": {
            "get": {
                "operationId": "v1.employees.search",
                "summary": "doc 04 \u00a73.1: \"Typeahead, returns id\/name\/photo\/position only.\" `position` is omitted \u2014 no\n`positions` table exists yet (deliberately out of this plan's scope, see the plan's Context)",
                "tags": [
                    "Employee"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer"
                                                    },
                                                    "name": {
                                                        "type": "string"
                                                    },
                                                    "photo_path": {
                                                        "type": [
                                                            "string",
                                                            "null"
                                                        ]
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "name",
                                                    "photo_path"
                                                ]
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}": {
            "get": {
                "operationId": "v1.employees.show",
                "tags": [
                    "Employee"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "`EmployeeResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            },
            "patch": {
                "operationId": "v1.employees.update",
                "tags": [
                    "Employee"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeUpdateRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`EmployeeResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            },
            "delete": {
                "operationId": "v1.employees.destroy",
                "tags": [
                    "Employee"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "No content"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/timeline": {
            "get": {
                "operationId": "v1.employees.timeline",
                "summary": "doc 04 \u00a73.1: \"Merged history: assignments, compensation, discipline (permission-gated),\n     * training.\" v1 scope is assignment history only \u2014 the other domains don't have their own\nmodules built yet to contribute entries; this is an extension point, not the full doc shape",
                "tags": [
                    "Employee"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "type": {
                                                        "type": "string",
                                                        "const": "assignment"
                                                    },
                                                    "date": {
                                                        "type": "string"
                                                    },
                                                    "summary": {
                                                        "type": "string"
                                                    },
                                                    "data": {
                                                        "type": "array",
                                                        "items": {}
                                                    }
                                                },
                                                "required": [
                                                    "type",
                                                    "date",
                                                    "summary",
                                                    "data"
                                                ]
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/summary": {
            "get": {
                "operationId": "v1.employees.summary",
                "summary": "doc 04 \u00a73.1: \"Header card: status, tenure, manager, assets, open requests.\" v1 scope is\nstatus\/tenure\/manager \u2014 assets\/open-requests need modules that don't exist yet",
                "tags": [
                    "Employee"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "id": {
                                                    "type": "integer"
                                                },
                                                "status": {
                                                    "type": "string"
                                                },
                                                "tenure_months": {
                                                    "type": "number"
                                                },
                                                "department": {
                                                    "type": "string"
                                                },
                                                "manager": {
                                                    "type": [
                                                        "object",
                                                        "null"
                                                    ],
                                                    "properties": {
                                                        "id": {
                                                            "type": "integer"
                                                        },
                                                        "display_name": {
                                                            "type": "string"
                                                        }
                                                    },
                                                    "required": [
                                                        "id",
                                                        "display_name"
                                                    ]
                                                }
                                            },
                                            "required": [
                                                "id",
                                                "status",
                                                "tenure_months",
                                                "department",
                                                "manager"
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/acknowledgments": {
            "get": {
                "operationId": "v1.employees.acknowledgments.index",
                "tags": [
                    "EmployeeAcknowledgment"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Array of `EmployeeAcknowledgmentResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/EmployeeAcknowledgmentResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            },
            "post": {
                "operationId": "v1.employees.acknowledgments.store",
                "tags": [
                    "EmployeeAcknowledgment"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeAcknowledgmentStoreRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "`EmployeeAcknowledgmentResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeAcknowledgmentResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/addresses": {
            "get": {
                "operationId": "v1.employees.addresses.index",
                "tags": [
                    "EmployeeAddress"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Array of `EmployeeAddressResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/EmployeeAddressResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            },
            "post": {
                "operationId": "v1.employees.addresses.store",
                "tags": [
                    "EmployeeAddress"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeAddressStoreRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "`EmployeeAddressResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeAddressResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/addresses\/{address}": {
            "patch": {
                "operationId": "v1.employees.addresses.update",
                "tags": [
                    "EmployeeAddress"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "address",
                        "in": "path",
                        "required": true,
                        "description": "The address ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeAddressUpdateRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`EmployeeAddressResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeAddressResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            },
            "delete": {
                "operationId": "v1.employees.addresses.destroy",
                "tags": [
                    "EmployeeAddress"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "address",
                        "in": "path",
                        "required": true,
                        "description": "The address ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "No content"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/assignment-history": {
            "get": {
                "operationId": "v1.employees.assignment-history.index",
                "tags": [
                    "EmployeeAssignmentHistory"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Array of `EmployeeAssignmentHistoryResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/EmployeeAssignmentHistoryResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/bank-accounts": {
            "get": {
                "operationId": "v1.employees.bank-accounts.index",
                "tags": [
                    "EmployeeBankAccount"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Array of `EmployeeBankAccountResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/EmployeeBankAccountResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            },
            "post": {
                "operationId": "v1.employees.bank-accounts.store",
                "tags": [
                    "EmployeeBankAccount"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeBankAccountStoreRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "`EmployeeBankAccountResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeBankAccountResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/bank-accounts\/{bankAccount}": {
            "patch": {
                "operationId": "v1.employees.bank-accounts.update",
                "tags": [
                    "EmployeeBankAccount"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "bankAccount",
                        "in": "path",
                        "required": true,
                        "description": "The bank account ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeBankAccountUpdateRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`EmployeeBankAccountResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeBankAccountResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            },
            "delete": {
                "operationId": "v1.employees.bank-accounts.destroy",
                "tags": [
                    "EmployeeBankAccount"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "bankAccount",
                        "in": "path",
                        "required": true,
                        "description": "The bank account ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "No content"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/contracts": {
            "get": {
                "operationId": "v1.employees.contracts.index",
                "tags": [
                    "EmployeeContract"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Array of `EmployeeContractResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/EmployeeContractResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            },
            "post": {
                "operationId": "v1.employees.contracts.store",
                "tags": [
                    "EmployeeContract"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeContractStoreRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "`EmployeeContractResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeContractResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/contracts\/{contract}": {
            "patch": {
                "operationId": "v1.employees.contracts.update",
                "tags": [
                    "EmployeeContract"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "contract",
                        "in": "path",
                        "required": true,
                        "description": "The contract ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeContractUpdateRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`EmployeeContractResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeContractResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            },
            "delete": {
                "operationId": "v1.employees.contracts.destroy",
                "tags": [
                    "EmployeeContract"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "contract",
                        "in": "path",
                        "required": true,
                        "description": "The contract ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "No content"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/documents": {
            "get": {
                "operationId": "v1.employees.documents.index",
                "tags": [
                    "EmployeeDocument"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Array of `EmployeeDocumentResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/EmployeeDocumentResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            },
            "post": {
                "operationId": "v1.employees.documents.store",
                "tags": [
                    "EmployeeDocument"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeDocumentStoreRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "`EmployeeDocumentResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeDocumentResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/documents\/{document}": {
            "delete": {
                "operationId": "v1.employees.documents.destroy",
                "tags": [
                    "EmployeeDocument"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "document",
                        "in": "path",
                        "required": true,
                        "description": "The document ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "No content"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/emergency-contacts": {
            "get": {
                "operationId": "v1.employees.emergency-contacts.index",
                "tags": [
                    "EmployeeEmergencyContact"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Array of `EmployeeEmergencyContactResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/EmployeeEmergencyContactResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            },
            "post": {
                "operationId": "v1.employees.emergency-contacts.store",
                "tags": [
                    "EmployeeEmergencyContact"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeEmergencyContactStoreRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "`EmployeeEmergencyContactResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeEmergencyContactResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/emergency-contacts\/{emergencyContact}": {
            "patch": {
                "operationId": "v1.employees.emergency-contacts.update",
                "tags": [
                    "EmployeeEmergencyContact"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "emergencyContact",
                        "in": "path",
                        "required": true,
                        "description": "The emergency contact ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeEmergencyContactUpdateRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`EmployeeEmergencyContactResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeEmergencyContactResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            },
            "delete": {
                "operationId": "v1.employees.emergency-contacts.destroy",
                "tags": [
                    "EmployeeEmergencyContact"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "emergencyContact",
                        "in": "path",
                        "required": true,
                        "description": "The emergency contact ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "No content"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/employees\/export": {
            "get": {
                "operationId": "v1.employees.export.store",
                "tags": [
                    "EmployeeExport"
                ],
                "responses": {
                    "202": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "export_job_id": {
                                                    "type": "integer"
                                                }
                                            },
                                            "required": [
                                                "export_job_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/employees\/export\/{jobId}": {
            "get": {
                "operationId": "v1.employees.export.show",
                "summary": "Not in doc 04's letter (only the trigger endpoint is documented there) but necessary for a\nclient to know when the export is ready and where to fetch it \u2014 same progress-check shape as\nEmployeeImportController::show()",
                "tags": [
                    "EmployeeExport"
                ],
                "parameters": [
                    {
                        "name": "jobId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "id": {
                                                    "type": "integer"
                                                },
                                                "status": {
                                                    "type": "string"
                                                },
                                                "total_rows": {
                                                    "type": [
                                                        "integer",
                                                        "null"
                                                    ]
                                                },
                                                "result_available": {
                                                    "type": "boolean"
                                                }
                                            },
                                            "required": [
                                                "id",
                                                "status",
                                                "total_rows",
                                                "result_available"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/employees\/import": {
            "post": {
                "operationId": "v1.employees.import.store",
                "tags": [
                    "EmployeeImport"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "multipart\/form-data": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeImportRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "202": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "import_batch_id": {
                                                    "type": "integer"
                                                }
                                            },
                                            "required": [
                                                "import_batch_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data"
                                    ]
                                }
                            }
                        }
                    },
                    "200": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "total": {
                                                    "type": "integer"
                                                },
                                                "valid": {
                                                    "type": "integer"
                                                },
                                                "invalid": {
                                                    "type": "integer"
                                                },
                                                "errors": {
                                                    "type": "array",
                                                    "items": {
                                                        "type": "object",
                                                        "properties": {
                                                            "row": {
                                                                "type": "number"
                                                            },
                                                            "errors": {
                                                                "type": "object",
                                                                "additionalProperties": {
                                                                    "type": "array",
                                                                    "items": {
                                                                        "type": "string"
                                                                    }
                                                                }
                                                            }
                                                        },
                                                        "required": [
                                                            "row",
                                                            "errors"
                                                        ]
                                                    }
                                                }
                                            },
                                            "required": [
                                                "total",
                                                "valid",
                                                "invalid",
                                                "errors"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/employees\/import-masterlist": {
            "post": {
                "operationId": "v1.employees.import.store-masterlist",
                "summary": "Doc-04-style bulk import, but for \"HIS Global Business Inc. (Official Employee\n     * Masterlist).xlsx\"'s specific ACTIVE-sheet shape rather than the generic already-IDs CSV\n`store()` expects \u2014 see MasterlistRowMapper's class docblock for exactly what does and\ndoesn't carry over. Reuses the same `employee_bulk_operations` batch tracking and\n`GET \/employees\/import\/{id}` status endpoint as the CSV path",
                "tags": [
                    "EmployeeImport"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "multipart\/form-data": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeMasterlistImportRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "202": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "import_batch_id": {
                                                    "type": "integer"
                                                }
                                            },
                                            "required": [
                                                "import_batch_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data"
                                    ]
                                }
                            }
                        }
                    },
                    "200": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "total": {
                                                    "type": "integer"
                                                },
                                                "valid": {
                                                    "type": "integer"
                                                },
                                                "invalid": {
                                                    "type": "integer"
                                                },
                                                "errors": {
                                                    "type": "array",
                                                    "items": {
                                                        "type": "object",
                                                        "properties": {
                                                            "row": {
                                                                "type": "number"
                                                            },
                                                            "errors": {
                                                                "type": "array",
                                                                "items": {
                                                                    "anyOf": [
                                                                        {
                                                                            "type": "string"
                                                                        },
                                                                        {
                                                                            "type": "string",
                                                                            "enum": [
                                                                                "Missing Employee No.",
                                                                                "Missing First Name.",
                                                                                "Missing Last Name.",
                                                                                "Missing or unreadable Date Hired.",
                                                                                "Missing Department \/ MNLSSC Department \/ Team \u2014 cannot place this employee in the org chart."
                                                                            ]
                                                                        }
                                                                    ]
                                                                }
                                                            }
                                                        },
                                                        "required": [
                                                            "row",
                                                            "errors"
                                                        ]
                                                    }
                                                },
                                                "warnings": {
                                                    "type": "array",
                                                    "items": {
                                                        "type": "object",
                                                        "properties": {
                                                            "row": {
                                                                "type": "number"
                                                            },
                                                            "warnings": {
                                                                "type": "string"
                                                            }
                                                        },
                                                        "required": [
                                                            "row",
                                                            "warnings"
                                                        ]
                                                    }
                                                }
                                            },
                                            "required": [
                                                "total",
                                                "valid",
                                                "invalid",
                                                "errors",
                                                "warnings"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/employees\/import\/{batchId}": {
            "get": {
                "operationId": "v1.employees.import.show",
                "tags": [
                    "EmployeeImport"
                ],
                "parameters": [
                    {
                        "name": "batchId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "id": {
                                                    "type": "integer"
                                                },
                                                "status": {
                                                    "type": "string"
                                                },
                                                "total_rows": {
                                                    "type": [
                                                        "integer",
                                                        "null"
                                                    ]
                                                },
                                                "processed_rows": {
                                                    "type": "integer"
                                                },
                                                "error_count": {
                                                    "type": "integer"
                                                },
                                                "error_report_available": {
                                                    "type": "boolean"
                                                }
                                            },
                                            "required": [
                                                "id",
                                                "status",
                                                "total_rows",
                                                "processed_rows",
                                                "error_count",
                                                "error_report_available"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/internet-connections": {
            "get": {
                "operationId": "v1.employees.internet-connections.index",
                "tags": [
                    "EmployeeInternetConnection"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Array of `EmployeeInternetConnectionResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/EmployeeInternetConnectionResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            },
            "post": {
                "operationId": "v1.employees.internet-connections.store",
                "tags": [
                    "EmployeeInternetConnection"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeInternetConnectionStoreRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "`EmployeeInternetConnectionResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeInternetConnectionResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/internet-connections\/{internetConnection}": {
            "patch": {
                "operationId": "v1.employees.internet-connections.update",
                "tags": [
                    "EmployeeInternetConnection"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "internetConnection",
                        "in": "path",
                        "required": true,
                        "description": "The internet connection ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeInternetConnectionUpdateRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`EmployeeInternetConnectionResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeInternetConnectionResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            },
            "delete": {
                "operationId": "v1.employees.internet-connections.destroy",
                "tags": [
                    "EmployeeInternetConnection"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "internetConnection",
                        "in": "path",
                        "required": true,
                        "description": "The internet connection ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "No content"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/languages": {
            "get": {
                "operationId": "v1.employees.languages.index",
                "tags": [
                    "EmployeeLanguage"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Array of `EmployeeLanguageResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/EmployeeLanguageResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            },
            "post": {
                "operationId": "v1.employees.languages.store",
                "tags": [
                    "EmployeeLanguage"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeLanguageStoreRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "`EmployeeLanguageResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeLanguageResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/languages\/{language}": {
            "patch": {
                "operationId": "v1.employees.languages.update",
                "tags": [
                    "EmployeeLanguage"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "language",
                        "in": "path",
                        "required": true,
                        "description": "The language ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeLanguageUpdateRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`EmployeeLanguageResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeLanguageResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            },
            "delete": {
                "operationId": "v1.employees.languages.destroy",
                "tags": [
                    "EmployeeLanguage"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "language",
                        "in": "path",
                        "required": true,
                        "description": "The language ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "No content"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/personal-details": {
            "get": {
                "operationId": "v1.employees.personal-details.show",
                "tags": [
                    "EmployeePersonalDetails"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "`EmployeePersonalDetailsResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeePersonalDetailsResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            },
            "patch": {
                "operationId": "v1.employees.personal-details.update",
                "tags": [
                    "EmployeePersonalDetails"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeePersonalDetailsUpdateRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`EmployeePersonalDetailsResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeePersonalDetailsResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/employee-schedules": {
            "get": {
                "operationId": "v1.employee-schedules.index",
                "tags": [
                    "EmployeeSchedule"
                ],
                "parameters": [
                    {
                        "name": "from",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        }
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        }
                    },
                    {
                        "name": "employee_id",
                        "in": "query",
                        "schema": {
                            "type": [
                                "integer",
                                "null"
                            ]
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Array of `EmployeeScheduleResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "allOf": [
                                                    {
                                                        "$ref": "#\/components\/schemas\/EmployeeScheduleResource"
                                                    },
                                                    {
                                                        "type": "object",
                                                        "required": [
                                                            "work_shift"
                                                        ]
                                                    }
                                                ]
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            },
            "put": {
                "operationId": "v1.employee-schedules.sync",
                "tags": [
                    "EmployeeSchedule"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeScheduleSyncRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Array of `EmployeeScheduleResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/EmployeeScheduleResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/employee-schedules\/my": {
            "get": {
                "operationId": "v1.employee-schedules.my",
                "summary": "`GET \/employee-schedules\/my` \u2014 the caller's own schedule for a date range (default: next 14 days)",
                "tags": [
                    "EmployeeSchedule"
                ],
                "parameters": [
                    {
                        "name": "from",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Array of `EmployeeScheduleResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "allOf": [
                                                    {
                                                        "$ref": "#\/components\/schemas\/EmployeeScheduleResource"
                                                    },
                                                    {
                                                        "type": "object",
                                                        "required": [
                                                            "work_shift"
                                                        ]
                                                    }
                                                ]
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "An error",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "message": {
                                            "type": "string",
                                            "description": "Error overview.",
                                            "examples": [
                                                ""
                                            ]
                                        }
                                    },
                                    "required": [
                                        "message"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/employee-schedules\/import": {
            "post": {
                "operationId": "v1.employee-schedules.import",
                "summary": "`POST \/employee-schedules\/import` \u2014 the HRIS schedule workbook (see ScheduleWorkbookImporter).\n`dry_run` returns the same summary without writing, so HR can check unmatched employees and\nunknown shift codes first",
                "tags": [
                    "EmployeeSchedule"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "multipart\/form-data": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeScheduleImportRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "sheets": {
                                                    "type": "array",
                                                    "items": {}
                                                },
                                                "months": {
                                                    "type": "array",
                                                    "items": {}
                                                },
                                                "employees_matched": {
                                                    "type": "integer"
                                                },
                                                "employees_unmatched": {
                                                    "type": "array",
                                                    "items": {
                                                        "type": "object",
                                                        "properties": {
                                                            "employee_no": {
                                                                "type": "string"
                                                            },
                                                            "name": {
                                                                "type": "string"
                                                            }
                                                        },
                                                        "required": [
                                                            "employee_no",
                                                            "name"
                                                        ]
                                                    }
                                                },
                                                "days": {
                                                    "type": "integer"
                                                },
                                                "rest_days": {
                                                    "type": "integer",
                                                    "minimum": 0
                                                },
                                                "unknown_shift_codes": {
                                                    "type": "array",
                                                    "items": {}
                                                },
                                                "imported": {
                                                    "type": "integer"
                                                }
                                            },
                                            "required": [
                                                "sheets",
                                                "months",
                                                "employees_matched",
                                                "employees_unmatched",
                                                "days",
                                                "rest_days",
                                                "unknown_shift_codes",
                                                "imported"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/employees\/me": {
            "get": {
                "operationId": "v1.employees.me.show",
                "tags": [
                    "EmployeeSelf"
                ],
                "responses": {
                    "200": {
                        "description": "`EmployeeResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "allOf": [
                                                {
                                                    "$ref": "#\/components\/schemas\/EmployeeResource"
                                                },
                                                {
                                                    "type": "object",
                                                    "required": [
                                                        "department",
                                                        "employment_type",
                                                        "work_arrangement",
                                                        "supervisor_employee_id",
                                                        "job_function",
                                                        "personal_details"
                                                    ]
                                                }
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            },
            "patch": {
                "operationId": "v1.employees.me.update",
                "tags": [
                    "EmployeeSelf"
                ],
                "requestBody": {
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeSelfUpdateRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`EmployeeResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/statutory-ids": {
            "get": {
                "operationId": "v1.employees.statutory-ids.index",
                "tags": [
                    "EmployeeStatutoryId"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Array of `EmployeeStatutoryIdResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/EmployeeStatutoryIdResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            },
            "post": {
                "operationId": "v1.employees.statutory-ids.store",
                "tags": [
                    "EmployeeStatutoryId"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeStatutoryIdStoreRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "`EmployeeStatutoryIdResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeStatutoryIdResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/statutory-ids\/{statutoryId}": {
            "patch": {
                "operationId": "v1.employees.statutory-ids.update",
                "tags": [
                    "EmployeeStatutoryId"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "statutoryId",
                        "in": "path",
                        "required": true,
                        "description": "The statutory id ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeStatutoryIdUpdateRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`EmployeeStatutoryIdResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeStatutoryIdResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            },
            "delete": {
                "operationId": "v1.employees.statutory-ids.destroy",
                "tags": [
                    "EmployeeStatutoryId"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "statutoryId",
                        "in": "path",
                        "required": true,
                        "description": "The statutory id ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "No content"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/visas": {
            "get": {
                "operationId": "v1.employees.visas.index",
                "tags": [
                    "EmployeeVisa"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Array of `EmployeeVisaResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/EmployeeVisaResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            },
            "post": {
                "operationId": "v1.employees.visas.store",
                "tags": [
                    "EmployeeVisa"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeVisaStoreRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "`EmployeeVisaResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeVisaResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/employees\/{employee}\/visas\/{visa}": {
            "patch": {
                "operationId": "v1.employees.visas.update",
                "tags": [
                    "EmployeeVisa"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "visa",
                        "in": "path",
                        "required": true,
                        "description": "The visa ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/EmployeeVisaUpdateRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`EmployeeVisaResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/EmployeeVisaResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            },
            "delete": {
                "operationId": "v1.employees.visas.destroy",
                "tags": [
                    "EmployeeVisa"
                ],
                "parameters": [
                    {
                        "name": "employee",
                        "in": "path",
                        "required": true,
                        "description": "The employee ID",
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "visa",
                        "in": "path",
                        "required": true,
                        "description": "The visa ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "No content"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/holidays": {
            "get": {
                "operationId": "v1.holidays.index",
                "tags": [
                    "Holiday"
                ],
                "parameters": [
                    {
                        "name": "year",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Array of `HolidayResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/HolidayResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/leave-balances": {
            "get": {
                "operationId": "v1.leave-balances.index",
                "tags": [
                    "LeaveBalance"
                ],
                "parameters": [
                    {
                        "name": "employee_id",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "year",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Array of `LeaveBalanceResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "allOf": [
                                                    {
                                                        "$ref": "#\/components\/schemas\/LeaveBalanceResource"
                                                    },
                                                    {
                                                        "type": "object",
                                                        "required": [
                                                            "leave_type"
                                                        ]
                                                    }
                                                ]
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/leave-balances\/adjust": {
            "post": {
                "operationId": "v1.leave-balances.adjust",
                "tags": [
                    "LeaveBalance"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/LeaveBalanceAdjustRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`LeaveBalanceResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "allOf": [
                                                {
                                                    "$ref": "#\/components\/schemas\/LeaveBalanceResource"
                                                },
                                                {
                                                    "type": "object",
                                                    "required": [
                                                        "leave_type"
                                                    ]
                                                }
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/leave-balances\/accrue": {
            "post": {
                "operationId": "v1.leave-balances.accrue",
                "tags": [
                    "LeaveBalance"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/LeaveBalanceAccrueRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "balances_updated": {
                                                    "type": "integer"
                                                }
                                            },
                                            "required": [
                                                "balances_updated"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/leave-requests": {
            "get": {
                "operationId": "v1.leave-requests.index",
                "tags": [
                    "LeaveRequest"
                ],
                "responses": {
                    "200": {
                        "description": "Paginated set of `LeaveRequestResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/LeaveRequestResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "current_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "per_page": {
                                                    "type": "integer",
                                                    "description": "Number of items shown per page.",
                                                    "minimum": 0
                                                },
                                                "total": {
                                                    "type": "integer",
                                                    "description": "Total number of items being paginated.",
                                                    "minimum": 0
                                                },
                                                "last_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "current_page",
                                                "per_page",
                                                "total",
                                                "last_page",
                                                "request_id"
                                            ]
                                        },
                                        "links": {
                                            "type": "object",
                                            "properties": {
                                                "first": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "last": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "prev": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "next": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                }
                                            },
                                            "required": [
                                                "first",
                                                "last",
                                                "prev",
                                                "next"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta",
                                        "links"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            },
            "post": {
                "operationId": "v1.leave-requests.store",
                "tags": [
                    "LeaveRequest"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/LeaveRequestStoreRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "`LeaveRequestResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "allOf": [
                                                {
                                                    "$ref": "#\/components\/schemas\/LeaveRequestResource"
                                                },
                                                {
                                                    "type": "object",
                                                    "required": [
                                                        "employee",
                                                        "leave_type"
                                                    ]
                                                }
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/leave-requests\/calendar": {
            "get": {
                "operationId": "v1.leave-requests.calendar",
                "tags": [
                    "LeaveRequest"
                ],
                "parameters": [
                    {
                        "name": "month",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "department_id",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "type": "array",
                                                "items": {}
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/leave-requests\/validate": {
            "get": {
                "operationId": "v1.leave-requests.validate",
                "summary": "Doc 04 \u00a73.4's example response \u2014 `approval_chain` is a simplification of the doc's example\n(step *names* from the seeded definition, not individually-resolved approver people): a full\ndry-run resolution would need `WorkflowEngine`'s private resolution methods reworked to run\nagainst un-persisted input, which is a larger change than this preview endpoint justifies on\nits own",
                "tags": [
                    "LeaveRequest"
                ],
                "parameters": [
                    {
                        "name": "employee_id",
                        "in": "query",
                        "schema": {
                            "type": [
                                "integer",
                                "null"
                            ]
                        }
                    },
                    {
                        "name": "leave_type_id",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "name": "start_date",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        }
                    },
                    {
                        "name": "end_date",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "valid": {
                                                    "type": "boolean"
                                                },
                                                "total_days": {
                                                    "type": "number"
                                                },
                                                "working_days": {
                                                    "type": "number"
                                                },
                                                "excluded_dates": {
                                                    "type": "array",
                                                    "items": {
                                                        "type": "string"
                                                    }
                                                },
                                                "balance_before": {
                                                    "type": "number"
                                                },
                                                "balance_after": {
                                                    "type": [
                                                        "string",
                                                        "number"
                                                    ]
                                                },
                                                "warnings": {
                                                    "type": "array",
                                                    "items": {
                                                        "anyOf": [
                                                            {
                                                                "type": "string"
                                                            },
                                                            {
                                                                "type": "string",
                                                                "enum": [
                                                                    "Insufficient leave balance for the selected dates."
                                                                ]
                                                            }
                                                        ]
                                                    }
                                                },
                                                "requires_attachment": {
                                                    "type": "string"
                                                },
                                                "approval_chain": {
                                                    "type": "array",
                                                    "items": {
                                                        "type": "object",
                                                        "properties": {
                                                            "step": {
                                                                "type": "integer"
                                                            },
                                                            "approver": {
                                                                "type": "string"
                                                            }
                                                        },
                                                        "required": [
                                                            "step",
                                                            "approver"
                                                        ]
                                                    }
                                                }
                                            },
                                            "required": [
                                                "valid",
                                                "total_days",
                                                "working_days",
                                                "excluded_dates",
                                                "balance_before",
                                                "balance_after",
                                                "warnings",
                                                "requires_attachment",
                                                "approval_chain"
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/leave-requests\/{leaveRequest}": {
            "get": {
                "operationId": "v1.leave-requests.show",
                "tags": [
                    "LeaveRequest"
                ],
                "parameters": [
                    {
                        "name": "leaveRequest",
                        "in": "path",
                        "required": true,
                        "description": "The leave request ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "`LeaveRequestResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "allOf": [
                                                {
                                                    "$ref": "#\/components\/schemas\/LeaveRequestResource"
                                                },
                                                {
                                                    "type": "object",
                                                    "required": [
                                                        "employee",
                                                        "leave_type",
                                                        "reliever_employee"
                                                    ]
                                                }
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/leave-requests\/{leaveRequest}\/cancel": {
            "post": {
                "operationId": "v1.leave-requests.cancel",
                "tags": [
                    "LeaveRequest"
                ],
                "parameters": [
                    {
                        "name": "leaveRequest",
                        "in": "path",
                        "required": true,
                        "description": "The leave request ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "`LeaveRequestResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "allOf": [
                                                {
                                                    "$ref": "#\/components\/schemas\/LeaveRequestResource"
                                                },
                                                {
                                                    "type": "object",
                                                    "required": [
                                                        "employee",
                                                        "leave_type"
                                                    ]
                                                }
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/leave-types": {
            "get": {
                "operationId": "v1.leave-types.index",
                "tags": [
                    "LeaveType"
                ],
                "responses": {
                    "200": {
                        "description": "Array of `LeaveTypeResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/LeaveTypeResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            },
            "post": {
                "operationId": "v1.leave-types.store",
                "tags": [
                    "LeaveType"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/LeaveTypeStoreRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "`LeaveTypeResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/LeaveTypeResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/leave-types\/{leaveType}": {
            "patch": {
                "operationId": "v1.leave-types.update",
                "tags": [
                    "LeaveType"
                ],
                "parameters": [
                    {
                        "name": "leaveType",
                        "in": "path",
                        "required": true,
                        "description": "The leave type ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/LeaveTypeUpdateRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`LeaveTypeResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/LeaveTypeResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            },
            "delete": {
                "operationId": "v1.leave-types.destroy",
                "tags": [
                    "LeaveType"
                ],
                "parameters": [
                    {
                        "name": "leaveType",
                        "in": "path",
                        "required": true,
                        "description": "The leave type ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "No content"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/overtime-requests": {
            "get": {
                "operationId": "v1.overtime-requests.index",
                "tags": [
                    "OvertimeRequest"
                ],
                "responses": {
                    "200": {
                        "description": "Paginated set of `OvertimeRequestResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/OvertimeRequestResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "current_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "per_page": {
                                                    "type": "integer",
                                                    "description": "Number of items shown per page.",
                                                    "minimum": 0
                                                },
                                                "total": {
                                                    "type": "integer",
                                                    "description": "Total number of items being paginated.",
                                                    "minimum": 0
                                                },
                                                "last_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "current_page",
                                                "per_page",
                                                "total",
                                                "last_page",
                                                "request_id"
                                            ]
                                        },
                                        "links": {
                                            "type": "object",
                                            "properties": {
                                                "first": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "last": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "prev": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "next": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                }
                                            },
                                            "required": [
                                                "first",
                                                "last",
                                                "prev",
                                                "next"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta",
                                        "links"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            },
            "post": {
                "operationId": "v1.overtime-requests.store",
                "tags": [
                    "OvertimeRequest"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/OvertimeRequestStoreRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "`OvertimeRequestResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "allOf": [
                                                {
                                                    "$ref": "#\/components\/schemas\/OvertimeRequestResource"
                                                },
                                                {
                                                    "type": "object",
                                                    "required": [
                                                        "employee"
                                                    ]
                                                }
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/requests": {
            "get": {
                "operationId": "v1.requests.index",
                "tags": [
                    "Request"
                ],
                "responses": {
                    "200": {
                        "description": "Paginated set of `RequestResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/RequestResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "current_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "per_page": {
                                                    "type": "integer",
                                                    "description": "Number of items shown per page.",
                                                    "minimum": 0
                                                },
                                                "total": {
                                                    "type": "integer",
                                                    "description": "Total number of items being paginated.",
                                                    "minimum": 0
                                                },
                                                "last_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "current_page",
                                                "per_page",
                                                "total",
                                                "last_page",
                                                "request_id"
                                            ]
                                        },
                                        "links": {
                                            "type": "object",
                                            "properties": {
                                                "first": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "last": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "prev": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "next": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                }
                                            },
                                            "required": [
                                                "first",
                                                "last",
                                                "prev",
                                                "next"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta",
                                        "links"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            },
            "post": {
                "operationId": "v1.requests.store",
                "tags": [
                    "Request"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/RequestStoreRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "`RequestResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/RequestResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/requests\/my-requests": {
            "get": {
                "operationId": "v1.requests.my-requests",
                "tags": [
                    "Request"
                ],
                "responses": {
                    "200": {
                        "description": "Paginated set of `RequestResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "allOf": [
                                                    {
                                                        "$ref": "#\/components\/schemas\/RequestResource"
                                                    },
                                                    {
                                                        "type": "object",
                                                        "required": [
                                                            "request_type",
                                                            "subject_employee"
                                                        ]
                                                    }
                                                ]
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "current_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "per_page": {
                                                    "type": "integer",
                                                    "description": "Number of items shown per page.",
                                                    "minimum": 0
                                                },
                                                "total": {
                                                    "type": "integer",
                                                    "description": "Total number of items being paginated.",
                                                    "minimum": 0
                                                },
                                                "last_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "current_page",
                                                "per_page",
                                                "total",
                                                "last_page",
                                                "request_id"
                                            ]
                                        },
                                        "links": {
                                            "type": "object",
                                            "properties": {
                                                "first": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "last": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "prev": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "next": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                }
                                            },
                                            "required": [
                                                "first",
                                                "last",
                                                "prev",
                                                "next"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta",
                                        "links"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/requests\/my-approvals": {
            "get": {
                "operationId": "v1.requests.my-approvals",
                "tags": [
                    "Request"
                ],
                "responses": {
                    "200": {
                        "description": "Paginated set of `RequestResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "allOf": [
                                                    {
                                                        "$ref": "#\/components\/schemas\/RequestResource"
                                                    },
                                                    {
                                                        "type": "object",
                                                        "required": [
                                                            "request_type",
                                                            "requester",
                                                            "subject_employee",
                                                            "approvals"
                                                        ]
                                                    }
                                                ]
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "current_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "per_page": {
                                                    "type": "integer",
                                                    "description": "Number of items shown per page.",
                                                    "minimum": 0
                                                },
                                                "total": {
                                                    "type": "integer",
                                                    "description": "Total number of items being paginated.",
                                                    "minimum": 0
                                                },
                                                "last_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "current_page",
                                                "per_page",
                                                "total",
                                                "last_page",
                                                "request_id"
                                            ]
                                        },
                                        "links": {
                                            "type": "object",
                                            "properties": {
                                                "first": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "last": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "prev": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "next": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                }
                                            },
                                            "required": [
                                                "first",
                                                "last",
                                                "prev",
                                                "next"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta",
                                        "links"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/requests\/my-approvals\/count": {
            "get": {
                "operationId": "v1.requests.my-approvals.count",
                "tags": [
                    "Request"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "count": {
                                                    "type": "integer",
                                                    "minimum": 0
                                                }
                                            },
                                            "required": [
                                                "count"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/requests\/{request}": {
            "get": {
                "operationId": "v1.requests.show",
                "tags": [
                    "Request"
                ],
                "parameters": [
                    {
                        "name": "request",
                        "in": "path",
                        "required": true,
                        "description": "The request ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "`RequestResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "allOf": [
                                                {
                                                    "$ref": "#\/components\/schemas\/RequestResource"
                                                },
                                                {
                                                    "type": "object",
                                                    "required": [
                                                        "request_type",
                                                        "requester",
                                                        "subject_employee",
                                                        "approvals"
                                                    ]
                                                }
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/requests\/{request}\/approve": {
            "post": {
                "operationId": "v1.requests.approve",
                "tags": [
                    "Request"
                ],
                "parameters": [
                    {
                        "name": "request",
                        "in": "path",
                        "required": true,
                        "description": "The request ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/RequestApproveRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`RequestResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/RequestResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/requests\/{request}\/reject": {
            "post": {
                "operationId": "v1.requests.reject",
                "tags": [
                    "Request"
                ],
                "parameters": [
                    {
                        "name": "request",
                        "in": "path",
                        "required": true,
                        "description": "The request ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/RequestRejectRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`RequestResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/RequestResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/requests\/{request}\/return": {
            "post": {
                "operationId": "v1.requests.return",
                "tags": [
                    "Request"
                ],
                "parameters": [
                    {
                        "name": "request",
                        "in": "path",
                        "required": true,
                        "description": "The request ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/RequestReturnRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`RequestResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/RequestResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/requests\/{request}\/cancel": {
            "post": {
                "operationId": "v1.requests.cancel",
                "tags": [
                    "Request"
                ],
                "parameters": [
                    {
                        "name": "request",
                        "in": "path",
                        "required": true,
                        "description": "The request ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "`RequestResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/RequestResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/requests\/{request}\/reassign": {
            "post": {
                "operationId": "v1.requests.reassign",
                "tags": [
                    "Request"
                ],
                "parameters": [
                    {
                        "name": "request",
                        "in": "path",
                        "required": true,
                        "description": "The request ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/RequestReassignRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`RequestApprovalResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/RequestApprovalResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/requests\/{request}\/approvals": {
            "get": {
                "operationId": "v1.requests.approvals",
                "tags": [
                    "Request"
                ],
                "parameters": [
                    {
                        "name": "request",
                        "in": "path",
                        "required": true,
                        "description": "The request ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Array of `RequestApprovalResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/RequestApprovalResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/request-types": {
            "get": {
                "operationId": "v1.request-types.index",
                "tags": [
                    "RequestType"
                ],
                "responses": {
                    "200": {
                        "description": "Array of `RequestTypeResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/RequestTypeResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/request-types\/{code}\/schema": {
            "get": {
                "operationId": "v1.request-types.schema",
                "tags": [
                    "RequestType"
                ],
                "parameters": [
                    {
                        "name": "code",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "code": {
                                                    "type": "string"
                                                },
                                                "name": {
                                                    "type": "string"
                                                },
                                                "requires_effective_date": {
                                                    "type": "boolean"
                                                },
                                                "allows_attachment": {
                                                    "type": "boolean"
                                                },
                                                "is_submittable": {
                                                    "type": "boolean"
                                                },
                                                "payload_schema": {
                                                    "type": "object",
                                                    "additionalProperties": {}
                                                }
                                            },
                                            "required": [
                                                "code",
                                                "name",
                                                "requires_effective_date",
                                                "allows_attachment",
                                                "is_submittable",
                                                "payload_schema"
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/roles": {
            "get": {
                "operationId": "v1.roles.index",
                "tags": [
                    "Role"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/Role"
                                            }
                                        }
                                    },
                                    "required": [
                                        "data"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/uploads\/presign": {
            "post": {
                "operationId": "v1.uploads.presign",
                "tags": [
                    "Upload"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/PresignUploadRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "upload_url": {
                                            "type": "string"
                                        },
                                        "upload_id": {
                                            "type": "string"
                                        },
                                        "expires_at": {
                                            "type": "string"
                                        },
                                        "required_headers": {
                                            "type": "string"
                                        }
                                    },
                                    "required": [
                                        "upload_url",
                                        "upload_id",
                                        "expires_at",
                                        "required_headers"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/uploads\/{uploadId}": {
            "put": {
                "operationId": "v1.uploads.receive",
                "summary": "Step 2's local-disk fallback for environments with no real S3 (`UploadPresigner::presign()`\nonly ever hands out this URL in that case \u2014 a real S3 presigned PUT never reaches this app\nat all, it goes straight to the bucket). The uploader already authenticated at step 1;\n`receive()` just needs to recognize the `upload_id` it handed out, not re-check permissions\nagainst a resource this endpoint doesn't know about yet (that's step 3's job)",
                "tags": [
                    "Upload"
                ],
                "parameters": [
                    {
                        "name": "uploadId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "No content"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/users": {
            "get": {
                "operationId": "v1.users.index",
                "tags": [
                    "User"
                ],
                "responses": {
                    "200": {
                        "description": "Paginated set of `App.Http.Resources.User.UserResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/App.Http.Resources.User.UserResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "current_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "per_page": {
                                                    "type": "integer",
                                                    "description": "Number of items shown per page.",
                                                    "minimum": 0
                                                },
                                                "total": {
                                                    "type": "integer",
                                                    "description": "Total number of items being paginated.",
                                                    "minimum": 0
                                                },
                                                "last_page": {
                                                    "type": "integer",
                                                    "minimum": 1
                                                },
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "current_page",
                                                "per_page",
                                                "total",
                                                "last_page",
                                                "request_id"
                                            ]
                                        },
                                        "links": {
                                            "type": "object",
                                            "properties": {
                                                "first": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "last": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "prev": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                },
                                                "next": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ]
                                                }
                                            },
                                            "required": [
                                                "first",
                                                "last",
                                                "prev",
                                                "next"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta",
                                        "links"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            },
            "post": {
                "operationId": "v1.users.store",
                "tags": [
                    "User"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/UserStoreRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "`App.Http.Resources.User.UserResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "allOf": [
                                                {
                                                    "$ref": "#\/components\/schemas\/App.Http.Resources.User.UserResource"
                                                },
                                                {
                                                    "type": "object",
                                                    "required": [
                                                        "company",
                                                        "roles"
                                                    ]
                                                }
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        },
        "\/v1\/users\/{user}": {
            "get": {
                "operationId": "v1.users.show",
                "tags": [
                    "User"
                ],
                "parameters": [
                    {
                        "name": "user",
                        "in": "path",
                        "required": true,
                        "description": "The user ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "`App.Http.Resources.User.UserResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "allOf": [
                                                {
                                                    "$ref": "#\/components\/schemas\/App.Http.Resources.User.UserResource"
                                                },
                                                {
                                                    "type": "object",
                                                    "required": [
                                                        "company",
                                                        "roles"
                                                    ]
                                                }
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            },
            "patch": {
                "operationId": "v1.users.update",
                "tags": [
                    "User"
                ],
                "parameters": [
                    {
                        "name": "user",
                        "in": "path",
                        "required": true,
                        "description": "The user ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/UserUpdateRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`App.Http.Resources.User.UserResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "allOf": [
                                                {
                                                    "$ref": "#\/components\/schemas\/App.Http.Resources.User.UserResource"
                                                },
                                                {
                                                    "type": "object",
                                                    "required": [
                                                        "company",
                                                        "roles"
                                                    ]
                                                }
                                            ]
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    }
                }
            },
            "delete": {
                "operationId": "v1.users.destroy",
                "tags": [
                    "User"
                ],
                "parameters": [
                    {
                        "name": "user",
                        "in": "path",
                        "required": true,
                        "description": "The user ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "No content"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/work-shifts": {
            "get": {
                "operationId": "v1.work-shifts.index",
                "tags": [
                    "WorkShift"
                ],
                "responses": {
                    "200": {
                        "description": "Array of `WorkShiftResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#\/components\/schemas\/WorkShiftResource"
                                            }
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/request-types\/{code}\/workflow-steps": {
            "get": {
                "operationId": "v1.workflow-steps.index",
                "tags": [
                    "WorkflowStep"
                ],
                "parameters": [
                    {
                        "name": "code",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "roles": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer"
                                                    },
                                                    "name": {
                                                        "type": "string"
                                                    }
                                                },
                                                "required": [
                                                    "id",
                                                    "name"
                                                ]
                                            }
                                        }
                                    },
                                    "required": [
                                        "roles"
                                    ],
                                    "additionalProperties": {}
                                }
                            }
                        }
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    }
                }
            }
        },
        "\/v1\/workflow-steps\/{step}": {
            "patch": {
                "operationId": "v1.workflow-steps.update",
                "tags": [
                    "WorkflowStep"
                ],
                "parameters": [
                    {
                        "name": "step",
                        "in": "path",
                        "required": true,
                        "description": "The step ID",
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application\/json": {
                            "schema": {
                                "$ref": "#\/components\/schemas\/WorkflowStepUpdateRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "`WorkflowStepResource`",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#\/components\/schemas\/WorkflowStepResource"
                                        },
                                        "meta": {
                                            "type": "object",
                                            "properties": {
                                                "request_id": {
                                                    "type": "string"
                                                }
                                            },
                                            "required": [
                                                "request_id"
                                            ]
                                        }
                                    },
                                    "required": [
                                        "data",
                                        "meta"
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "$ref": "#\/components\/responses\/ModelNotFoundException"
                    },
                    "401": {
                        "$ref": "#\/components\/responses\/AuthenticationException"
                    },
                    "422": {
                        "$ref": "#\/components\/responses\/ValidationException"
                    },
                    "403": {
                        "$ref": "#\/components\/responses\/AuthorizationException"
                    }
                }
            }
        }
    },
    "components": {
        "securitySchemes": {
            "ApiKeyAuth": {
                "type": "apiKey",
                "description": "API key created under API Keys in the admin UI (`hcm_live_...`). `Authorization: Bearer <key>` is also accepted.",
                "in": "header",
                "name": "X-API-Key"
            }
        },
        "schemas": {
            "ApiKeyResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "name": {
                        "type": "string"
                    },
                    "key_prefix": {
                        "type": "string"
                    },
                    "key": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "scopes": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "allowed_ips": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "status": {
                        "type": "string"
                    },
                    "company": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "name": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "id",
                            "name"
                        ]
                    },
                    "created_by": {
                        "type": "string"
                    },
                    "expires_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "last_used_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "last_used_ip": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "revoked_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "name",
                    "key_prefix",
                    "scopes",
                    "allowed_ips",
                    "status",
                    "expires_at",
                    "last_used_at",
                    "last_used_ip",
                    "revoked_at",
                    "created_at"
                ],
                "title": "ApiKeyResource"
            },
            "ApiKeyStoreRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 100
                    },
                    "company_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "scopes": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "enum": [
                                "employees:read"
                            ]
                        },
                        "minItems": 1,
                        "uniqueItems": true
                    },
                    "allowed_ips": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "expires_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    }
                },
                "required": [
                    "name",
                    "scopes"
                ],
                "title": "ApiKeyStoreRequest"
            },
            "ApiKeyUpdateRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 100
                    },
                    "scopes": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "enum": [
                                "employees:read"
                            ]
                        },
                        "minItems": 1,
                        "uniqueItems": true
                    },
                    "allowed_ips": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "expires_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "null clears the expiry (key never expires); a date must be in the future."
                    }
                },
                "title": "ApiKeyUpdateRequest"
            },
            "App.Http.Resources.User.UserResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "name": {
                        "type": "string"
                    },
                    "email": {
                        "type": "string"
                    },
                    "avatar_url": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "status": {
                        "type": "string"
                    },
                    "has_google_account": {
                        "type": "boolean"
                    },
                    "company": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "name": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "id",
                            "name"
                        ]
                    },
                    "employee_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "roles": {
                        "type": "string"
                    },
                    "last_login_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "updated_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "name",
                    "email",
                    "avatar_url",
                    "status",
                    "has_google_account",
                    "employee_id",
                    "last_login_at",
                    "created_at",
                    "updated_at"
                ],
                "title": "App.Http.Resources.User.UserResource"
            },
            "ApprovalDelegationResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "delegate": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "name": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "id",
                            "name"
                        ]
                    },
                    "request_type_ids": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "integer"
                        }
                    },
                    "valid_from": {
                        "type": "string"
                    },
                    "valid_to": {
                        "type": "string"
                    },
                    "reason": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "is_active": {
                        "type": "boolean"
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "request_type_ids",
                    "valid_from",
                    "valid_to",
                    "reason",
                    "is_active",
                    "created_at"
                ],
                "title": "ApprovalDelegationResource"
            },
            "ApprovalDelegationStoreRequest": {
                "type": "object",
                "properties": {
                    "delegate_user_id": {
                        "type": "integer"
                    },
                    "request_type_ids": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "integer"
                        }
                    },
                    "valid_from": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "valid_to": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "reason": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255
                    }
                },
                "required": [
                    "delegate_user_id",
                    "valid_from",
                    "valid_to"
                ],
                "title": "ApprovalDelegationStoreRequest"
            },
            "AttendanceRecordResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "employee": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "display_name": {
                                "type": "string"
                            },
                            "department": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "id",
                            "display_name",
                            "department"
                        ]
                    },
                    "work_date": {
                        "type": "string"
                    },
                    "time_in": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "time_out": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "worked_hours": {
                        "type": "number"
                    },
                    "late_minutes": {
                        "type": "integer"
                    },
                    "undertime_minutes": {
                        "type": "integer"
                    },
                    "overtime_minutes": {
                        "type": "integer"
                    },
                    "status": {
                        "type": "string"
                    },
                    "source": {
                        "type": "string"
                    },
                    "is_manually_adjusted": {
                        "type": "boolean"
                    }
                },
                "required": [
                    "id",
                    "work_date",
                    "time_in",
                    "time_out",
                    "worked_hours",
                    "late_minutes",
                    "undertime_minutes",
                    "overtime_minutes",
                    "status",
                    "source",
                    "is_manually_adjusted"
                ],
                "title": "AttendanceRecordResource"
            },
            "CompanyResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "code": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "legal_name": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "tin": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "address": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "country_code": {
                        "type": "string"
                    },
                    "timezone": {
                        "type": "string"
                    },
                    "currency": {
                        "type": "string"
                    },
                    "is_active": {
                        "type": "boolean"
                    }
                },
                "required": [
                    "id",
                    "code",
                    "name",
                    "legal_name",
                    "tin",
                    "address",
                    "country_code",
                    "timezone",
                    "currency",
                    "is_active"
                ],
                "title": "CompanyResource"
            },
            "CompanyUpdateRequest": {
                "type": "object",
                "description": "Backs the Settings \"Company\" tab. `code` is deliberately not editable here (it's a stable\nidentifier other rows could reference, not a display field) \u2014 only the fields Settings actually\nshows.",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 150
                    },
                    "legal_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 200
                    },
                    "tin": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 30
                    },
                    "address": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255
                    },
                    "country_code": {
                        "type": "string",
                        "minLength": 2,
                        "maxLength": 2
                    },
                    "timezone": {
                        "type": "string",
                        "maxLength": 50
                    },
                    "currency": {
                        "type": "string",
                        "minLength": 3,
                        "maxLength": 3
                    }
                },
                "title": "CompanyUpdateRequest"
            },
            "DepartmentResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "company_id": {
                        "type": "integer"
                    },
                    "parent_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "parent": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "name": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "id",
                            "name"
                        ]
                    },
                    "code": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "type": {
                        "type": "string"
                    },
                    "head_employee_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "cost_center": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "is_active": {
                        "type": "boolean"
                    },
                    "sort_order": {
                        "type": "integer"
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "updated_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "company_id",
                    "parent_id",
                    "code",
                    "name",
                    "type",
                    "head_employee_id",
                    "cost_center",
                    "is_active",
                    "sort_order",
                    "created_at",
                    "updated_at"
                ],
                "title": "DepartmentResource"
            },
            "DepartmentStoreRequest": {
                "type": "object",
                "properties": {
                    "company_id": {
                        "type": "integer"
                    },
                    "parent_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "code": {
                        "type": "string",
                        "maxLength": 20
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 120
                    },
                    "type": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "operations",
                            "hq_function",
                            "support",
                            null
                        ]
                    },
                    "head_employee_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "cost_center": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 30
                    },
                    "is_active": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "sort_order": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    }
                },
                "required": [
                    "company_id",
                    "code",
                    "name"
                ],
                "title": "DepartmentStoreRequest"
            },
            "DepartmentUpdateRequest": {
                "type": "object",
                "properties": {
                    "parent_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "code": {
                        "type": "string",
                        "maxLength": 20
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 120
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "operations",
                            "hq_function",
                            "support"
                        ]
                    },
                    "head_employee_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "cost_center": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 30
                    },
                    "is_active": {
                        "type": "boolean"
                    },
                    "sort_order": {
                        "type": "integer"
                    }
                },
                "title": "DepartmentUpdateRequest"
            },
            "EmployeeAcknowledgmentResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "employee_id": {
                        "type": "integer"
                    },
                    "document_type": {
                        "type": "string"
                    },
                    "document_version": {
                        "type": "string"
                    },
                    "acknowledged_at": {
                        "type": "string"
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "employee_id",
                    "document_type",
                    "document_version",
                    "acknowledged_at",
                    "created_at"
                ],
                "title": "EmployeeAcknowledgmentResource"
            },
            "EmployeeAcknowledgmentStoreRequest": {
                "type": "object",
                "description": "doc 04's sub-resource table gives acknowledgments only `employee.view` \u2014 no distinct write\npermission is documented, so creation is gated the same as any other employee.update-able\nsatellite (an HR-initiated acknowledgment on the employee's behalf; ESS self-signing is Phase 5).",
                "properties": {
                    "document_type": {
                        "type": "string",
                        "enum": [
                            "handbook",
                            "policy",
                            "code_of_conduct",
                            "data_privacy_consent"
                        ]
                    },
                    "document_version": {
                        "type": "string",
                        "maxLength": 20
                    },
                    "signature_path": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255
                    }
                },
                "required": [
                    "document_type",
                    "document_version"
                ],
                "title": "EmployeeAcknowledgmentStoreRequest"
            },
            "EmployeeAddressResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "employee_id": {
                        "type": "integer"
                    },
                    "type": {
                        "type": "string"
                    },
                    "line1": {
                        "type": "string"
                    },
                    "line2": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "barangay": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "city": {
                        "type": "string"
                    },
                    "province": {
                        "type": "string"
                    },
                    "postal_code": {
                        "type": "string"
                    },
                    "country_code": {
                        "type": "string"
                    },
                    "latitude": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "longitude": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "area_group": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "is_current": {
                        "type": "boolean"
                    },
                    "effective_from": {
                        "type": "string"
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "updated_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "employee_id",
                    "type",
                    "line1",
                    "line2",
                    "barangay",
                    "city",
                    "province",
                    "postal_code",
                    "country_code",
                    "latitude",
                    "longitude",
                    "area_group",
                    "is_current",
                    "effective_from",
                    "created_at",
                    "updated_at"
                ],
                "title": "EmployeeAddressResource"
            },
            "EmployeeAddressStoreRequest": {
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "enum": [
                            "permanent",
                            "current"
                        ]
                    },
                    "line1": {
                        "type": "string",
                        "maxLength": 200
                    },
                    "line2": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 200
                    },
                    "barangay": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120
                    },
                    "city": {
                        "type": "string",
                        "maxLength": 120
                    },
                    "province": {
                        "type": "string",
                        "maxLength": 120
                    },
                    "postal_code": {
                        "type": "string",
                        "maxLength": 20
                    },
                    "country_code": {
                        "type": "string",
                        "minLength": 2,
                        "maxLength": 2
                    },
                    "latitude": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "minimum": -90,
                        "maximum": 90
                    },
                    "longitude": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "minimum": -180,
                        "maximum": 180
                    },
                    "area_group": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 80
                    },
                    "is_current": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "effective_from": {
                        "type": "string",
                        "format": "date-time"
                    }
                },
                "required": [
                    "type",
                    "line1",
                    "city",
                    "province",
                    "postal_code",
                    "country_code",
                    "effective_from"
                ],
                "title": "EmployeeAddressStoreRequest"
            },
            "EmployeeAddressUpdateRequest": {
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "enum": [
                            "permanent",
                            "current"
                        ]
                    },
                    "line1": {
                        "type": "string",
                        "maxLength": 200
                    },
                    "line2": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 200
                    },
                    "barangay": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120
                    },
                    "city": {
                        "type": "string",
                        "maxLength": 120
                    },
                    "province": {
                        "type": "string",
                        "maxLength": 120
                    },
                    "postal_code": {
                        "type": "string",
                        "maxLength": 20
                    },
                    "country_code": {
                        "type": "string",
                        "minLength": 2,
                        "maxLength": 2
                    },
                    "latitude": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "minimum": -90,
                        "maximum": 90
                    },
                    "longitude": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "minimum": -180,
                        "maximum": 180
                    },
                    "area_group": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 80
                    },
                    "is_current": {
                        "type": "boolean"
                    },
                    "effective_from": {
                        "type": "string",
                        "format": "date-time"
                    }
                },
                "title": "EmployeeAddressUpdateRequest"
            },
            "EmployeeAssignmentHistoryResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "employee_id": {
                        "type": "integer"
                    },
                    "change_type": {
                        "type": "string"
                    },
                    "effective_date": {
                        "type": "string"
                    },
                    "end_date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "department": {
                        "type": "object",
                        "properties": {
                            "from": {
                                "type": [
                                    "integer",
                                    "null"
                                ]
                            },
                            "to": {
                                "type": [
                                    "integer",
                                    "null"
                                ]
                            }
                        },
                        "required": [
                            "from",
                            "to"
                        ]
                    },
                    "team": {
                        "type": "object",
                        "properties": {
                            "from": {
                                "type": [
                                    "integer",
                                    "null"
                                ]
                            },
                            "to": {
                                "type": [
                                    "integer",
                                    "null"
                                ]
                            }
                        },
                        "required": [
                            "from",
                            "to"
                        ]
                    },
                    "project": {
                        "type": "object",
                        "properties": {
                            "from": {
                                "type": [
                                    "integer",
                                    "null"
                                ]
                            },
                            "to": {
                                "type": [
                                    "integer",
                                    "null"
                                ]
                            }
                        },
                        "required": [
                            "from",
                            "to"
                        ]
                    },
                    "position": {
                        "type": "object",
                        "properties": {
                            "from": {
                                "type": [
                                    "integer",
                                    "null"
                                ]
                            },
                            "to": {
                                "type": [
                                    "integer",
                                    "null"
                                ]
                            }
                        },
                        "required": [
                            "from",
                            "to"
                        ]
                    },
                    "job_level": {
                        "type": "object",
                        "properties": {
                            "from": {
                                "type": [
                                    "integer",
                                    "null"
                                ]
                            },
                            "to": {
                                "type": [
                                    "integer",
                                    "null"
                                ]
                            }
                        },
                        "required": [
                            "from",
                            "to"
                        ]
                    },
                    "supervisor": {
                        "type": "object",
                        "properties": {
                            "from": {
                                "type": [
                                    "integer",
                                    "null"
                                ]
                            },
                            "to": {
                                "type": [
                                    "integer",
                                    "null"
                                ]
                            }
                        },
                        "required": [
                            "from",
                            "to"
                        ]
                    },
                    "location": {
                        "type": "object",
                        "properties": {
                            "from": {
                                "type": [
                                    "integer",
                                    "null"
                                ]
                            },
                            "to": {
                                "type": [
                                    "integer",
                                    "null"
                                ]
                            }
                        },
                        "required": [
                            "from",
                            "to"
                        ]
                    },
                    "employment_type": {
                        "type": "object",
                        "properties": {
                            "from": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "to": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            }
                        },
                        "required": [
                            "from",
                            "to"
                        ]
                    },
                    "reason": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "approved_by": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "employee_id",
                    "change_type",
                    "effective_date",
                    "end_date",
                    "department",
                    "team",
                    "project",
                    "position",
                    "job_level",
                    "supervisor",
                    "location",
                    "employment_type",
                    "reason",
                    "approved_by",
                    "created_at"
                ],
                "title": "EmployeeAssignmentHistoryResource"
            },
            "EmployeeBankAccountResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "employee_id": {
                        "type": "integer"
                    },
                    "bank_name": {
                        "type": "string"
                    },
                    "branch": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "account_name": {
                        "type": "string"
                    },
                    "account_number": {
                        "type": "string"
                    },
                    "account_number_last4": {
                        "type": "string"
                    },
                    "account_type": {
                        "type": "string"
                    },
                    "currency": {
                        "type": "string"
                    },
                    "is_primary": {
                        "type": "boolean"
                    },
                    "effective_from": {
                        "type": "string"
                    },
                    "effective_to": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "verified_by": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "updated_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "employee_id",
                    "bank_name",
                    "branch",
                    "account_name",
                    "account_number",
                    "account_number_last4",
                    "account_type",
                    "currency",
                    "is_primary",
                    "effective_from",
                    "effective_to",
                    "verified_by",
                    "created_at",
                    "updated_at"
                ],
                "title": "EmployeeBankAccountResource"
            },
            "EmployeeBankAccountStoreRequest": {
                "type": "object",
                "properties": {
                    "bank_name": {
                        "type": "string",
                        "maxLength": 120
                    },
                    "branch": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120
                    },
                    "account_name": {
                        "type": "string",
                        "maxLength": 150
                    },
                    "account_number": {
                        "type": "string",
                        "maxLength": 40
                    },
                    "account_type": {
                        "type": "string",
                        "enum": [
                            "savings",
                            "checking",
                            "payroll",
                            "e_wallet"
                        ]
                    },
                    "currency": {
                        "type": "string",
                        "minLength": 3,
                        "maxLength": 3
                    },
                    "is_primary": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "effective_from": {
                        "type": "string",
                        "format": "date-time"
                    }
                },
                "required": [
                    "bank_name",
                    "account_name",
                    "account_number",
                    "account_type",
                    "currency",
                    "effective_from"
                ],
                "title": "EmployeeBankAccountStoreRequest"
            },
            "EmployeeBankAccountUpdateRequest": {
                "type": "object",
                "properties": {
                    "bank_name": {
                        "type": "string",
                        "maxLength": 120
                    },
                    "branch": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120
                    },
                    "account_name": {
                        "type": "string",
                        "maxLength": 150
                    },
                    "account_number": {
                        "type": "string",
                        "maxLength": 40
                    },
                    "account_type": {
                        "type": "string",
                        "enum": [
                            "savings",
                            "checking",
                            "payroll",
                            "e_wallet"
                        ]
                    },
                    "currency": {
                        "type": "string",
                        "minLength": 3,
                        "maxLength": 3
                    },
                    "is_primary": {
                        "type": "boolean"
                    },
                    "effective_from": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "effective_to": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "verified_by": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    }
                },
                "title": "EmployeeBankAccountUpdateRequest"
            },
            "EmployeeContractResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "employee_id": {
                        "type": "integer"
                    },
                    "contract_no": {
                        "type": "string"
                    },
                    "contract_type": {
                        "type": "string"
                    },
                    "start_date": {
                        "type": "string"
                    },
                    "end_date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "renewal_count": {
                        "type": "integer"
                    },
                    "previous_contract_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "salary_snapshot": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "document_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "signed_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "status": {
                        "type": "string"
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "updated_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "employee_id",
                    "contract_no",
                    "contract_type",
                    "start_date",
                    "end_date",
                    "renewal_count",
                    "previous_contract_id",
                    "salary_snapshot",
                    "document_id",
                    "signed_at",
                    "status",
                    "created_at",
                    "updated_at"
                ],
                "title": "EmployeeContractResource"
            },
            "EmployeeContractStoreRequest": {
                "type": "object",
                "properties": {
                    "contract_no": {
                        "type": "string",
                        "maxLength": 40
                    },
                    "contract_type": {
                        "type": "string",
                        "enum": [
                            "probationary",
                            "regular",
                            "fixed_term",
                            "project_based",
                            "consultancy"
                        ]
                    },
                    "start_date": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "end_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "previous_contract_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "salary_snapshot": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "minimum": 0
                    },
                    "document_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "status": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "draft",
                            "sent",
                            "signed",
                            "active",
                            "expired",
                            "terminated",
                            null
                        ]
                    }
                },
                "required": [
                    "contract_no",
                    "contract_type",
                    "start_date"
                ],
                "title": "EmployeeContractStoreRequest"
            },
            "EmployeeContractUpdateRequest": {
                "type": "object",
                "properties": {
                    "end_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "renewal_count": {
                        "type": "integer",
                        "minimum": 0
                    },
                    "salary_snapshot": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "minimum": 0
                    },
                    "document_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "signed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "draft",
                            "sent",
                            "signed",
                            "active",
                            "expired",
                            "terminated"
                        ]
                    }
                },
                "title": "EmployeeContractUpdateRequest"
            },
            "EmployeeDocumentResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "employee_id": {
                        "type": "integer"
                    },
                    "document_type": {
                        "type": "string"
                    },
                    "document_subtype": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "title": {
                        "type": "string"
                    },
                    "file_name": {
                        "type": "string"
                    },
                    "mime_type": {
                        "type": "string"
                    },
                    "file_size": {
                        "type": "integer"
                    },
                    "document_number": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "issued_date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "expiry_date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "issuing_authority": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "version": {
                        "type": "integer"
                    },
                    "supersedes_document_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "is_confidential": {
                        "type": "boolean"
                    },
                    "uploaded_by": {
                        "type": "integer"
                    },
                    "virus_scan_status": {
                        "type": "string"
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "updated_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "employee_id",
                    "document_type",
                    "document_subtype",
                    "title",
                    "file_name",
                    "mime_type",
                    "file_size",
                    "document_number",
                    "issued_date",
                    "expiry_date",
                    "issuing_authority",
                    "version",
                    "supersedes_document_id",
                    "is_confidential",
                    "uploaded_by",
                    "virus_scan_status",
                    "created_at",
                    "updated_at"
                ],
                "title": "EmployeeDocumentResource"
            },
            "EmployeeDocumentStoreRequest": {
                "type": "object",
                "description": "Step 3 of doc 04 \u00a71.12's upload flow \u2014 confirms an already-presigned, already-uploaded object\nagainst a specific employee. `upload_id` resolution (and the \"does this object actually exist\"\ncheck) happens in UploadPresigner::resolve(), called from the controller.",
                "properties": {
                    "upload_id": {
                        "type": "string"
                    },
                    "document_type": {
                        "type": "string",
                        "enum": [
                            "resume",
                            "passport",
                            "government_id",
                            "visa",
                            "contract",
                            "certificate",
                            "medical",
                            "disciplinary",
                            "clearance",
                            "photo",
                            "other"
                        ]
                    },
                    "document_subtype": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 50
                    },
                    "title": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 200
                    },
                    "document_number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 100
                    },
                    "issued_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "expiry_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "issuing_authority": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 150
                    },
                    "is_confidential": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    }
                },
                "required": [
                    "upload_id",
                    "document_type"
                ],
                "title": "EmployeeDocumentStoreRequest"
            },
            "EmployeeEmergencyContactResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "employee_id": {
                        "type": "integer"
                    },
                    "name": {
                        "type": "string"
                    },
                    "relationship": {
                        "type": "string"
                    },
                    "mobile_number": {
                        "type": "string"
                    },
                    "alternate_number": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "address": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "is_primary": {
                        "type": "boolean"
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "updated_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "employee_id",
                    "name",
                    "relationship",
                    "mobile_number",
                    "alternate_number",
                    "address",
                    "is_primary",
                    "created_at",
                    "updated_at"
                ],
                "title": "EmployeeEmergencyContactResource"
            },
            "EmployeeEmergencyContactStoreRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 150
                    },
                    "relationship": {
                        "type": "string",
                        "maxLength": 60
                    },
                    "mobile_number": {
                        "type": "string",
                        "maxLength": 30
                    },
                    "alternate_number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 30
                    },
                    "address": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255
                    },
                    "is_primary": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    }
                },
                "required": [
                    "name",
                    "relationship",
                    "mobile_number"
                ],
                "title": "EmployeeEmergencyContactStoreRequest"
            },
            "EmployeeEmergencyContactUpdateRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 150
                    },
                    "relationship": {
                        "type": "string",
                        "maxLength": 60
                    },
                    "mobile_number": {
                        "type": "string",
                        "maxLength": 30
                    },
                    "alternate_number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 30
                    },
                    "address": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255
                    },
                    "is_primary": {
                        "type": "boolean"
                    }
                },
                "title": "EmployeeEmergencyContactUpdateRequest"
            },
            "EmployeeImportRequest": {
                "type": "object",
                "properties": {
                    "file": {
                        "type": "string",
                        "format": "binary",
                        "contentMediaType": "application\/octet-stream",
                        "description": "Maximum file size: 10240 kilobytes."
                    },
                    "dry_run": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    }
                },
                "required": [
                    "file"
                ],
                "title": "EmployeeImportRequest"
            },
            "EmployeeInternetConnectionResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "employee_id": {
                        "type": "integer"
                    },
                    "isp_name": {
                        "type": "string"
                    },
                    "connection_type": {
                        "type": "string"
                    },
                    "download_mbps": {
                        "type": "string"
                    },
                    "upload_mbps": {
                        "type": "string"
                    },
                    "latency_ms": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "is_backup_connection": {
                        "type": "boolean"
                    },
                    "speed_test_evidence_path": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "tested_at": {
                        "type": "string"
                    },
                    "verified_by": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "meets_requirement": {
                        "type": "boolean"
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "updated_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "employee_id",
                    "isp_name",
                    "connection_type",
                    "download_mbps",
                    "upload_mbps",
                    "latency_ms",
                    "is_backup_connection",
                    "speed_test_evidence_path",
                    "tested_at",
                    "verified_by",
                    "meets_requirement",
                    "created_at",
                    "updated_at"
                ],
                "title": "EmployeeInternetConnectionResource"
            },
            "EmployeeInternetConnectionStoreRequest": {
                "type": "object",
                "properties": {
                    "isp_name": {
                        "type": "string",
                        "maxLength": 100
                    },
                    "connection_type": {
                        "type": "string",
                        "enum": [
                            "fiber",
                            "dsl",
                            "cable",
                            "lte",
                            "5g",
                            "satellite"
                        ]
                    },
                    "download_mbps": {
                        "type": "number",
                        "minimum": 0
                    },
                    "upload_mbps": {
                        "type": "number",
                        "minimum": 0
                    },
                    "latency_ms": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0
                    },
                    "is_backup_connection": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "speed_test_evidence_path": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255
                    },
                    "tested_at": {
                        "type": "string",
                        "format": "date-time"
                    }
                },
                "required": [
                    "isp_name",
                    "connection_type",
                    "download_mbps",
                    "upload_mbps",
                    "tested_at"
                ],
                "title": "EmployeeInternetConnectionStoreRequest"
            },
            "EmployeeInternetConnectionUpdateRequest": {
                "type": "object",
                "properties": {
                    "isp_name": {
                        "type": "string",
                        "maxLength": 100
                    },
                    "connection_type": {
                        "type": "string",
                        "enum": [
                            "fiber",
                            "dsl",
                            "cable",
                            "lte",
                            "5g",
                            "satellite"
                        ]
                    },
                    "download_mbps": {
                        "type": "number",
                        "minimum": 0
                    },
                    "upload_mbps": {
                        "type": "number",
                        "minimum": 0
                    },
                    "latency_ms": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0
                    },
                    "is_backup_connection": {
                        "type": "boolean"
                    },
                    "speed_test_evidence_path": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255
                    },
                    "tested_at": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "meets_requirement": {
                        "type": "boolean",
                        "description": "Not on the store request: doc 03 frames both as an HR review step on top of the\nemployee-submitted speed test, not something set at submission time. No documented\nthreshold value exists yet for an automatic evaluation \u2014 left as an explicit HR call."
                    },
                    "verified_by": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    }
                },
                "title": "EmployeeInternetConnectionUpdateRequest"
            },
            "EmployeeLanguageResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "employee_id": {
                        "type": "integer"
                    },
                    "language_code": {
                        "type": "string"
                    },
                    "proficiency": {
                        "type": "string"
                    },
                    "is_business_usable": {
                        "type": "boolean"
                    },
                    "certification_name": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "certification_score": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "certified_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "verified_by": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "updated_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "employee_id",
                    "language_code",
                    "proficiency",
                    "is_business_usable",
                    "certification_name",
                    "certification_score",
                    "certified_at",
                    "verified_by",
                    "created_at",
                    "updated_at"
                ],
                "title": "EmployeeLanguageResource"
            },
            "EmployeeLanguageStoreRequest": {
                "type": "object",
                "properties": {
                    "language_code": {
                        "type": "string",
                        "maxLength": 10
                    },
                    "proficiency": {
                        "type": "string",
                        "enum": [
                            "native",
                            "C2",
                            "C1",
                            "B2",
                            "B1",
                            "A2",
                            "A1"
                        ]
                    },
                    "is_business_usable": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "certification_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 150
                    },
                    "certification_score": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 30
                    },
                    "certified_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    }
                },
                "required": [
                    "language_code",
                    "proficiency"
                ],
                "title": "EmployeeLanguageStoreRequest"
            },
            "EmployeeLanguageUpdateRequest": {
                "type": "object",
                "properties": {
                    "proficiency": {
                        "type": "string",
                        "enum": [
                            "native",
                            "C2",
                            "C1",
                            "B2",
                            "B1",
                            "A2",
                            "A1"
                        ]
                    },
                    "is_business_usable": {
                        "type": "boolean"
                    },
                    "certification_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 150
                    },
                    "certification_score": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 30
                    },
                    "certified_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "verified_by": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    }
                },
                "title": "EmployeeLanguageUpdateRequest"
            },
            "EmployeeMasterlistImportRequest": {
                "type": "object",
                "properties": {
                    "file": {
                        "type": "string",
                        "format": "binary",
                        "contentMediaType": "application\/octet-stream",
                        "description": "Maximum file size: 20480 kilobytes."
                    },
                    "company_id": {
                        "type": "integer"
                    },
                    "dry_run": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    }
                },
                "required": [
                    "file",
                    "company_id"
                ],
                "title": "EmployeeMasterlistImportRequest"
            },
            "EmployeePersonalDetailsResource": {
                "type": "object",
                "properties": {
                    "employee_id": {
                        "type": "integer"
                    },
                    "date_of_birth": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "gender": {
                        "type": "string"
                    },
                    "civil_status": {
                        "type": "string"
                    },
                    "nationality": {
                        "type": "string"
                    },
                    "birth_place": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "blood_type": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "personal_email": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "mobile_number": {
                        "type": "string"
                    },
                    "alternate_number": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "religion": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "health_notes": {
                        "type": "string"
                    },
                    "preferred_working_hours": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "additional_notes": {
                        "type": "string"
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "updated_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "employee_id",
                    "date_of_birth",
                    "gender",
                    "civil_status",
                    "nationality",
                    "birth_place",
                    "blood_type",
                    "personal_email",
                    "mobile_number",
                    "alternate_number",
                    "religion",
                    "preferred_working_hours",
                    "created_at",
                    "updated_at"
                ],
                "title": "EmployeePersonalDetailsResource"
            },
            "EmployeePersonalDetailsUpdateRequest": {
                "type": "object",
                "description": "Upsert (doc 04's \"all follow the same CRUD shape\" for satellites, simplified to a single\nshow\/update pair for the 1:1 personal-details resource \u2014 no separate create step). Validation\nalways requires the NOT NULL columns since a missing row is created fresh on first save.",
                "properties": {
                    "date_of_birth": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "gender": {
                        "type": "string",
                        "maxLength": 20
                    },
                    "civil_status": {
                        "type": "string",
                        "maxLength": 20
                    },
                    "nationality": {
                        "type": "string",
                        "minLength": 2,
                        "maxLength": 2
                    },
                    "birth_place": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 150
                    },
                    "blood_type": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 5
                    },
                    "personal_email": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "email",
                        "maxLength": 150
                    },
                    "mobile_number": {
                        "type": "string",
                        "maxLength": 30
                    },
                    "alternate_number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 30
                    },
                    "religion": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 50
                    },
                    "health_notes": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "preferred_working_hours": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120
                    },
                    "additional_notes": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "date_of_birth",
                    "gender",
                    "civil_status",
                    "nationality",
                    "mobile_number"
                ],
                "title": "EmployeePersonalDetailsUpdateRequest"
            },
            "EmployeeResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "employee_no": {
                        "type": "string"
                    },
                    "display_name": {
                        "type": "string"
                    },
                    "first_name": {
                        "type": "string"
                    },
                    "middle_name": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "last_name": {
                        "type": "string"
                    },
                    "suffix": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "company_email": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "status": {
                        "type": "string"
                    },
                    "hire_date": {
                        "type": "string"
                    },
                    "separation_date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "department": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "name": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "id",
                            "name"
                        ]
                    },
                    "employment_type": {
                        "type": "string"
                    },
                    "work_arrangement": {
                        "type": "string"
                    },
                    "supervisor_employee_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "job_function": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "compensation": {
                        "description": "Compensation gate 3 demo: NullObject strategy, own-record exception, doc 05 \u00a75.",
                        "anyOf": [
                            {
                                "type": "null"
                            },
                            {
                                "type": "object",
                                "properties": {
                                    "amount": {
                                        "type": [
                                            "string",
                                            "null"
                                        ]
                                    },
                                    "currency": {
                                        "type": "string"
                                    },
                                    "formatted": {
                                        "type": [
                                            "string",
                                            "null"
                                        ]
                                    }
                                },
                                "required": [
                                    "amount",
                                    "currency",
                                    "formatted"
                                ]
                            },
                            {
                                "type": "object",
                                "properties": {
                                    "amount": {
                                        "type": "null"
                                    },
                                    "currency": {
                                        "type": "string"
                                    },
                                    "masked": {
                                        "type": "boolean"
                                    }
                                },
                                "required": [
                                    "amount",
                                    "currency",
                                    "masked"
                                ]
                            }
                        ]
                    },
                    "personal_details": {
                        "anyOf": [
                            {
                                "description": "Satellite includes (doc 04 line 247, \"include supports all satellites\") \u2014 each of\nthese is a full Resource, not an inline shape, so personal-details' own field\nmasking (date_of_birth\/health_notes\/additional_notes) still applies when embedded.",
                                "$ref": "#\/components\/schemas\/EmployeePersonalDetailsResource"
                            },
                            {
                                "type": "null"
                            }
                        ]
                    },
                    "addresses": {
                        "type": "array",
                        "items": {
                            "type": "array",
                            "items": {}
                        }
                    },
                    "emergency_contacts": {
                        "type": "array",
                        "items": {
                            "type": "array",
                            "items": {}
                        }
                    },
                    "languages": {
                        "type": "array",
                        "items": {
                            "type": "array",
                            "items": {}
                        }
                    },
                    "internet_connections": {
                        "type": "array",
                        "items": {
                            "type": "array",
                            "items": {}
                        }
                    },
                    "documents": {
                        "type": "array",
                        "description": "Phase 2 satellites: documents has no FieldGroup (its own Policy already gates the\ndedicated endpoint; there's no \"show it anyway but masked\" case doc 04 asks for\nhere). Bank\/statutory reuse their full Resource shape but overwrite just the\nsensitive field via Last4 masking; visa\/contract drop their whole sensitive\nfield via Omit when the embedding viewer lacks the permission.",
                        "items": {
                            "type": "array",
                            "items": {}
                        }
                    },
                    "statutory_ids": {
                        "type": "array",
                        "items": {
                            "type": "array",
                            "items": {}
                        }
                    },
                    "bank_accounts": {
                        "type": "array",
                        "items": {
                            "type": "array",
                            "items": {}
                        }
                    },
                    "visas": {
                        "type": "array",
                        "items": {
                            "type": "array",
                            "items": {
                                "anyOf": [
                                    {
                                        "type": "object"
                                    },
                                    {}
                                ]
                            }
                        }
                    },
                    "contracts": {
                        "type": "array",
                        "items": {
                            "anyOf": [
                                {
                                    "type": "array"
                                },
                                {
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "integer"
                                        },
                                        "masked": {
                                            "type": "boolean"
                                        }
                                    },
                                    "required": [
                                        "id",
                                        "masked"
                                    ]
                                }
                            ]
                        }
                    },
                    "assignment_histories": {
                        "type": "array",
                        "description": "Phase 3: no FieldGroup for either \u2014 both are gated only by employee.view (doc 04's\nsub-resource table), same permission that already gates this whole response.",
                        "items": {
                            "type": "array",
                            "items": {}
                        }
                    },
                    "acknowledgments": {
                        "type": "array",
                        "items": {
                            "type": "array",
                            "items": {}
                        }
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "updated_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "employee_no",
                    "display_name",
                    "first_name",
                    "middle_name",
                    "last_name",
                    "suffix",
                    "company_email",
                    "status",
                    "hire_date",
                    "separation_date",
                    "created_at",
                    "updated_at"
                ],
                "title": "EmployeeResource"
            },
            "EmployeeScheduleImportRequest": {
                "type": "object",
                "properties": {
                    "file": {
                        "type": "string",
                        "format": "binary",
                        "contentMediaType": "application\/octet-stream",
                        "description": "Maximum file size: 20480 kilobytes."
                    },
                    "dry_run": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "months": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "string",
                            "pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
                        }
                    }
                },
                "required": [
                    "file"
                ],
                "title": "EmployeeScheduleImportRequest"
            },
            "EmployeeScheduleResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "employee_id": {
                        "type": "integer"
                    },
                    "work_date": {
                        "type": "string"
                    },
                    "work_shift_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "work_shift": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "code": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "start_time": {
                                "type": "string"
                            },
                            "end_time": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "id",
                            "code",
                            "name",
                            "start_time",
                            "end_time"
                        ]
                    },
                    "start_time": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "end_time": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "is_rest_day": {
                        "type": "boolean"
                    },
                    "notes": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "employee_id",
                    "work_date",
                    "work_shift_id",
                    "start_time",
                    "end_time",
                    "is_rest_day",
                    "notes"
                ],
                "title": "EmployeeScheduleResource"
            },
            "EmployeeScheduleSyncRequest": {
                "type": "object",
                "properties": {
                    "entries": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "employee_id": {
                                    "type": "integer"
                                },
                                "work_date": {
                                    "type": "string",
                                    "format": "date-time"
                                },
                                "clear": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ]
                                },
                                "is_rest_day": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ]
                                },
                                "work_shift_id": {
                                    "type": [
                                        "integer",
                                        "null"
                                    ]
                                },
                                "start_time": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "end_time": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "notes": {
                                    "type": [
                                        "string",
                                        "null"
                                    ],
                                    "maxLength": 255
                                }
                            },
                            "required": [
                                "employee_id",
                                "work_date"
                            ]
                        },
                        "minItems": 1,
                        "maxItems": 500
                    }
                },
                "required": [
                    "entries"
                ],
                "title": "EmployeeScheduleSyncRequest"
            },
            "EmployeeSelfUpdateRequest": {
                "type": "object",
                "description": "doc 04 \u00a73.1: \"PATCH \/employees\/me \u2014 Non-restricted fields only; restricted fields must go\n * through a request.\" No approval\/request workflow exists yet (doc 06), so this is scoped to the\nplain contact-info fields on personal-details that carry no FieldGroup gate at all \u2014\ndate_of_birth (PersonalSensitive) and health_notes\/additional_notes (Health) are excluded here\neven though HR can set them via the admin endpoint, since ESS write access to those needs the\nrequest workflow this pass doesn't have.",
                "properties": {
                    "personal_email": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "email",
                        "maxLength": 150
                    },
                    "mobile_number": {
                        "type": "string",
                        "maxLength": 30
                    },
                    "alternate_number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 30
                    },
                    "preferred_working_hours": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120
                    }
                },
                "title": "EmployeeSelfUpdateRequest"
            },
            "EmployeeStatutoryIdResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "employee_id": {
                        "type": "integer"
                    },
                    "country_code": {
                        "type": "string"
                    },
                    "statutory_type": {
                        "type": "string"
                    },
                    "identifier": {
                        "type": "string"
                    },
                    "identifier_last4": {
                        "type": "string"
                    },
                    "registered_date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "document_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "is_verified": {
                        "type": "boolean"
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "updated_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "employee_id",
                    "country_code",
                    "statutory_type",
                    "identifier",
                    "identifier_last4",
                    "registered_date",
                    "document_id",
                    "is_verified",
                    "created_at",
                    "updated_at"
                ],
                "title": "EmployeeStatutoryIdResource"
            },
            "EmployeeStatutoryIdStoreRequest": {
                "type": "object",
                "properties": {
                    "country_code": {
                        "type": "string",
                        "minLength": 2,
                        "maxLength": 2
                    },
                    "statutory_type": {
                        "type": "string",
                        "maxLength": 40
                    },
                    "identifier": {
                        "type": "string",
                        "maxLength": 60
                    },
                    "registered_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "document_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    }
                },
                "required": [
                    "country_code",
                    "statutory_type",
                    "identifier"
                ],
                "title": "EmployeeStatutoryIdStoreRequest"
            },
            "EmployeeStatutoryIdUpdateRequest": {
                "type": "object",
                "properties": {
                    "identifier": {
                        "type": "string",
                        "maxLength": 60
                    },
                    "registered_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "document_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "is_verified": {
                        "type": "boolean"
                    }
                },
                "title": "EmployeeStatutoryIdUpdateRequest"
            },
            "EmployeeStoreRequest": {
                "type": "object",
                "properties": {
                    "company_id": {
                        "type": "integer"
                    },
                    "employee_no": {
                        "type": "string"
                    },
                    "first_name": {
                        "type": "string",
                        "description": "server-generated, see EmployeeNumberGenerator",
                        "maxLength": 80
                    },
                    "middle_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 80
                    },
                    "last_name": {
                        "type": "string",
                        "maxLength": 80
                    },
                    "suffix": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 20
                    },
                    "local_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 150
                    },
                    "preferred_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 80
                    },
                    "company_email": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "email",
                        "maxLength": 150
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "pre_hire",
                            "probationary",
                            "active"
                        ]
                    },
                    "hire_date": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "department_id": {
                        "type": "integer"
                    },
                    "employment_type": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "regular",
                            "probationary",
                            "contract",
                            "project_based",
                            "part_time",
                            "intern",
                            "consultant",
                            null
                        ]
                    },
                    "work_arrangement": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "onsite",
                            "hybrid",
                            "remote",
                            null
                        ]
                    },
                    "supervisor_employee_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "job_function": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120
                    },
                    "is_management": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    }
                },
                "required": [
                    "company_id",
                    "first_name",
                    "last_name",
                    "status",
                    "hire_date",
                    "department_id"
                ],
                "title": "EmployeeStoreRequest"
            },
            "EmployeeUpdateRequest": {
                "type": "object",
                "properties": {
                    "employee_no": {
                        "type": "string",
                        "description": "Server-generated at creation (EmployeeNumberGenerator) but editable afterward \u2014\nHR sometimes needs to correct one (a typo, or a value carried over from an import\nlike the masterlist importer that deliberately preserves the source's own numbers).",
                        "maxLength": 30
                    },
                    "first_name": {
                        "type": "string",
                        "maxLength": 80
                    },
                    "middle_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 80
                    },
                    "last_name": {
                        "type": "string",
                        "maxLength": 80
                    },
                    "suffix": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 20
                    },
                    "local_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 150
                    },
                    "preferred_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 80
                    },
                    "company_email": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "email",
                        "maxLength": 150
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "pre_hire",
                            "probationary",
                            "active",
                            "on_leave",
                            "suspended",
                            "resigned",
                            "terminated",
                            "retired"
                        ]
                    },
                    "department_id": {
                        "type": "integer"
                    },
                    "employment_type": {
                        "type": "string",
                        "enum": [
                            "regular",
                            "probationary",
                            "contract",
                            "project_based",
                            "part_time",
                            "intern",
                            "consultant"
                        ]
                    },
                    "work_arrangement": {
                        "type": "string",
                        "enum": [
                            "onsite",
                            "hybrid",
                            "remote"
                        ]
                    },
                    "supervisor_employee_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "job_function": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120
                    }
                },
                "title": "EmployeeUpdateRequest"
            },
            "EmployeeVisaResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "employee_id": {
                        "type": "integer"
                    },
                    "visa_type": {
                        "type": "string"
                    },
                    "visa_number": {
                        "type": "string"
                    },
                    "issuing_country": {
                        "type": "string"
                    },
                    "issued_date": {
                        "type": "string"
                    },
                    "expiry_date": {
                        "type": "string"
                    },
                    "sponsor": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "status": {
                        "type": "string"
                    },
                    "document_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "updated_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "employee_id",
                    "visa_type",
                    "visa_number",
                    "issuing_country",
                    "issued_date",
                    "expiry_date",
                    "sponsor",
                    "status",
                    "document_id",
                    "created_at",
                    "updated_at"
                ],
                "title": "EmployeeVisaResource"
            },
            "EmployeeVisaStoreRequest": {
                "type": "object",
                "properties": {
                    "visa_type": {
                        "type": "string",
                        "maxLength": 60
                    },
                    "visa_number": {
                        "type": "string",
                        "maxLength": 100
                    },
                    "issuing_country": {
                        "type": "string",
                        "minLength": 2,
                        "maxLength": 2
                    },
                    "issued_date": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "expiry_date": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "sponsor": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 150
                    },
                    "status": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "active",
                            "pending_renewal",
                            "expired",
                            "cancelled",
                            null
                        ]
                    },
                    "document_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    }
                },
                "required": [
                    "visa_type",
                    "visa_number",
                    "issuing_country",
                    "issued_date",
                    "expiry_date"
                ],
                "title": "EmployeeVisaStoreRequest"
            },
            "EmployeeVisaUpdateRequest": {
                "type": "object",
                "properties": {
                    "visa_type": {
                        "type": "string",
                        "maxLength": 60
                    },
                    "visa_number": {
                        "type": "string",
                        "maxLength": 100
                    },
                    "issuing_country": {
                        "type": "string",
                        "minLength": 2,
                        "maxLength": 2
                    },
                    "issued_date": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "expiry_date": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "sponsor": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 150
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "active",
                            "pending_renewal",
                            "expired",
                            "cancelled"
                        ]
                    },
                    "document_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    }
                },
                "title": "EmployeeVisaUpdateRequest"
            },
            "HolidayResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "date": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "type": {
                        "type": "string"
                    },
                    "is_recurring": {
                        "type": "boolean"
                    }
                },
                "required": [
                    "id",
                    "date",
                    "name",
                    "type",
                    "is_recurring"
                ],
                "title": "HolidayResource"
            },
            "IntegrationEmployeeResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "employee_no": {
                        "type": "string"
                    },
                    "display_name": {
                        "type": "string"
                    },
                    "first_name": {
                        "type": "string"
                    },
                    "middle_name": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "last_name": {
                        "type": "string"
                    },
                    "suffix": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "company_email": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "status": {
                        "type": "string"
                    },
                    "hire_date": {
                        "type": "string"
                    },
                    "separation_date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "department": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "name": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "id",
                            "name"
                        ]
                    },
                    "employment_type": {
                        "type": "string"
                    },
                    "job_function": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "supervisor_employee_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "employee_no",
                    "display_name",
                    "first_name",
                    "middle_name",
                    "last_name",
                    "suffix",
                    "company_email",
                    "status",
                    "hire_date",
                    "separation_date",
                    "department",
                    "employment_type",
                    "job_function",
                    "supervisor_employee_id"
                ],
                "title": "IntegrationEmployeeResource"
            },
            "LeaveBalanceAccrueRequest": {
                "type": "object",
                "properties": {
                    "company_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "method": {
                        "type": "string",
                        "enum": [
                            "monthly_accrual",
                            "annual_grant"
                        ]
                    }
                },
                "required": [
                    "method"
                ],
                "title": "LeaveBalanceAccrueRequest"
            },
            "LeaveBalanceAdjustRequest": {
                "type": "object",
                "properties": {
                    "employee_id": {
                        "type": "integer"
                    },
                    "leave_type_id": {
                        "type": "integer"
                    },
                    "year": {
                        "type": "integer",
                        "minimum": 2000
                    },
                    "days": {
                        "type": "number"
                    },
                    "reason": {
                        "type": "string",
                        "maxLength": 255
                    }
                },
                "required": [
                    "employee_id",
                    "leave_type_id",
                    "year",
                    "days",
                    "reason"
                ],
                "title": "LeaveBalanceAdjustRequest"
            },
            "LeaveBalanceResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "employee_id": {
                        "type": "integer"
                    },
                    "leave_type": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "code": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "id",
                            "code",
                            "name"
                        ]
                    },
                    "year": {
                        "type": "integer"
                    },
                    "opening_balance": {
                        "type": "number"
                    },
                    "earned_days": {
                        "type": "number"
                    },
                    "carried_over_days": {
                        "type": "number"
                    },
                    "used_days": {
                        "type": "number"
                    },
                    "pending_days": {
                        "type": "number"
                    },
                    "adjusted_days": {
                        "type": "number"
                    },
                    "expired_days": {
                        "type": "number"
                    },
                    "available_days": {
                        "type": "number"
                    },
                    "last_accrued_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "employee_id",
                    "year",
                    "opening_balance",
                    "earned_days",
                    "carried_over_days",
                    "used_days",
                    "pending_days",
                    "adjusted_days",
                    "expired_days",
                    "available_days",
                    "last_accrued_at"
                ],
                "title": "LeaveBalanceResource"
            },
            "LeaveRequestResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "request_id": {
                        "type": "integer"
                    },
                    "employee": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "display_name": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "id",
                            "display_name"
                        ]
                    },
                    "leave_type": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "name": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "id",
                            "name"
                        ]
                    },
                    "start_date": {
                        "type": "string"
                    },
                    "end_date": {
                        "type": "string"
                    },
                    "is_half_day": {
                        "type": "boolean"
                    },
                    "half_day_period": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "total_days": {
                        "type": "number"
                    },
                    "reason": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "contact_during_leave": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "reliever_employee": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "display_name": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "id",
                            "display_name"
                        ]
                    },
                    "status": {
                        "type": "string"
                    },
                    "filed_at": {
                        "type": "string"
                    }
                },
                "required": [
                    "id",
                    "request_id",
                    "start_date",
                    "end_date",
                    "is_half_day",
                    "half_day_period",
                    "total_days",
                    "reason",
                    "contact_during_leave",
                    "status",
                    "filed_at"
                ],
                "title": "LeaveRequestResource"
            },
            "LeaveRequestStoreRequest": {
                "type": "object",
                "properties": {
                    "employee_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "leave_type_id": {
                        "type": "integer"
                    },
                    "start_date": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "end_date": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "is_half_day": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "half_day_period": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "am",
                            "pm",
                            null
                        ]
                    },
                    "reason": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "contact_during_leave": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120
                    },
                    "reliever_employee_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    }
                },
                "required": [
                    "leave_type_id",
                    "start_date",
                    "end_date"
                ],
                "title": "LeaveRequestStoreRequest"
            },
            "LeaveTypeResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "code": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "category": {
                        "type": "string"
                    },
                    "is_paid": {
                        "type": "boolean"
                    },
                    "accrual_method": {
                        "type": "string"
                    },
                    "default_days_per_year": {
                        "type": "number"
                    },
                    "accrual_rate_per_month": {
                        "type": [
                            "number",
                            "null"
                        ]
                    },
                    "max_carry_over_days": {
                        "type": "number"
                    },
                    "min_notice_days": {
                        "type": "integer"
                    },
                    "max_consecutive_days": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "requires_attachment": {
                        "type": "boolean"
                    },
                    "allows_half_day": {
                        "type": "boolean"
                    },
                    "gender_restriction": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "min_tenure_months": {
                        "type": "integer"
                    },
                    "is_convertible_to_cash": {
                        "type": "boolean"
                    },
                    "is_active": {
                        "type": "boolean"
                    }
                },
                "required": [
                    "id",
                    "code",
                    "name",
                    "category",
                    "is_paid",
                    "accrual_method",
                    "default_days_per_year",
                    "accrual_rate_per_month",
                    "max_carry_over_days",
                    "min_notice_days",
                    "max_consecutive_days",
                    "requires_attachment",
                    "allows_half_day",
                    "gender_restriction",
                    "min_tenure_months",
                    "is_convertible_to_cash",
                    "is_active"
                ],
                "title": "LeaveTypeResource"
            },
            "LeaveTypeStoreRequest": {
                "type": "object",
                "properties": {
                    "code": {
                        "type": "string",
                        "maxLength": 30
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 80
                    },
                    "category": {
                        "type": "string",
                        "enum": [
                            "vacation",
                            "sick",
                            "emergency",
                            "maternity",
                            "paternity",
                            "solo_parent",
                            "bereavement",
                            "unpaid",
                            "special",
                            "service_incentive"
                        ]
                    },
                    "is_paid": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "accrual_method": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "annual_grant",
                            "monthly_accrual",
                            "per_event",
                            "none",
                            null
                        ]
                    },
                    "default_days_per_year": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "minimum": 0
                    },
                    "accrual_rate_per_month": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "minimum": 0
                    },
                    "max_carry_over_days": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "minimum": 0
                    },
                    "carry_over_expiry_months": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0
                    },
                    "min_notice_days": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0
                    },
                    "max_consecutive_days": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0
                    },
                    "requires_attachment": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "attachment_required_after_days": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0
                    },
                    "allows_half_day": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "gender_restriction": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "male",
                            "female",
                            null
                        ]
                    },
                    "min_tenure_months": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0
                    },
                    "is_convertible_to_cash": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "is_active": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    }
                },
                "required": [
                    "code",
                    "name",
                    "category"
                ],
                "title": "LeaveTypeStoreRequest"
            },
            "LeaveTypeUpdateRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 80
                    },
                    "category": {
                        "type": "string",
                        "enum": [
                            "vacation",
                            "sick",
                            "emergency",
                            "maternity",
                            "paternity",
                            "solo_parent",
                            "bereavement",
                            "unpaid",
                            "special",
                            "service_incentive"
                        ]
                    },
                    "is_paid": {
                        "type": "boolean"
                    },
                    "accrual_method": {
                        "type": "string",
                        "enum": [
                            "annual_grant",
                            "monthly_accrual",
                            "per_event",
                            "none"
                        ]
                    },
                    "default_days_per_year": {
                        "type": "number",
                        "minimum": 0
                    },
                    "accrual_rate_per_month": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "minimum": 0
                    },
                    "max_carry_over_days": {
                        "type": "number",
                        "minimum": 0
                    },
                    "carry_over_expiry_months": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0
                    },
                    "min_notice_days": {
                        "type": "integer",
                        "minimum": 0
                    },
                    "max_consecutive_days": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0
                    },
                    "requires_attachment": {
                        "type": "boolean"
                    },
                    "attachment_required_after_days": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0
                    },
                    "allows_half_day": {
                        "type": "boolean"
                    },
                    "gender_restriction": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "male",
                            "female",
                            null
                        ]
                    },
                    "min_tenure_months": {
                        "type": "integer",
                        "minimum": 0
                    },
                    "is_convertible_to_cash": {
                        "type": "boolean"
                    },
                    "is_active": {
                        "type": "boolean"
                    }
                },
                "title": "LeaveTypeUpdateRequest"
            },
            "LinkEmployeeRequest": {
                "type": "object",
                "properties": {
                    "employee_no": {
                        "type": "string",
                        "maxLength": 30
                    }
                },
                "required": [
                    "employee_no"
                ],
                "title": "LinkEmployeeRequest"
            },
            "OvertimeRequestResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "request_id": {
                        "type": "integer"
                    },
                    "employee": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "display_name": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "id",
                            "display_name"
                        ]
                    },
                    "work_date": {
                        "type": "string"
                    },
                    "start_time": {
                        "type": "string"
                    },
                    "end_time": {
                        "type": "string"
                    },
                    "requested_minutes": {
                        "type": "integer"
                    },
                    "approved_minutes": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "reason": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "is_pre_approved": {
                        "type": "boolean"
                    },
                    "status": {
                        "type": "string"
                    }
                },
                "required": [
                    "id",
                    "request_id",
                    "work_date",
                    "start_time",
                    "end_time",
                    "requested_minutes",
                    "approved_minutes",
                    "reason",
                    "is_pre_approved",
                    "status"
                ],
                "title": "OvertimeRequestResource"
            },
            "OvertimeRequestStoreRequest": {
                "type": "object",
                "properties": {
                    "employee_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "work_date": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "start_time": {
                        "type": "string"
                    },
                    "end_time": {
                        "type": "string"
                    },
                    "requested_minutes": {
                        "type": "integer",
                        "minimum": 1
                    },
                    "reason": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "project_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "is_pre_approved": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    }
                },
                "required": [
                    "work_date",
                    "start_time",
                    "end_time",
                    "requested_minutes"
                ],
                "title": "OvertimeRequestStoreRequest"
            },
            "PresignUploadRequest": {
                "type": "object",
                "description": "Step 1 of doc 04 \u00a71.12's upload flow. Per-purpose size\/MIME whitelists live here, not on a\nconfig file, since they're small and this is currently the only purpose defined \u2014 add a case to\nboth const arrays when a second purpose (e.g. a training video) is needed.",
                "properties": {
                    "file_name": {
                        "type": "string",
                        "maxLength": 255
                    },
                    "mime_type": {
                        "type": "string",
                        "maxLength": 100
                    },
                    "size": {
                        "type": "integer",
                        "minimum": 1
                    },
                    "purpose": {
                        "type": "string",
                        "enum": [
                            "employee_document"
                        ]
                    }
                },
                "required": [
                    "file_name",
                    "mime_type",
                    "size",
                    "purpose"
                ],
                "title": "PresignUploadRequest"
            },
            "RequestApprovalResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "step_order": {
                        "type": "integer"
                    },
                    "name": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "approver": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "name": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "id",
                            "name"
                        ]
                    },
                    "delegated_from_user_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "action": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "acted_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "due_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "is_escalated": {
                        "type": "boolean"
                    }
                },
                "required": [
                    "id",
                    "step_order",
                    "delegated_from_user_id",
                    "action",
                    "comment",
                    "acted_at",
                    "due_at",
                    "is_escalated"
                ],
                "title": "RequestApprovalResource"
            },
            "RequestApproveRequest": {
                "type": "object",
                "properties": {
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2000
                    }
                },
                "title": "RequestApproveRequest"
            },
            "RequestReassignRequest": {
                "type": "object",
                "properties": {
                    "approval_id": {
                        "type": "integer"
                    },
                    "to_user_id": {
                        "type": "integer"
                    }
                },
                "required": [
                    "approval_id",
                    "to_user_id"
                ],
                "title": "RequestReassignRequest"
            },
            "RequestRejectRequest": {
                "type": "object",
                "properties": {
                    "reason": {
                        "type": "string",
                        "maxLength": 2000
                    }
                },
                "required": [
                    "reason"
                ],
                "title": "RequestRejectRequest"
            },
            "RequestResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "request_no": {
                        "type": "string"
                    },
                    "request_type": {
                        "type": "object",
                        "properties": {
                            "code": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "code",
                            "name"
                        ]
                    },
                    "requester": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "name": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "id",
                            "name"
                        ]
                    },
                    "subject_employee": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "display_name": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "id",
                            "display_name"
                        ]
                    },
                    "title": {
                        "type": "string"
                    },
                    "payload": {
                        "type": "object",
                        "additionalProperties": {}
                    },
                    "current_payload_snapshot": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {}
                    },
                    "effective_date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "amount": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "properties": {
                            "amount": {
                                "type": "string"
                            },
                            "currency": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "amount",
                            "currency"
                        ]
                    },
                    "status": {
                        "type": "string"
                    },
                    "current_step_order": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "priority": {
                        "type": "string"
                    },
                    "submitted_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "completed_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "applied_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "approvals": {
                        "type": "array",
                        "items": {
                            "type": "array",
                            "items": {}
                        }
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "updated_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "id",
                    "request_no",
                    "title",
                    "payload",
                    "current_payload_snapshot",
                    "effective_date",
                    "amount",
                    "status",
                    "current_step_order",
                    "priority",
                    "submitted_at",
                    "completed_at",
                    "applied_at",
                    "created_at",
                    "updated_at"
                ],
                "title": "RequestResource"
            },
            "RequestReturnRequest": {
                "type": "object",
                "properties": {
                    "reason": {
                        "type": "string",
                        "maxLength": 2000
                    }
                },
                "required": [
                    "reason"
                ],
                "title": "RequestReturnRequest"
            },
            "RequestStoreRequest": {
                "type": "object",
                "description": "`payload`'s own shape is per-request-type (`request_types.payload_schema`) \u2014 this validates the\nenvelope every type shares (doc 04 \u00a73.3's example body), not the payload's fields. Each\nhandler's own `validate()` (doc 06 \u00a76) checks the payload itself once a type is submitted.",
                "properties": {
                    "request_type_code": {
                        "type": "string"
                    },
                    "subject_employee_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "title": {
                        "type": "string",
                        "maxLength": 200
                    },
                    "payload": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "minItems": 1
                    },
                    "effective_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "amount": {
                        "type": [
                            "number",
                            "null"
                        ]
                    },
                    "currency": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "minLength": 3,
                        "maxLength": 3
                    },
                    "priority": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "low",
                            "normal",
                            "high",
                            "urgent",
                            null
                        ]
                    }
                },
                "required": [
                    "request_type_code",
                    "title",
                    "payload"
                ],
                "title": "RequestStoreRequest"
            },
            "RequestTypeResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "code": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "payload_schema": {
                        "type": "object",
                        "additionalProperties": {}
                    },
                    "requires_effective_date": {
                        "type": "boolean"
                    },
                    "allows_attachment": {
                        "type": "boolean"
                    },
                    "sla_hours": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "is_submittable": {
                        "type": "boolean"
                    }
                },
                "required": [
                    "id",
                    "code",
                    "name",
                    "description",
                    "payload_schema",
                    "requires_effective_date",
                    "allows_attachment",
                    "sla_hours",
                    "is_submittable"
                ],
                "title": "RequestTypeResource"
            },
            "Role": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "name": {
                        "type": "string"
                    },
                    "display_name": {
                        "type": "string"
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "is_system": {
                        "type": "boolean"
                    },
                    "default_data_scope": {
                        "type": "string"
                    },
                    "guard_name": {
                        "type": "string"
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "updated_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    }
                },
                "required": [
                    "id",
                    "name",
                    "display_name",
                    "description",
                    "is_system",
                    "default_data_scope",
                    "guard_name",
                    "created_at",
                    "updated_at"
                ],
                "title": "Role"
            },
            "UserResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "name": {
                        "type": "string"
                    },
                    "email": {
                        "type": "string"
                    },
                    "avatar_url": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "company_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "employee_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Needed by the frontend's Requests module: \"is the current viewer the subject of\n this request\" and \"who am I filing this on behalf of by default\" both key off it."
                    },
                    "company": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "description": "Auto-assigning company_id on Department\/Employee creation (no picker \u2014 the admin's\nown company) needs this; loaded explicitly by the controller, not lazy-loaded here.",
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "name": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "id",
                            "name"
                        ]
                    },
                    "roles": {
                        "type": "string"
                    },
                    "permissions": {
                        "type": "string"
                    }
                },
                "required": [
                    "id",
                    "name",
                    "email",
                    "avatar_url",
                    "company_id",
                    "employee_id",
                    "roles",
                    "permissions"
                ],
                "title": "UserResource"
            },
            "UserStoreRequest": {
                "type": "object",
                "description": "Lets an admin pre-provision a Google-SSO account (doc 04 \u00a73.16): the user doesn't need to have\nsigned in yet \u2014 `GoogleUserProvisioner::resolve()` will match this row by email on first login\nand fill in `google_id`\/`avatar_url` itself. `password` is intentionally not settable here; this\nplatform has no password auth (ADR-11).",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 150
                    },
                    "email": {
                        "type": "string",
                        "format": "email",
                        "maxLength": 150
                    },
                    "company_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "employee_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "status": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "active",
                            "inactive",
                            "pending_activation",
                            null
                        ]
                    },
                    "roles": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "uniqueItems": true
                    }
                },
                "required": [
                    "name",
                    "email"
                ],
                "title": "UserStoreRequest"
            },
            "UserUpdateRequest": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 150
                    },
                    "email": {
                        "type": "string",
                        "format": "email",
                        "maxLength": 150
                    },
                    "company_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "employee_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "active",
                            "inactive",
                            "pending_activation"
                        ]
                    },
                    "roles": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "uniqueItems": true
                    }
                },
                "title": "UserUpdateRequest"
            },
            "WorkShiftResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "code": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "start_time": {
                        "type": "string"
                    },
                    "end_time": {
                        "type": "string"
                    },
                    "break_minutes": {
                        "type": "integer"
                    },
                    "grace_period_minutes": {
                        "type": "integer"
                    },
                    "is_night_shift": {
                        "type": "boolean"
                    },
                    "rest_days": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "total_hours": {
                        "type": "number"
                    },
                    "is_flexible": {
                        "type": "boolean"
                    }
                },
                "required": [
                    "id",
                    "code",
                    "name",
                    "start_time",
                    "end_time",
                    "break_minutes",
                    "grace_period_minutes",
                    "is_night_shift",
                    "rest_days",
                    "total_hours",
                    "is_flexible"
                ],
                "title": "WorkShiftResource"
            },
            "WorkflowStepResource": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "step_order": {
                        "type": "integer"
                    },
                    "name": {
                        "type": "string"
                    },
                    "approver_resolution": {
                        "type": "string"
                    },
                    "approver_reference_id": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "approver_label": {
                        "type": "string"
                    },
                    "approval_mode": {
                        "type": "string"
                    },
                    "condition": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": {}
                    }
                },
                "required": [
                    "id",
                    "step_order",
                    "name",
                    "approver_resolution",
                    "approver_reference_id",
                    "approver_label",
                    "approval_mode",
                    "condition"
                ],
                "title": "WorkflowStepResource"
            },
            "WorkflowStepUpdateRequest": {
                "type": "object",
                "properties": {
                    "approver_resolution": {
                        "type": "string",
                        "enum": [
                            "immediate_supervisor",
                            "department_head",
                            "role",
                            "named_user"
                        ]
                    },
                    "approver_reference_id": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "approver_resolution"
                ],
                "title": "WorkflowStepUpdateRequest"
            }
        },
        "responses": {
            "AuthorizationException": {
                "description": "Authorization error",
                "content": {
                    "application\/json": {
                        "schema": {
                            "type": "object",
                            "properties": {
                                "message": {
                                    "type": "string",
                                    "description": "Error overview."
                                }
                            },
                            "required": [
                                "message"
                            ]
                        }
                    }
                }
            },
            "AuthenticationException": {
                "description": "Unauthenticated",
                "content": {
                    "application\/json": {
                        "schema": {
                            "type": "object",
                            "properties": {
                                "message": {
                                    "type": "string",
                                    "description": "Error overview."
                                }
                            },
                            "required": [
                                "message"
                            ]
                        }
                    }
                }
            },
            "ValidationException": {
                "description": "Validation error",
                "content": {
                    "application\/json": {
                        "schema": {
                            "type": "object",
                            "properties": {
                                "message": {
                                    "type": "string",
                                    "description": "Errors overview."
                                },
                                "errors": {
                                    "type": "object",
                                    "description": "A detailed description of each field that failed validation.",
                                    "additionalProperties": {
                                        "type": "array",
                                        "items": {
                                            "type": "string"
                                        }
                                    }
                                }
                            },
                            "required": [
                                "message",
                                "errors"
                            ]
                        }
                    }
                }
            },
            "ModelNotFoundException": {
                "description": "Not found",
                "content": {
                    "application\/json": {
                        "schema": {
                            "type": "object",
                            "properties": {
                                "message": {
                                    "type": "string",
                                    "description": "Error overview."
                                }
                            },
                            "required": [
                                "message"
                            ]
                        }
                    }
                }
            }
        }
    }
}