Upload Document

<!DOCTYPE html><html lang="en" style="" data-color-mode="light" class=" useReactApp isRefPage "><head><script src="https://cdn.readme.io/public/js/force-firefox-anchor-jump.js?1732290089794"></script><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="readme-deploy" content="5.235.0"><meta name="readme-subdomain" content="personio"><meta name="readme-version" content="1.0"><title>Upload Document</title><meta name="description" content="This endpoint is responsible for uploading documents for the company employees. The Documents endpoint has a rate limit of 60 requests per minute."><meta property="og:title" content="Upload Document"><meta property="og:description" content="This endpoint is responsible for uploading documents for the company employees. The Documents endpoint has a rate limit of 60 requests per minute."><meta property="og:site_name" content="Personio Developer Hub"><meta name="twitter:title" content="Upload Document"><meta name="twitter:description" content="This endpoint is responsible for uploading documents for the company employees. The Documents endpoint has a rate limit of 60 requests per minute."><meta name="twitter:card" content="summary_large_image"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta property="og:image" content="https://files.readme.io/425c15b-small-P_DeveloperHub.png"><meta name="twitter:image" content="https://files.readme.io/425c15b-small-P_DeveloperHub.png"><link id="favicon" rel="shortcut icon" href="https://files.readme.io/4d285de-Favicon.svg" type="image/svg+xml"><link rel="canonical" href="https://developer.personio.de/reference/post_company-documents"><script src="https://cdn.readme.io/public/js/cash-dom.min.js?1732290089794"></script><link data-chunk="New" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/New.f8e4e9e20d429e588f3c.css"> <link data-chunk="routes-SuperHub-Routes" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-SuperHub-Routes.394c4b2f8910cf363781.css"> <link data-chunk="routes-Tutorials" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Tutorials.1d38d1ab2f3572f1dd24.css"> <link data-chunk="CustomPage" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/CustomPage.38a39d6ce8b0e2afad5a.css"> <link data-chunk="Page" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/Page.f8e4e9e20d429e588f3c.css"> <link data-chunk="routes-Discuss" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Discuss.8f79ff8c1099c5933136.css"> <link data-chunk="routes-Reference" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Reference.087102afd3bca3215f45.css"> <link data-chunk="Editor" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/Editor.c9adabeec62cc7e2bd7a.css"> <link data-chunk="routes-Doc" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Doc.921b58c17b447c4e783e.css"> <link data-chunk="routes-Landing" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Landing.c5ea43d2f4b3b926ff1f.css"> <link data-chunk="List" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/List.8b6b887d01c2343868e8.css"> <link data-chunk="routes-Changelog" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Changelog.28957affcff81e852361.css"> <link data-chunk="routes-PageNotFound" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-PageNotFound.d8afd1171cf7a455eed7.css"> <link data-chunk="Header" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/Header.1c46140f4fda4e981a8d.css"> <link data-chunk="routes-SuperHub" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-SuperHub.db8b3beb03eead84c21e.css"> <link data-chunk="routes-SuperHub" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/8263.75e3fc491ee8103c63a3.css"> <link data-chunk="routes-SuperHub" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/2395.593cd7b6ba0bdb6787a8.css"> <link data-chunk="main" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/main.2415ba38e8e5c2ba190e.css"> <link data-chunk="main" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/ui-styles.a5d24742a3656724b61d.css"> <link data-chunk="main" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/main.766cf20fa350c2c18107.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/6859.fc1496da022e612abe33.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/1802.00a1e88cc0d9da2aae1b.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/9772.1912e092b9c8785ff5c3.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/3284.6ecd6ef27e2009d3fdc7.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/7449.dae0332305a8704415a6.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/7372.aa4569536a36087cf4a9.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/9082.f9fa9ec2b80af1ef61bd.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/572.bab1eda8453360a8a761.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/5312.ca2c08ec1b75bb03c21e.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/5548.8fb1bb5d57de6c263c67.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/2395.6288c030d5183baa5a89.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/6522.057d8ea587133ae98687.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/7112.69c3d611e7e54e411b26.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/4608.3b5a227647e78e858c3f.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/8263.a563779273b90f66c0db.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/1282.591f476c316bf3670bbd.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-SuperHub.a3bb3020bf29f8f67ef8.js"> <link data-chunk="Header" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/3880.3892311d81c548cb073c.js"> <link data-chunk="Header" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/7783.48ca7ef3a5c469d97e53.js"> <link data-chunk="Header" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Header.ad57d9fcd570c04fb712.js"> <link data-chunk="routes-PageNotFound" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-PageNotFound.84a460336ee9c83a7d55.js"> <link data-chunk="Footer" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Footer.eb98b86c4279989f5a59.js"> <link data-chunk="routes-Changelog" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Changelog.3f125a62ed05cc53aec4.js"> <link data-chunk="List" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/2637.a5df1d5e240762d7981f.js"> <link data-chunk="List" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/4674.13378da16ce7b5beba66.js"> <link data-chunk="List" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/List.12cee315afa198c8e23e.js"> <link data-chunk="routes-Landing" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/4002.08d1caef58d08eaccd19.js"> <link data-chunk="routes-Landing" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Landing.f0816876bdfbbc06801a.js"> <link data-chunk="core-icons-chevron-up-down-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-chevron-up-down-svg.6aae957df71e6f4c5e24.js"> <link data-chunk="routes-Doc" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/6841.587d285d41ca8bab11b1.js"> <link data-chunk="routes-Doc" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/6722.e485c5aa155bd0f0ccf8.js"> <link data-chunk="routes-Doc" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Doc.e3a4e0817a9a640436bc.js"> <link data-chunk="core-icons-alert-circle-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-alert-circle-svg.4cee8264c97045599b56.js"> <link data-chunk="Post" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Post.cced33af5051de7f473f.js"> <link data-chunk="Editor" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Editor.002979730c36f9c65ad3.js"> <link data-chunk="core-icons-x-circle-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-x-circle-svg.abc0e0ea5b7f9dff667c.js"> <link data-chunk="core-icons-suggested-edits-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-suggested-edits-svg.8d2d8ac2fd22ded9238d.js"> <link data-chunk="routes-Reference" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/7971.db270c2970b791e38435.js"> <link data-chunk="routes-Reference" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/153.e4db5a313c7d51383015.js"> <link data-chunk="routes-Reference" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Reference.d66a49f09580aafdabb6.js"> <link data-chunk="core-icons-more-vertical-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-more-vertical-svg.4822b3f831e11095980d.js"> <link data-chunk="core-icons-lock-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-lock-svg.70942d3ee6bad6267696.js"> <link data-chunk="core-icons-arrow-right-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-arrow-right-svg.eadb74658f93b4e7d75f.js"> <link data-chunk="routes-Discuss" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Discuss.6a5b69949f194448cf4f.js"> <link data-chunk="Page" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Page.65c6f721688901333944.js"> <link data-chunk="CustomPage" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/6922.e8247ef6931a72e55b3e.js"> <link data-chunk="CustomPage" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/2859.94b03b9a9585460aa921.js"> <link data-chunk="core-icons-arrow-up-right-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-arrow-up-right-svg.8ec73f7e322d79a2695b.js"> <link data-chunk="routes-Tutorials" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Tutorials.8adf2bf8562dfeff14b4.js"> <link data-chunk="core-icons-chevron-down-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-chevron-down-svg.e20b84e9871bd73d1b8c.js"> <link data-chunk="core-icons-search-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-search-svg.ad9cac962958d30983a7.js"> <link data-chunk="core-icons-custom-pages-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-custom-pages-svg.444e514638d9afbec182.js"> <link data-chunk="routes-SuperHub-Routes" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/7285.703d773b1bb63ae6e7ee.js"> <link data-chunk="routes-SuperHub-Routes" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-SuperHub-Routes.5ccfbee71da134a1eeba.js"> <link data-chunk="core-icons-star-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-star-svg.b834e1612cb2af1e174e.js"> <link data-chunk="core-icons-trending-up-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-trending-up-svg.0dd920b0698e57f75afa.js"> <link data-chunk="core-icons-callout-info-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-callout-info-svg.79b14e8568c9cecbc827.js"> <link data-chunk="rmdx" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/rmdx.594ae0fac8012b876a80.js"> <link data-chunk="core-icons-webhook-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-webhook-svg.fe540ea1c09e1c0e0247.js"> <link data-chunk="core-icons-message-circle-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-message-circle-svg.1e24c2d2eb4f9a6ede5d.js"> <link data-chunk="New" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/New.908bc26e77bebc585452.js"> <link data-chunk="core-icons-eye-off-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-eye-off-svg.b2b8b241b4b324dfd9c1.js"> <link data-chunk="main" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/ui-styles.a5d24742a3656724b61d.css"> <link data-chunk="main" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/main.2415ba38e8e5c2ba190e.css"> <link data-chunk="routes-SuperHub" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/2395.593cd7b6ba0bdb6787a8.css"> <link data-chunk="routes-SuperHub" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/8263.75e3fc491ee8103c63a3.css"> <link data-chunk="routes-SuperHub" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-SuperHub.db8b3beb03eead84c21e.css"> <link data-chunk="Header" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/Header.1c46140f4fda4e981a8d.css"> <link data-chunk="routes-PageNotFound" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-PageNotFound.d8afd1171cf7a455eed7.css"> <link data-chunk="routes-Changelog" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Changelog.28957affcff81e852361.css"> <link data-chunk="List" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/List.8b6b887d01c2343868e8.css"> <link data-chunk="routes-Landing" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Landing.c5ea43d2f4b3b926ff1f.css"> <link data-chunk="routes-Doc" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Doc.921b58c17b447c4e783e.css"> <link data-chunk="Editor" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/Editor.c9adabeec62cc7e2bd7a.css"> <link data-chunk="routes-Reference" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Reference.087102afd3bca3215f45.css"> <link data-chunk="routes-Discuss" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Discuss.8f79ff8c1099c5933136.css"> <link data-chunk="Page" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/Page.f8e4e9e20d429e588f3c.css"> <link data-chunk="CustomPage" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/CustomPage.38a39d6ce8b0e2afad5a.css"> <link data-chunk="routes-Tutorials" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Tutorials.1d38d1ab2f3572f1dd24.css"> <link data-chunk="routes-SuperHub-Routes" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-SuperHub-Routes.394c4b2f8910cf363781.css"> <link data-chunk="New" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/New.f8e4e9e20d429e588f3c.css"><style title="rm-custom-css">:root{--project-color-primary:#000000;--project-color-inverse:#fff;--recipe-button-color:#000000;--recipe-button-color-hover:#000000;--recipe-button-color-active:#000000;--recipe-button-color-focus:rgba(0, 0, 0, 0.25);--recipe-button-color-disabled:#666666}[id=enterprise] .ReadMeUI[is=AlgoliaSearch]{--project-color-primary:#000000;--project-color-inverse:#fff}a{color:var(--color-link-primary,#000)}a:hover{color:var(--color-link-primary-darken-5,#000)}a.text-muted:hover{color:var(--color-link-primary,#000)}.btn.btn-primary{background-color:#000}.btn.btn-primary:hover{background-color:#000}.theme-line #hub-landing-top h2{color:#000}#hub-landing-top .btn:hover{color:#000}.theme-line #hub-landing-top .btn:hover{color:#fff}.theme-solid header#hub-header #header-top{background-color:#000}.theme-solid.header-gradient header#hub-header #header-top{background:linear-gradient(to bottom,#000,#000)}.theme-solid.header-custom header#hub-header #header-top{background-image:url(undefined)}.theme-line header#hub-header #header-top{border-bottom-color:#000}.theme-line header#hub-header #header-top .btn{background-color:#000}header#hub-header #header-top #header-logo{width:260px;height:32px;margin-top:4px;background-image:url(https://files.readme.io/425c15b-small-P_DeveloperHub.png)}#hub-subheader-parent #hub-subheader .hub-subheader-breadcrumbs .dropdown-menu a:hover{background-color:#000}#subheader-links a.active{color:#000!important;box-shadow:inset 0 -2px 0 #000}#subheader-links a:hover{color:#000!important;box-shadow:inset 0 -2px 0 #000;opacity:.7}.discussion .submit-vote.submit-vote-parent.voted a.submit-vote-button{background-color:#000}section#hub-discuss .discussion a .discuss-body h4{color:#000}section#hub-discuss .discussion a:hover .discuss-body h4{color:#000}#hub-subheader-parent #hub-subheader.sticky-header.sticky{border-bottom-color:#000}#hub-subheader-parent #hub-subheader.sticky-header.sticky .search-box{border-bottom-color:#000}#hub-search-results h3 em{color:#000}.main_background,.tag-item{background:#000!important}.main_background:hover{background:#000!important}.main_color{color:#000!important}.border_bottom_main_color{border-bottom:2px solid #000}.main_color_hover:hover{color:#000!important}section#hub-discuss h1{color:#000}#hub-reference .hub-api .api-definition .api-try-it-out.active{border-color:#000;background-color:#000}#hub-reference .hub-api .api-definition .api-try-it-out.active:hover{background-color:#000;border-color:#000}#hub-reference .hub-api .api-definition .api-try-it-out:hover{border-color:#000;color:#000}#hub-reference .hub-reference .logs .logs-empty .logs-login-button,#hub-reference .hub-reference .logs .logs-login .logs-login-button{background-color:var(--project-color-primary,#000);border-color:var(--project-color-primary,#000)}#hub-reference .hub-reference .logs .logs-empty .logs-login-button:hover,#hub-reference .hub-reference .logs .logs-login .logs-login-button:hover{background-color:#000;border-color:#000}#hub-reference .hub-reference .logs .logs-empty>svg>path,#hub-reference .hub-reference .logs .logs-login>svg>path{fill:#000;fill:var(--project-color-primary,#000)}#hub-reference .hub-reference .logs:last-child .logs-empty,#hub-reference .hub-reference .logs:last-child .logs-login{margin-bottom:35px}#hub-reference .hub-reference .hub-reference-section .hub-reference-left header .hub-reference-edit:hover{color:#000}.main-color-accent{border-bottom:3px solid #000;padding-bottom:8px}/*! BEGIN HUB_CUSTOM_STYLES */.hub-reference-left>div.magic-block-callout,.hub-reference-left>div.magic-block-textarea{margin-top:30px}body{font-family:Inter,-apple-system,system-ui,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif!important}a{color:#000;font-weight:600}img.rm-Logo-img{height:0;width:0;padding:0 189px 23px 0;background-image:url(https://files.readme.io/4e0e706-small-PDark.png);background-size:cover}header.rm-Header{position:sticky;top:0;box-shadow:none;-webkit-box-shadow:none}.Header-topuTMpygDG4e1V .rm-SearchToggle-icon,div.rm-Header-left button.icon-menu,div.rm-Header-left div{color:#fff!important}div.rm-Header-top{border:none;background:#000}div.rm-Header-top a.Button{color:#fff}div.rm-Header-top a.Button:active,div.rm-Header-top a.Button:hover{color:#fff!important;text-decoration:underline}div.rm-Header-bottom{border:none;background-color:#fff}@media only screen and (max-width:768px){a.Button.rm-Header-top-link{display:none}}a.Button.rm-Header-bottom-link{color:#000!important;font-weight:400}a.Button.rm-Header-bottom-link.active{background:0 0;border-bottom:2px solid #000;font-weight:600}#main-landing-section{margin:15px 0}#main-landing-section mark{border-radius:23px;background:#ff0;padding:1px 6px}.btn.btn-primary{background-color:#0db5df!important}.btn.btn-secondary{background-color:#f4f7f9!important;color:#555!important}h2.heading{font-family:InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;font-size:24px;font-weight:700;line-height:32px;color:#2d3747}h3.heading{font-family:InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;font-size:18px;font-weight:700;line-height:24px;color:#2d3747}*{box-sizing:border-box}.column{float:left;width:50%;padding:0 30px}.row-card{margin:0 -30px}@media screen and (max-width:600px){.column{width:100%;display:block;margin-bottom:20px}}.card{box-shadow:0 13px 13px 0 rgba(0,0,0,.04);padding:35px;text-align:left;background:#fff;border-radius:8px;border:1px solid #dce6ec}.card h2{font-size:22px;margin:0;margin-top:0!important}.card p{font-size:16px;line-height:24px}.card a{margin:0}nav#hub-sidebar ul a.active,nav#hub-sidebar ul>li.subnav-expanded>a{color:#555;background-color:#cff0f9;font-weight:500}.callout.callout_info{border-left:3px solid #0b98bb;border-radius:4px}.hub-changelog-list .changelog-post h3{font-family:InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;font-size:18px;font-weight:700;line-height:24px;color:#2d3747}#changelog-type-icon.cl-improved,.icon-changelog-type.cl-improved{background-color:#0db5df}#readmeLogo{display:none}/*! END HUB_CUSTOM_STYLES */</style><meta name="loadedProject" content="personio"><script>var storedColorMode = `light` === 'system' ? window.localStorage.getItem('color-scheme') : `light` document.querySelector('[data-color-mode]').setAttribute('data-color-mode', storedColorMode)</script><script id="config" type="application/json" data-json="{"algoliaIndex":"readme_search_v2","amplitude":{"apiKey":"dc8065a65ef83d6ad23e37aaf014fc84","enabled":true},"asset_url":"https://cdn.readme.io","domain":"readme.io","domainFull":"https://dash.readme.com","encryptedLocalStorageKey":"ekfls-2024-05","fullstory":{"enabled":true,"orgId":"FSV9A"},"metrics":{"billingCronEnabled":"true","dashUrl":"https://m.readme.io","defaultUrl":"https://m.readme.io","exportMaxRetries":12,"wsUrl":"wss://m.readme.io"},"proxyUrl":"https://try.readme.io","readmeRecaptchaSiteKey":"6LesVBYpAAAAAESOCHOyo2kF9SZXPVb54Nwf3i2x","releaseVersion":"5.235.0","sentry":{"dsn":"https://3bbe57a973254129bcb93e47dc0cc46f@o343074.ingest.sentry.io/2052166","enabled":true,"tracesSampleRate":0},"shMigration":{"promoVideo":"","forceWaitlist":false},"sslBaseDomain":"readmessl.com","sslGenerationService":"ssl.readmessl.com","stripePk":"pk_live_5103PML2qXbDukVh7GDAkQoR4NSuLqy8idd5xtdm9407XdPR6o3bo663C1ruEGhXJjpnb2YCpj8EU1UvQYanuCjtr00t1DRCf2a","superHub":{"newProjectsEnabled":true},"wootric":{"accountToken":"NPS-122b75a4","enabled":true}}"></script></head><body class="body-none theme-line header-solid header-bg-size-auto header-bg-pos-tl header-overlay-triangles reference-layout-column lumosity-dark hub-full"><div id="ssr-top"></div><div id="ssr-main"><div class="App ThemeContext ThemeContext_dark ThemeContext_line" style="--color-primary:#000000;--color-primary-inverse:#fff;--color-primary-alt:#000000;--color-primary-darken-10:#000000;--color-primary-darken-20:#000000;--color-primary-alpha-25:rgba(0, 0, 0, 0.25);--color-link-primary:#000000;--color-link-primary-darken-5:#000000;--color-link-primary-darken-10:#000000;--color-link-primary-darken-20:#000000;--color-link-primary-alpha-50:rgba(0, 0, 0, 0.5);--color-link-primary-alpha-25:rgba(0, 0, 0, 0.25);--color-link-background:rgba(0, 0, 0, 0.09);--color-link-text:#fff;--color-login-link:#018ef5;--color-login-link-text:#fff;--color-login-link-darken-10:#0171c2;--color-login-link-primary-alpha-50:rgba(1, 142, 245, 0.5)"><header class="Header3zzata9F_ZPQ rm-Header "><div class="rm-Header-top Header-topuTMpygDG4e1V"><div class="rm-Container rm-Container_flex"><div style="outline:none" tabindex="-1"><a href="#content" target="_self" class="Button Button_md rm-JumpTo Header-jumpTo3IWKQXmhSI5D Button_primary">Jump to Content</a></div><div class="rm-Header-left Header-leftADQdGVqx1wqU"><a class="rm-Logo Header-logo1Xy41PtkzbdG" href="/" target="_self"><img alt="Personio Developer Hub" class="rm-Logo-img Header-logo-img3YvV4lcGKkeb" src="https://files.readme.io/425c15b-small-P_DeveloperHub.png"/></a></div><div class="rm-Header-left Header-leftADQdGVqx1wqU Header-left_mobile1RG-X93lx6PF"><div><button aria-label="Toggle navigation menu" class="icon-menu menu3d6DYNDa3tk5" type="button"></button><div class=""><div class="Flyout95xhYIIoTKtc undefined rm-Flyout" data-testid="flyout"><div class="MobileFlyout1hHJpUd-nYkd"><a class="rm-MobileFlyout-item NavItem-item1gDDTqaXGhm1 NavItem-item_mobile1qG3gd-Mkck- " href="/" target="_self"><i class="icon-landing-page-2 NavItem-badge1qOxpfTiALoz"></i><span class="NavItem-textSlZuuL489uiw">Home</span></a><a class="rm-MobileFlyout-item NavItem-item1gDDTqaXGhm1 NavItem-item_mobile1qG3gd-Mkck- " href="/docs" target="_self"><i class="icon-guides NavItem-badge1qOxpfTiALoz"></i><span class="NavItem-textSlZuuL489uiw">Documentation</span></a><a aria-current="page" class="rm-MobileFlyout-item NavItem-item1gDDTqaXGhm1 NavItem-item_mobile1qG3gd-Mkck- active" href="/reference" target="_self"><i class="icon-references NavItem-badge1qOxpfTiALoz"></i><span class="NavItem-textSlZuuL489uiw">API Reference</span></a><a class="rm-MobileFlyout-item NavItem-item1gDDTqaXGhm1 NavItem-item_mobile1qG3gd-Mkck- " href="/changelog" target="_self"><i class="icon-changelog NavItem-badge1qOxpfTiALoz"></i><span class="NavItem-textSlZuuL489uiw">Changelog</span></a><a class="rm-MobileFlyout-item NavItem-item1gDDTqaXGhm1 NavItem-item_mobile1qG3gd-Mkck- " href="/discuss" target="_self"><i class="icon-discussions NavItem-badge1qOxpfTiALoz"></i><span class="NavItem-textSlZuuL489uiw">Discussions</span></a><select class="Select Select_md NavItem-item1gDDTqaXGhm1 NavItem-item_select3UEfLN-oSjxp NavItem-item_mobile1qG3gd-Mkck-"><option selected="" data-url="#" value="1.0">v1.0</option><option data-url="/v2.0/reference" value="2.0">v2.0</option></select><hr class="MobileFlyout-divider10xf7R2X1MeW"/><a class="rm-MobileFlyout-item NavItem-item1gDDTqaXGhm1 NavItem-item_mobile1qG3gd-Mkck- NavItem_dropdown-muted1xJVuczwGc74" href="https://www.personio.com/partner/tech/" rel="noopener" target="_blank" to="https://www.personio.com/partner/tech/">Become a Partner</a><a class="MobileFlyout-logo3Lq1eTlk1K76 Header-logo1Xy41PtkzbdG rm-Logo" href="/" target="_self"><img alt="Personio Developer Hub" class="Header-logo-img3YvV4lcGKkeb rm-Logo-img" src="https://files.readme.io/425c15b-small-P_DeveloperHub.png"/></a></div></div></div></div><div class="Header-left-nav2xWPWMNHOGf_"><i class="icon-references Header-left-nav-icon10glJKFwewOv"></i>API Reference</div></div><div class="rm-Header-right Header-right21PC2XTT6aMg"><span class="Header-right_desktop14ja01RUQ7HE"><a class="Button Button_md rm-Header-link rm-Header-top-link Button_slate_text Header-link2tXYTgXq85zW" href="https://www.personio.com/partner/tech/" target="_self" to="https://www.personio.com/partner/tech/">Become a Partner</a></span><div class="Header-searchtb6Foi0-D9Vx"><button aria-label="Search" class="rm-SearchToggle" data-symbol="⌘"><div class="rm-SearchToggle-icon icon-search1"></div></button></div></div></div></div><div class="Header-bottom2eLKOFXMEmh5 rm-Header-bottom "><div class="rm-Container rm-Container_flex"><nav class="Header-leftADQdGVqx1wqU"><div class="rm-VersionDropdown Dropdown Dropdown_closed"><button aria-haspopup="dialog" class="Button Button_slate_text Button_md rm-Header-bottom-link Dropdown-toggle Button_primary" type="button"><span>v1.0</span><i class="icon icon-chevron-down"></i></button></div><a class="Button Button_md rm-Header-link rm-Header-bottom-link Button_slate_text Header-bottom-link_mobile " href="/" target="_self"><i class="icon-landing-page-2"></i><span>Home</span></a><a class="Button Button_md rm-Header-link rm-Header-bottom-link Button_slate_text Header-bottom-link_mobile " href="/docs" target="_self"><i class="icon-guides"></i><span>Documentation</span></a><a aria-current="page" class="Button Button_md rm-Header-link rm-Header-bottom-link Button_slate_text Header-bottom-link_mobile active" href="/reference" target="_self"><i class="icon-references"></i><span>API Reference</span></a><a class="Button Button_md rm-Header-link rm-Header-bottom-link Button_slate_text Header-bottom-link_mobile " href="/changelog" target="_self"><i class="icon-changelog"></i><span>Changelog</span></a><a class="Button Button_md rm-Header-link rm-Header-bottom-link Button_slate_text Header-bottom-link_mobile " href="/discuss" target="_self"><i class="icon-discussions"></i><span>Discussions</span></a></nav><button align="center" justify="between" style="--flex-gap:var(--xs)" class="Button Button_sm Flex Flex_row MobileSubnav1DsTfasXloM2 Button_contrast Button_contrast_outline" type="button"><span class="Button-label">Upload Document</span><span class="IconWrapper Icon-wrapper2z2wVIeGsiUy"><svg fill="none" viewBox="0 0 24 24" class="Icon Icon3_D2ysxFZ_ll Icon-svg2Lm7f6G9Ly5a" data-name="chevron-up-down" role="img" style="--icon-color:inherit;--icon-size:inherit;--icon-stroke-width:2px"><path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" d="m6 16 6 6 6-6M18 8l-6-6-6 6" class="icon-stroke-width"></path></svg></span></button><div class="rm-Header-search Header-searchtb6Foi0-D9Vx rm-Header-search_feather Header-search_featherYsmQBn55F3d9"><button aria-label="Search" class="rm-SearchToggle" data-symbol="⌘"><div class="rm-SearchToggle-icon icon-search1"></div><div class="Header-search-placeholder3Vx4OmMPcjAi rm-SearchToggle-placeholder">Search</div><div class="rm-SearchToggle-shortcut"></div></button></div></div></div><div class="hub-search-results--reactApp " id="hub-search-results"><div class="hub-container"><div class="modal-backdrop show-modal rm-SearchModal" role="button" tabindex="0"></div></div></div></header><main class="rm-ReferenceMain rm-Container rm-Container_flex loading" id="Explorer"><nav aria-label="Page navigation" class="rm-Sidebar hub-sidebar reference-redesign Nav3C5f8FcjkaHj" id="reference-sidebar"><div class="Main-QuickNav-container1OiLvjSDusO6"><button aria-keyshortcuts="Control+/ Meta+/" class="QuickNav1q-OoMjiX_Yr QuickNav-button2KzlQbz5Pm2Y">JUMP TO</button></div><div class="Sidebar1t2G1ZJq-vU1 rm-Sidebar hub-sidebar-content"><section class="Sidebar-listWrapper6Q9_yUrG906C rm-Sidebar-section"><h2 class="Sidebar-headingTRQyOa2pk0gh rm-Sidebar-heading">Overview</h2><ul class="Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/reference/introduction"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Introduction</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/reference/include-our-headers-in-your-requests"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Include our headers in your requests</span></span></a></li></ul></section><section class="Sidebar-listWrapper6Q9_yUrG906C rm-Sidebar-section"><h2 class="Sidebar-headingTRQyOa2pk0gh rm-Sidebar-heading">Authentication</h2><ul class="Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/auth"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for Auth" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Auth</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/post_auth"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">/auth</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">post</span></span></a></li></ul></li></ul></section><section class="Sidebar-listWrapper6Q9_yUrG906C rm-Sidebar-section"><h2 class="Sidebar-headingTRQyOa2pk0gh rm-Sidebar-heading">Personnel Data</h2><ul class="Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-employees"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for Employees" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Employees</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-employees"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Employees</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/post_company-employees"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Create an Employee</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">post</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/patch_company-employees-employee-id"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Update Employee by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_patch Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">patch</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-employees-employee-id"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Get Employee by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-employees-employee-id-absences-balance"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Get Absence Balance for Employee</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-employees-custom-attributes"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Allowed Custom Attributes</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-employees-attributes"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Allowed Attributes</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-employees-employee-id-profile-picture-width"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Get Employee Profile Picture</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li></ul></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-attendances"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for Attendances" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Attendances</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-attendances"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Attendances</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/post_company-attendances"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Create an Attendance</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">post</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/delete_company-attendances-id"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Delete Attendance by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_delete Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">delete</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/patch_company-attendances-id"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Update Attendance by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_patch Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">patch</span></span></a></li></ul></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-attendances-projects"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for Projects" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Projects</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-attendances-projects"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Projects</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/post_company-attendances-projects"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Create a Project</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">post</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/delete_company-attendances-projects-id"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Delete Project by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_delete Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">delete</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/patch_company-attendances-projects-id"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Update Project by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_patch Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">patch</span></span></a></li></ul></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-time-off-types"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for Absences" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Absences</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-time-off-types"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Time-Off Types</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-time-offs"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Time-Offs</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/post_company-time-offs"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Create a Time-Off</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">post</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/delete_company-time-offs-id"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Delete Time-Off by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_delete Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">delete</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-time-offs-id"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Get Time-Off by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-absence-periods"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Absence Periods</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/post_company-absence-periods"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Create an Absence Period</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">post</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/delete_company-absence-periods-id"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Delete Absence Period by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_delete Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">delete</span></span></a></li></ul></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-document-categories"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for Documents" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Documents</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-document-categories"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Document Categories</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a aria-current="page" class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link active" target="_self" href="/reference/post_company-documents"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Upload Document</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">post</span></span></a></li></ul></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/listreports"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for Custom Reports" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Custom Reports</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/listreports"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Custom Reports</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/listreportitems"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Get Custom Report by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/listcolumns"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Custom Report Column Labels</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li></ul></li></ul></section><section class="Sidebar-listWrapper6Q9_yUrG906C rm-Sidebar-section"><h2 class="Sidebar-headingTRQyOa2pk0gh rm-Sidebar-heading">Recruiting</h2><ul class="Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/reference/introduction-1"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Introduction</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/get_xml"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for XML" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">XML</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_xml"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Retrieve open positions</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li></ul></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/post_v1-recruiting-applications"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for Application" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Application</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/post_v1-recruiting-applications"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Creating applications in Personio</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">post</span></span></a></li></ul></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/post_v1-recruiting-applications-documents"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for Application Documents" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Application Documents</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/post_v1-recruiting-applications-documents"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Upload documents to be attached to applications</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">post</span></span></a></li></ul></li></ul></section><div class="readme-logo" id="readmeLogo">Powered by <a aria-label="ReadMe" href="https://readme.com?ref_src=hub&project=personio" style="color:unset"><i class="icon icon-readme" style="display:inline-block;min-width:71px"></i></a></div></div></nav><article class="rm-Article" id="content"><header class="headline-container21aRBSn8Bqg6 " data-raycast-oas="[object Object]"><div class="headline-container-grid-itemGdPV-VbhShYs button-containerobFfV0vf6giV"><div class="reference-flyout"><button aria-label="Toggle reference sidebar" class="icon-menu reference-sidebar-mobile-button26mqim6Chewq " type="button"></button><div class=""><div class="Flyout95xhYIIoTKtc undefined rm-Flyout" data-testid="flyout"><nav aria-label="Page navigation" class="rm-Sidebar hub-sidebar reference-redesign Nav3C5f8FcjkaHj mobile" id="reference-sidebar"><div class="ref-QuickNav-mobile-containerARtvyEDVpRhW"><button aria-keyshortcuts="Control+/ Meta+/" class="QuickNav1q-OoMjiX_Yr QuickNav-button2KzlQbz5Pm2Y">JUMP TO</button></div><div class="Sidebar1t2G1ZJq-vU1 rm-Sidebar hub-sidebar-content"><section class="Sidebar-listWrapper6Q9_yUrG906C rm-Sidebar-section"><h2 class="Sidebar-headingTRQyOa2pk0gh rm-Sidebar-heading">Overview</h2><ul class="Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/reference/introduction"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Introduction</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/reference/include-our-headers-in-your-requests"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Include our headers in your requests</span></span></a></li></ul></section><section class="Sidebar-listWrapper6Q9_yUrG906C rm-Sidebar-section"><h2 class="Sidebar-headingTRQyOa2pk0gh rm-Sidebar-heading">Authentication</h2><ul class="Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/auth"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for Auth" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Auth</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/post_auth"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">/auth</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">post</span></span></a></li></ul></li></ul></section><section class="Sidebar-listWrapper6Q9_yUrG906C rm-Sidebar-section"><h2 class="Sidebar-headingTRQyOa2pk0gh rm-Sidebar-heading">Personnel Data</h2><ul class="Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-employees"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for Employees" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Employees</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-employees"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Employees</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/post_company-employees"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Create an Employee</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">post</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/patch_company-employees-employee-id"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Update Employee by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_patch Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">patch</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-employees-employee-id"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Get Employee by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-employees-employee-id-absences-balance"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Get Absence Balance for Employee</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-employees-custom-attributes"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Allowed Custom Attributes</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-employees-attributes"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Allowed Attributes</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-employees-employee-id-profile-picture-width"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Get Employee Profile Picture</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li></ul></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-attendances"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for Attendances" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Attendances</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-attendances"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Attendances</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/post_company-attendances"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Create an Attendance</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">post</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/delete_company-attendances-id"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Delete Attendance by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_delete Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">delete</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/patch_company-attendances-id"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Update Attendance by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_patch Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">patch</span></span></a></li></ul></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-attendances-projects"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for Projects" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Projects</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-attendances-projects"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Projects</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/post_company-attendances-projects"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Create a Project</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">post</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/delete_company-attendances-projects-id"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Delete Project by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_delete Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">delete</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/patch_company-attendances-projects-id"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Update Project by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_patch Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">patch</span></span></a></li></ul></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-time-off-types"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for Absences" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Absences</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-time-off-types"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Time-Off Types</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-time-offs"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Time-Offs</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/post_company-time-offs"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Create a Time-Off</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">post</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/delete_company-time-offs-id"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Delete Time-Off by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_delete Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">delete</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-time-offs-id"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Get Time-Off by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-absence-periods"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Absence Periods</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/post_company-absence-periods"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Create an Absence Period</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">post</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/delete_company-absence-periods-id"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Delete Absence Period by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_delete Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">delete</span></span></a></li></ul></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-document-categories"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for Documents" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Documents</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_company-document-categories"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Document Categories</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a aria-current="page" class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link active" target="_self" href="/reference/post_company-documents"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Upload Document</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">post</span></span></a></li></ul></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/listreports"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for Custom Reports" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Custom Reports</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/listreports"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Custom Reports</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/listreportitems"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Get Custom Report by ID</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/listcolumns"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">List Custom Report Column Labels</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li></ul></li></ul></section><section class="Sidebar-listWrapper6Q9_yUrG906C rm-Sidebar-section"><h2 class="Sidebar-headingTRQyOa2pk0gh rm-Sidebar-heading">Recruiting</h2><ul class="Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/reference/introduction-1"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Introduction</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/get_xml"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for XML" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">XML</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/get_xml"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Retrieve open positions</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_get Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">get</span></span></a></li></ul></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/post_v1-recruiting-applications"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for Application" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Application</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/post_v1-recruiting-applications"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Creating applications in Personio</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">post</span></span></a></li></ul></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 Sidebar-link_parent3OBrzjAJRSfq text-wrap rm-Sidebar-link" target="_self" href="/reference/post_v1-recruiting-applications-documents"><span class="Sidebar-link-textLuTE1ySm4Kqn"><button aria-expanded="false" aria-label="Show subpages for Application Documents" class="Sidebar-link-buttonWrapper3hnFHNku8_BJ"><i class="Sidebar-link-expandIcon2yVH6SarI6NW icon-chevron-rightward"></i></button><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Application Documents</span></span></a><ul class="subpages Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless subpage text-wrap rm-Sidebar-link" target="_self" href="/reference/post_v1-recruiting-applications-documents"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Upload documents to be attached to applications</span></span><span class="Sidebar-method-container2yBYD-KB_IfC"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post Sidebar-methodfUM3m6FEWm6w" data-testid="http-method">post</span></span></a></li></ul></li></ul></section><div class="readme-logo" id="readmeLogo">Powered by <a aria-label="ReadMe" href="https://readme.com?ref_src=hub&project=personio" style="color:unset"><i class="icon icon-readme" style="display:inline-block;min-width:71px"></i></a></div></div></nav></div></div></div><header id="content-head"><h1>Upload Document</h1></header></div><div class="headline-container-article-info2GaOf2jMpV0r"><span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post headline-container-api-method1Hc-Fm7uaccR" data-testid="http-method">post</span> <span class="headline-container-article-info-url2nV_XrjpFuVQ" data-testid="serverurl" title="https://api.personio.de/v1/company/documents">https://api.personio.de/v1/company/documents</span></div><div role="doc-subtitle" class="rm-Markdown markdown-body undefined excerptT2m-MzSJGRK7" data-testid="RDMD"><p>This endpoint is responsible for uploading documents for the company employees.<br/> The Documents endpoint has a rate limit of 60 requests per minute.</p></div></header><div class="ModalWrapper" id="response-schema-modal-target"></div></article><div id="ReferencePlayground" class="rm-Playground PlaygroundC7DInM9NFvBg "><section class="Playground-section3VTXuaYZivJK " data-notranslate="true"><header class="APISectionHeader3LN_-QIR0m7x rm-APISectionHeader"><div class="APISectionHeader-heading4MUMLbp4_nLs">Language</div></header><div class="LanguagePickerSIxXDuYmeYsW rm-LanguagePicker"><div class="LanguagePicker-languages1qVVo_v6AlP9"><button class="LanguagePicker-button1E91woqg9Y0e rm-LanguageButton_active rm-LanguageButton" type="button"><i class="LanguagePicker-button-icon1vy2AqvvY7se icon-curl"><span class="path1"></span><span class="path2"></span><span class="path3"></span><span class="path4"></span><span class="path5"></span><span class="path6"></span><span class="path7"></span><span class="path8"></span></i>Shell</button><button class="LanguagePicker-button1E91woqg9Y0e rm-LanguageButton" type="button"><i class="LanguagePicker-button-icon1vy2AqvvY7se icon-python"><span class="path1"></span><span class="path2"></span><span class="path3"></span><span class="path4"></span><span class="path5"></span><span class="path6"></span><span class="path7"></span><span class="path8"></span></i>Python</button><button class="LanguagePicker-button1E91woqg9Y0e rm-LanguageButton" type="button"><i class="LanguagePicker-button-icon1vy2AqvvY7se icon-ruby"><span class="path1"></span><span class="path2"></span><span class="path3"></span><span class="path4"></span><span class="path5"></span><span class="path6"></span><span class="path7"></span><span class="path8"></span></i>Ruby</button><button class="LanguagePicker-button1E91woqg9Y0e rm-LanguageButton" type="button"><i class="LanguagePicker-button-icon1vy2AqvvY7se icon-java"><span class="path1"></span><span class="path2"></span><span class="path3"></span><span class="path4"></span><span class="path5"></span><span class="path6"></span><span class="path7"></span><span class="path8"></span></i>Java</button><button class="LanguagePicker-button1E91woqg9Y0e rm-LanguageButton" type="button"><i class="LanguagePicker-button-icon1vy2AqvvY7se icon-php"><span class="path1"></span><span class="path2"></span><span class="path3"></span><span class="path4"></span><span class="path5"></span><span class="path6"></span><span class="path7"></span><span class="path8"></span></i>PHP</button><div class="LanguagePicker-divider Dropdown Dropdown_closed"><button aria-label="More Languages" aria-haspopup="dialog" class="Button Button_md LanguagePicker-more2w3Eqm0IH_K7 rm-LanguageButton-more Dropdown-toggle Button_primary_ghost Button_primary" type="button"><span class="IconWrapper Icon-wrapper2z2wVIeGsiUy"><svg fill="none" viewBox="0 0 24 24" class="Icon Icon3_D2ysxFZ_ll Icon-svg2Lm7f6G9Ly5a" data-name="more-vertical" role="img" style="--icon-color:inherit;--icon-size:inherit;--icon-stroke-width:2px" aria-label="More ellipsis"><path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" d="M12 13a1 1 0 1 0 0-2 1 1 0 0 0 0 2ZM12 6a1 1 0 1 0 0-2 1 1 0 0 0 0 2ZM12 20a1 1 0 1 0 0-2 1 1 0 0 0 0 2Z" class="icon-stroke-width"></path></svg></span></button></div></div></div></section><section class="Playground-section3VTXuaYZivJK " data-notranslate="true"><section class="APIAuth rm-APIAuth" data-testid="api-auth"><header class="APISectionHeader3LN_-QIR0m7x rm-APISectionHeader"><div class="APISectionHeader-heading4MUMLbp4_nLs">Credentials</div><div><div class="Info-infoBadge3luOwOnjfNiR Info-infoBadge_tooltip24vnuq69qR2X" role="button" tabindex="0"><div>Bearer</div><i aria-label="Information" class="Info-infoBadge-icon1VOz2gcy65SK icon-info1" role="img"></i></div></div></header><section align="stretch" class="Flex Flex_row InputGroup " justify="between" style="--flex-gap:var(--xs)"><header align="start" class="Flex Flex_row InputGroup-dropdown-parent" justify="between" style="--flex-gap:var(--xs)"><div class="InputGroup-dropdown Dropdown Dropdown_closed"><button class="Button Button_sm InputGroup-button Dropdown-toggle" data-testid="api-auth-security-button" disabled="" aria-haspopup="dialog"><span>Bearer</span></button></div></header><div class="InputGroup-input-parent "><div class="InputGroup-dropdown-inputs "><input type="text" autoComplete="off" class="InputGroup-input " id="APIAuth-token" placeholder="token" required="" spellcheck="false" value=""/><button aria-label="Hide" class="Button Button_xs rm-APIAuth-lock undefined Button_minimum Button_minimum_text Button_uppercase" type="button"><span class="IconWrapper Icon-wrapper2z2wVIeGsiUy"><svg fill="none" viewBox="0 0 24 24" class="Icon Icon3_D2ysxFZ_ll Icon-svg2Lm7f6G9Ly5a" data-name="lock" role="img" style="--icon-color:inherit;--icon-size:inherit;--icon-stroke-width:2px" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" d="M19 11H5a2 2 0 0 0-2 2v7a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7a2 2 0 0 0-2-2ZM7 11V7a5 5 0 1 1 10 0v4" class="icon-stroke-width"></path></svg></span></button></div></div></section></section></section><section class="Playground-section3VTXuaYZivJK Playground-section_sticky_fBLN0qIkmEd " data-notranslate="true"><section class="APIResponse3FBSi0-qfTQs rm-PlaygroundResponse"><header align="center" class="Flex Flex_row APIResponse-header3Y3zkft15LCF" justify="between" style="--flex-gap:var(--md)"><div><button class="Button Button_xs APIResponse-header-tab31M7P70x-CKu APIResponse-header-tab-active36LB45PMYTuB APIResponse-header-tab-disabled_gfqRzz9FpgZ Button_minimum_ghost Button_minimum Button_uppercase" disabled="" type="button">RESPONSE</button></div></header><div align="center" class="Flex Flex_col APIResponse-empty3Qdzfpq_JjNF" justify="between" style="--flex-gap:var(--md)"><div>Click <code class="APIResponse-empty-tryit2H55vIRfRhS3">Try It!</code> to start a request and see the response here!</div></div></section></section></div><div class="ModalWrapper" id="response-headers-modal-root"></div><div class="ModalWrapper" id="tutorialmodal-root"></div><div class="ModalWrapper QuickNav-modal QuickNav-modal-desktop" id="QuickNav-modal-root"></div><div class="ModalWrapper QuickNav-modal QuickNav-modal-mobile" id="QuickNav-mobile-modal-root"></div></main><footer aria-label="Status banner" class="AppFooter rm-Banners"></footer><div class="ModalWrapper" id="ChatGPT-modal"></div></div></div><div class="ng-non-bindable"><script id="ssr-props" data-initial-props="{"sidebars":{"docs":[{"_id":"5cece58fa4dd7d0045f4e395","project":"58bec8f49d43720f0043fdb2","version":"58bec8f49d43720f0043fdb5","isAPI":false,"reference":false,"createdAt":"2019-05-28T07:38:55.311Z","order":0,"slug":"getting-started","title":"Getting started","__v":0,"pages":[{"_id":"5f3e3b0852f8fe03c44a757b","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"Get started with Personio API","type":"basic","slug":"getting-started-with-the-personio-api","order":0,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","createdAt":"2020-08-20T08:57:44.027Z","category":"5cece58fa4dd7d0045f4e395","parentDoc":null,"deprecated":false,"icon":"","isBodyEmpty":false,"children":[{"_id":"615ff0a0281a600023210aa0","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"API Terms & Use Policies","type":"basic","slug":"tos-api-security-1","order":0,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","createdAt":"2021-10-08T07:17:52.185Z","parentDoc":"5f3e3b0852f8fe03c44a757b","category":"5cece58fa4dd7d0045f4e395","icon":"","isBodyEmpty":false,"children":[]}]},{"_id":"63d3f6a1ac1fa202829761ec","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"Product Partner Guide","icon":"","type":"basic","slug":"ipaas-partner","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","category":"5cece58fa4dd7d0045f4e395","createdAt":"2023-01-27T16:06:57.607Z","isBodyEmpty":false,"children":[]}]},{"_id":"58bec8f59d43720f0043fdb6","version":"58bec8f49d43720f0043fdb5","from_sync":false,"isAPI":false,"reference":false,"slug":"documentation","__v":0,"createdAt":"2017-03-07T14:51:33.011Z","order":3,"project":"58bec8f49d43720f0043fdb2","title":"Recruiting","pages":[{"_id":"58d50a6246ac3225002eb4d8","category":"58bec8f59d43720f0043fdb6","slug":"retrieving-open-job-positions","link_external":false,"link_url":"","title":"Retrieving open positions","type":"basic","isReference":false,"parentDoc":null,"order":0,"sync_unique":"","api":{"params":[],"url":"","method":"get","results":{"codes":[{"language":"json","code":"{}","name":"","status":200},{"status":400,"language":"json","code":"{}","name":""}]},"auth":"required"},"createdAt":"2017-03-24T12:00:34.319Z","hidden":false,"previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":false,"children":[{"_id":"58d50d5b0e8fce23007f8069","createdAt":"2017-03-24T12:13:15.655Z","hidden":false,"sync_unique":"","parentDoc":"58d50a6246ac3225002eb4d8","type":"basic","category":"58bec8f59d43720f0043fdb6","order":0,"slug":"integration-via-iframe","title":"Integration via Iframe","api":{"auth":"required","params":[],"url":"","method":"get","results":{"codes":[{"code":"{}","name":"","status":200,"language":"json"},{"name":"","status":400,"language":"json","code":"{}"}]}},"isReference":false,"link_external":false,"link_url":"","previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":false,"children":[]},{"_id":"58d50b91a113431b00134158","link_url":"","api":{"url":"","method":"get","results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"auth":"required","params":[]},"hidden":false,"isReference":false,"title":"Integration via code","category":"58bec8f59d43720f0043fdb6","slug":"integration-of-open-positions","createdAt":"2017-03-24T12:05:37.669Z","order":1,"sync_unique":"","link_external":false,"parentDoc":"58d50a6246ac3225002eb4d8","type":"basic","previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":false,"children":[]}]},{"_id":"58bec8f59d43720f0043fdb8","parentDoc":null,"slug":"applications-endpoint","order":1,"title":"Passing applications to Personio","link_url":"","link_external":false,"sync_unique":"","api":{"auth":"required","method":"get","params":[],"results":{"codes":[{"language":"json","code":"{}","name":"","status":200},{"status":400,"language":"json","code":"{}","name":""}]},"url":""},"hidden":false,"category":"58bec8f59d43720f0043fdb6","createdAt":"2017-03-07T14:51:33.051Z","isReference":false,"type":"basic","previousSlug":"","deprecated":false,"isBodyEmpty":false,"children":[]}]},{"_id":"67239f85efa67b00103fae40","title":"Pagination adoption guide","slug":"pagination-addoption-guide","order":9999,"reference":false,"project":"58bec8f49d43720f0043fdb2","version":"58bec8f49d43720f0043fdb5","createdAt":"2024-10-31T15:17:25.347Z","__v":0,"pages":[{"_id":"67239fce99487c002ad28212","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Pagination Adoption Guide for V1 GET employees endpoint","icon":"","type":"basic","slug":"pagination-adoption-guide-for-v1-get-employees-endpoint","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","category":"67239f85efa67b00103fae40","createdAt":"2024-10-31T15:18:38.940Z","isBodyEmpty":false,"children":[]}]}],"refs":[{"_id":"58ce970ea6027e1b00db4bed","createdAt":"2017-03-19T14:34:54.117Z","from_sync":false,"order":0,"title":"Overview","__v":0,"project":"58bec8f49d43720f0043fdb2","version":"58bec8f49d43720f0043fdb5","slug":"overview","isAPI":false,"reference":true,"pages":[{"_id":"58ce9876be036c2d0087bc49","type":"basic","category":"58ce970ea6027e1b00db4bed","link_url":"","sync_unique":"","title":"Introduction","createdAt":"2017-03-19T14:40:54.670Z","parentDoc":null,"slug":"introduction","isReference":true,"api":{"method":"get","results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"auth":"required","params":[],"url":"","examples":{"codes":[]}},"hidden":false,"link_external":false,"order":0,"deprecated":false,"previousSlug":"","icon":"","isBodyEmpty":false,"children":[]},{"_id":"61e9413124a83f000f501df7","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"Include our headers in your requests","type":"basic","slug":"include-our-headers-in-your-requests","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","createdAt":"2022-01-20T11:02:09.287Z","category":"58ce970ea6027e1b00db4bed","parentDoc":null,"icon":"","isBodyEmpty":false,"children":[]}]},{"_id":"645e5a084bfecf13f03bbf97","title":"Authentication","slug":"authentication-2","order":1,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"58bec8f49d43720f0043fdb5","createdAt":"2023-05-12T15:23:52.932Z","__v":0,"pages":[{"_id":"645e5a094bfecf13f03bbf98","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"645e5a084bfecf13f03bbf96"},"title":"Auth","icon":"","type":"basic","slug":"auth","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Auth","link_url":"","link_external":false,"previousSlug":"","category":"645e5a084bfecf13f03bbf97","createdAt":"2023-05-12T15:23:53.802Z","isBodyEmpty":false,"children":[{"_id":"645e5a0a4bfecf13f03bbf9c","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"645e5a084bfecf13f03bbf96"},"title":"/auth","icon":"","type":"endpoint","slug":"post_auth","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_auth","link_url":"","link_external":false,"previousSlug":"","category":"645e5a084bfecf13f03bbf97","createdAt":"2023-05-12T15:23:54.120Z","parentDoc":"645e5a094bfecf13f03bbf98","isBodyEmpty":true,"children":[]}]}]},{"_id":"58cd4a8450a0c12500e89bf9","apiSetting":"58cd4a8450a0c12500e89bf8","order":2,"project":"58bec8f49d43720f0043fdb2","slug":"personnel-data","title":"Personnel Data","__v":0,"createdAt":"2017-03-18T14:56:04.717Z","from_sync":false,"isAPI":true,"reference":true,"version":"58bec8f49d43720f0043fdb5","pages":[{"_id":"5d3ee937ce62e6003063e858","createdAt":"2019-07-29T12:40:23.906Z","category":"58cd4a8450a0c12500e89bf9","link_external":false,"link_url":"","sync_unique":"tag__Employees","hidden":false,"api":{"auth":"required","params":[],"url":"","method":"get","apiSetting":"58cd4a8450a0c12500e89bf8"},"isReference":true,"order":0,"slug":"employees-1","type":"basic","title":"Employees","parentDoc":null,"previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":true,"children":[{"_id":"58f62ffc58048b19006064e1","link_url":"","slug":"get_company-employees","category":"58cd4a8450a0c12500e89bf9","parentDoc":"5d3ee937ce62e6003063e858","sync_unique":"get_company-employees","api":{"auth":"required","params":[],"url":"","method":"get","apiSetting":"58cd4a8450a0c12500e89bf8","results":{"codes":[]}},"order":0,"createdAt":"2017-04-18T15:25:48.525Z","link_external":false,"hidden":false,"isReference":true,"type":"endpoint","title":"List Employees","previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":false,"children":[]},{"_id":"5cdd54350db808001fff08e8","createdAt":"2019-05-16T12:14:45.842Z","category":"58cd4a8450a0c12500e89bf9","parentDoc":"5d3ee937ce62e6003063e858","link_external":false,"link_url":"","sync_unique":"post_company-employees","hidden":false,"api":{"apiSetting":"58cd4a8450a0c12500e89bf8","results":{"codes":[]},"auth":"required","params":[],"url":"","method":"post"},"isReference":true,"order":1,"slug":"post_company-employees","type":"endpoint","title":"Create an Employee","previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":false,"children":[]},{"_id":"5da85cda4190e700429ab5c0","createdAt":"2019-10-17T12:21:46.842Z","category":"58cd4a8450a0c12500e89bf9","parentDoc":"5d3ee937ce62e6003063e858","link_external":false,"link_url":"","sync_unique":"patch_company-employees-employee-id","hidden":false,"api":{"apiSetting":"58cd4a8450a0c12500e89bf8","results":{"codes":[]},"auth":"required","params":[],"url":"","method":"patch"},"isReference":true,"order":2,"slug":"patch_company-employees-employee-id","type":"endpoint","title":"Update Employee by ID","previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":false,"children":[]},{"_id":"58f62ffc58048b19006064e2","order":3,"title":"Get Employee by ID","category":"58cd4a8450a0c12500e89bf9","hidden":false,"api":{"method":"get","auth":"required","params":[],"url":"","apiSetting":"58cd4a8450a0c12500e89bf8","results":{"codes":[]}},"isReference":true,"link_external":false,"link_url":"","slug":"get_company-employees-employee-id","parentDoc":"5d3ee937ce62e6003063e858","createdAt":"2017-04-18T15:25:48.528Z","type":"endpoint","sync_unique":"get_company-employees-employee-id","previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":false,"children":[]},{"_id":"60c8d6acbc6776004a289d35","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"58cd4a8450a0c12500e89bf8"},"title":"Get Absence Balance for Employee","type":"endpoint","slug":"get_company-employees-employee-id-absences-balance","order":4,"isReference":true,"hidden":false,"sync_unique":"get_company-employees-employee-id-absences-balance","link_url":"","link_external":false,"previousSlug":"","category":"58cd4a8450a0c12500e89bf9","createdAt":"2021-06-15T16:34:52.691Z","parentDoc":"5d3ee937ce62e6003063e858","deprecated":false,"icon":"","isBodyEmpty":true,"children":[]},{"_id":"5f75af171ffdb6001871cf62","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"58cd4a8450a0c12500e89bf8","results":{"codes":[]}},"title":"List Allowed Custom Attributes","type":"endpoint","slug":"get_company-employees-custom-attributes","order":5,"isReference":true,"hidden":false,"sync_unique":"get_company-employees-custom-attributes","link_url":"","link_external":false,"previousSlug":"","category":"58cd4a8450a0c12500e89bf9","createdAt":"2020-10-01T10:27:35.649Z","parentDoc":"5d3ee937ce62e6003063e858","deprecated":false,"icon":"","isBodyEmpty":false,"children":[]},{"_id":"61d5ada2fdb6b2003107ba82","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"58cd4a8450a0c12500e89bf8"},"title":"List Allowed Attributes","type":"endpoint","slug":"get_company-employees-attributes","order":6,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_company-employees-attributes","link_url":"","link_external":false,"previousSlug":"","category":"58cd4a8450a0c12500e89bf9","createdAt":"2022-01-05T14:39:30.119Z","parentDoc":"5d3ee937ce62e6003063e858","icon":"","isBodyEmpty":false,"children":[]},{"_id":"5d1a1acbba9b830013ce61ae","createdAt":"2019-07-01T14:38:03.579Z","category":"58cd4a8450a0c12500e89bf9","parentDoc":"5d3ee937ce62e6003063e858","link_external":false,"link_url":"","sync_unique":"get_company-employees-employee-id-profile-picture-width","hidden":false,"api":{"apiSetting":"58cd4a8450a0c12500e89bf8","results":{"codes":[]},"auth":"required","params":[],"url":"","method":"get"},"isReference":true,"order":7,"slug":"get_company-employees-employee-id-profile-picture-width","type":"endpoint","title":"Get Employee Profile Picture","previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":true,"children":[]}]},{"_id":"5d3ee937ce62e6003063e859","createdAt":"2019-07-29T12:40:24.204Z","category":"58cd4a8450a0c12500e89bf9","link_external":false,"link_url":"","sync_unique":"tag__Attendances","hidden":false,"api":{"auth":"required","params":[],"url":"","method":"get","apiSetting":"58cd4a8450a0c12500e89bf8"},"isReference":true,"order":1,"slug":"attendances-1","type":"basic","title":"Attendances","parentDoc":null,"previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":true,"children":[{"_id":"5b28b50d8b57130003e71245","category":"58cd4a8450a0c12500e89bf9","parentDoc":"5d3ee937ce62e6003063e859","createdAt":"2018-06-19T07:47:25.288Z","link_external":false,"link_url":"","sync_unique":"get_company-attendances","hidden":false,"api":{"apiSetting":"58cd4a8450a0c12500e89bf8","auth":"required","params":[],"url":"","method":"get","results":{"codes":[]}},"isReference":true,"order":0,"slug":"get_company-attendances","type":"endpoint","title":"List Attendances","previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":true,"children":[]},{"_id":"5b28b50d8b57130003e71246","category":"58cd4a8450a0c12500e89bf9","parentDoc":"5d3ee937ce62e6003063e859","createdAt":"2018-06-19T07:47:25.289Z","link_external":false,"link_url":"","sync_unique":"post_company-attendances","hidden":false,"api":{"apiSetting":"58cd4a8450a0c12500e89bf8","auth":"required","params":[],"url":"","method":"post","results":{"codes":[]}},"isReference":true,"order":1,"slug":"post_company-attendances","type":"endpoint","title":"Create an Attendance","previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":false,"children":[]},{"_id":"5bbdfd0ed365080003a44cd1","category":"58cd4a8450a0c12500e89bf9","parentDoc":"5d3ee937ce62e6003063e859","createdAt":"2018-10-10T13:22:22.512Z","link_external":false,"link_url":"","sync_unique":"delete_company-attendances-id","hidden":false,"api":{"apiSetting":"58cd4a8450a0c12500e89bf8","results":{"codes":[]},"auth":"required","params":[],"url":"","method":"delete"},"isReference":true,"order":2,"slug":"delete_company-attendances-id","type":"endpoint","title":"Delete Attendance by ID","previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":true,"children":[]},{"_id":"5c9241e4996d26004be15c04","createdAt":"2019-03-20T13:36:36.470Z","category":"58cd4a8450a0c12500e89bf9","parentDoc":"5d3ee937ce62e6003063e859","link_external":false,"link_url":"","sync_unique":"patch_company-attendances-id","hidden":false,"api":{"apiSetting":"58cd4a8450a0c12500e89bf8","results":{"codes":[]},"auth":"required","params":[],"url":"","method":"patch"},"isReference":true,"order":3,"slug":"patch_company-attendances-id","type":"endpoint","title":"Update Attendance by ID","previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":false,"children":[]}]},{"_id":"620f7bc7af945a00133031ab","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"58cd4a8450a0c12500e89bf8"},"title":"Projects","type":"basic","slug":"projects","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Projects","link_url":"","link_external":false,"previousSlug":"","category":"58cd4a8450a0c12500e89bf9","createdAt":"2022-02-18T10:58:15.892Z","icon":"","parentDoc":null,"isBodyEmpty":true,"children":[{"_id":"620f7bc8af945a00133031ae","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"58cd4a8450a0c12500e89bf8"},"title":"List Projects","type":"endpoint","slug":"get_company-attendances-projects","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_company-attendances-projects","link_url":"","link_external":false,"previousSlug":"","category":"58cd4a8450a0c12500e89bf9","createdAt":"2022-02-18T10:58:16.011Z","parentDoc":"620f7bc7af945a00133031ab","icon":"","isBodyEmpty":true,"children":[]},{"_id":"620f7bc8af945a00133031af","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"58cd4a8450a0c12500e89bf8"},"title":"Create a Project","type":"endpoint","slug":"post_company-attendances-projects","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_company-attendances-projects","link_url":"","link_external":false,"previousSlug":"","category":"58cd4a8450a0c12500e89bf9","createdAt":"2022-02-18T10:58:16.012Z","parentDoc":"620f7bc7af945a00133031ab","icon":"","isBodyEmpty":true,"children":[]},{"_id":"620f7bc8af945a00133031b0","api":{"method":"delete","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"58cd4a8450a0c12500e89bf8"},"title":"Delete Project by ID","type":"endpoint","slug":"delete_company-attendances-projects-id","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"delete_company-attendances-projects-id","link_url":"","link_external":false,"previousSlug":"","category":"58cd4a8450a0c12500e89bf9","createdAt":"2022-02-18T10:58:16.013Z","parentDoc":"620f7bc7af945a00133031ab","icon":"","isBodyEmpty":true,"children":[]},{"_id":"620f7bc8af945a00133031b1","api":{"method":"patch","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"58cd4a8450a0c12500e89bf8"},"title":"Update Project by ID","type":"endpoint","slug":"patch_company-attendances-projects-id","order":3,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"patch_company-attendances-projects-id","link_url":"","link_external":false,"previousSlug":"","category":"58cd4a8450a0c12500e89bf9","createdAt":"2022-02-18T10:58:16.014Z","parentDoc":"620f7bc7af945a00133031ab","icon":"","isBodyEmpty":true,"children":[]}]},{"_id":"5d3ee937ce62e6003063e85a","createdAt":"2019-07-29T12:40:24.320Z","category":"58cd4a8450a0c12500e89bf9","link_external":false,"link_url":"","sync_unique":"tag__Absences","hidden":false,"api":{"auth":"required","params":[],"url":"","method":"get","apiSetting":"58cd4a8450a0c12500e89bf8"},"isReference":true,"order":3,"slug":"absences-1","type":"basic","title":"Absences","parentDoc":null,"previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":true,"children":[{"_id":"5c47427cdf8ae20e0c01ffad","category":"58cd4a8450a0c12500e89bf9","parentDoc":"5d3ee937ce62e6003063e85a","createdAt":"2019-01-22T16:19:08.188Z","link_external":false,"link_url":"","sync_unique":"get_company-time-off-types","hidden":false,"api":{"apiSetting":"58cd4a8450a0c12500e89bf8","results":{"codes":[]},"auth":"required","params":[],"url":"","method":"get"},"isReference":true,"order":0,"slug":"get_company-time-off-types","type":"endpoint","title":"List Time-Off Types","previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":true,"children":[]},{"_id":"58f62ffc58048b19006064e5","sync_unique":"get_company-time-offs","slug":"get_company-time-offs","title":"List Time-Offs","parentDoc":"5d3ee937ce62e6003063e85a","createdAt":"2017-04-18T15:25:48.531Z","category":"58cd4a8450a0c12500e89bf9","link_external":false,"link_url":"","api":{"auth":"required","params":[],"url":"","method":"get","apiSetting":"58cd4a8450a0c12500e89bf8","results":{"codes":[]}},"isReference":true,"order":1,"type":"endpoint","hidden":false,"previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":true,"children":[]},{"_id":"5c47427cdf8ae20e0c01ffae","category":"58cd4a8450a0c12500e89bf9","parentDoc":"5d3ee937ce62e6003063e85a","createdAt":"2019-01-22T16:19:08.190Z","link_external":false,"link_url":"","sync_unique":"post_company-time-offs","hidden":false,"api":{"apiSetting":"58cd4a8450a0c12500e89bf8","results":{"codes":[]},"auth":"required","params":[],"url":"","method":"post"},"isReference":true,"order":2,"slug":"post_company-time-offs","type":"endpoint","title":"Create a Time-Off","previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":true,"children":[]},{"_id":"5c47427cdf8ae20e0c01ffaf","category":"58cd4a8450a0c12500e89bf9","parentDoc":"5d3ee937ce62e6003063e85a","createdAt":"2019-01-22T16:19:08.191Z","link_external":false,"link_url":"","sync_unique":"delete_company-time-offs-id","hidden":false,"api":{"apiSetting":"58cd4a8450a0c12500e89bf8","results":{"codes":[]},"auth":"required","params":[],"url":"","method":"delete"},"isReference":true,"order":3,"slug":"delete_company-time-offs-id","type":"endpoint","title":"Delete Time-Off by ID","previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":true,"children":[]},{"_id":"5c487c74dda0a013feb47f76","category":"58cd4a8450a0c12500e89bf9","parentDoc":"5d3ee937ce62e6003063e85a","createdAt":"2019-01-23T14:38:44.331Z","link_external":false,"link_url":"","sync_unique":"get_company-time-offs-id","hidden":false,"api":{"apiSetting":"58cd4a8450a0c12500e89bf8","results":{"codes":[]},"auth":"required","params":[],"url":"","method":"get"},"isReference":true,"order":4,"slug":"get_company-time-offs-id","type":"endpoint","title":"Get Time-Off by ID","previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":true,"children":[]},{"_id":"62da46be7f65eb0021b205d9","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"58cd4a8450a0c12500e89bf8"},"title":"List Absence Periods","icon":"","type":"endpoint","slug":"get_company-absence-periods","order":5,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_company-absence-periods","link_url":"","link_external":false,"previousSlug":"","category":"58cd4a8450a0c12500e89bf9","createdAt":"2022-07-22T06:42:06.816Z","parentDoc":"5d3ee937ce62e6003063e85a","isBodyEmpty":true,"children":[]},{"_id":"640b43de0157040d247b7840","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"58cd4a8450a0c12500e89bf8"},"title":"Create an Absence Period","icon":"","type":"endpoint","slug":"post_company-absence-periods","order":6,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_company-absence-periods","link_url":"","link_external":false,"previousSlug":"","category":"58cd4a8450a0c12500e89bf9","createdAt":"2023-03-10T14:51:10.335Z","parentDoc":"5d3ee937ce62e6003063e85a","isBodyEmpty":true,"children":[]},{"_id":"643d704586c5b1041326ec32","api":{"method":"delete","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"58cd4a8450a0c12500e89bf8"},"title":"Delete Absence Period by ID","icon":"","type":"endpoint","slug":"delete_company-absence-periods-id","order":7,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"delete_company-absence-periods-id","link_url":"","link_external":false,"previousSlug":"","category":"58cd4a8450a0c12500e89bf9","createdAt":"2023-04-17T16:13:57.027Z","parentDoc":"5d3ee937ce62e6003063e85a","isBodyEmpty":true,"children":[]}]},{"_id":"620642eec4d147006f4b1cba","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"58cd4a8450a0c12500e89bf8"},"title":"Documents","type":"basic","slug":"documents","order":4,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Documents","link_url":"","link_external":false,"previousSlug":"","category":"58cd4a8450a0c12500e89bf9","createdAt":"2022-02-11T11:05:18.351Z","icon":"","parentDoc":null,"isBodyEmpty":true,"children":[{"_id":"620642eec4d147006f4b1cbd","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"58cd4a8450a0c12500e89bf8"},"title":"List Document Categories","type":"endpoint","slug":"get_company-document-categories","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_company-document-categories","link_url":"","link_external":false,"previousSlug":"","category":"58cd4a8450a0c12500e89bf9","createdAt":"2022-02-11T11:05:18.490Z","parentDoc":"620642eec4d147006f4b1cba","icon":"","isBodyEmpty":true,"children":[]},{"_id":"620642eec4d147006f4b1cbe","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"58cd4a8450a0c12500e89bf8"},"title":"Upload Document","type":"endpoint","slug":"post_company-documents","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_company-documents","link_url":"","link_external":false,"previousSlug":"","category":"58cd4a8450a0c12500e89bf9","createdAt":"2022-02-11T11:05:18.491Z","parentDoc":"620642eec4d147006f4b1cba","icon":"","isBodyEmpty":true,"children":[]}]},{"_id":"633c4d21da0e79003c32f0de","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"58cd4a8450a0c12500e89bf8"},"title":"Custom Reports","icon":"","type":"basic","slug":"custom-reports","order":5,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Custom Reports","link_url":"","link_external":false,"previousSlug":"","category":"58cd4a8450a0c12500e89bf9","createdAt":"2022-10-04T15:11:29.089Z","parentDoc":null,"isBodyEmpty":true,"children":[{"_id":"633c4d22da0e79003c32f0e2","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"58cd4a8450a0c12500e89bf8"},"title":"List Custom Reports","icon":"","type":"endpoint","slug":"listreports","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"listReports","link_url":"","link_external":false,"previousSlug":"","category":"58cd4a8450a0c12500e89bf9","createdAt":"2022-10-04T15:11:30.261Z","parentDoc":"633c4d21da0e79003c32f0de","isBodyEmpty":true,"children":[]},{"_id":"633c4d22da0e79003c32f0e3","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"58cd4a8450a0c12500e89bf8"},"title":"Get Custom Report by ID","icon":"","type":"endpoint","slug":"listreportitems","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"listReportItems","link_url":"","link_external":false,"previousSlug":"","category":"58cd4a8450a0c12500e89bf9","createdAt":"2022-10-04T15:11:30.263Z","parentDoc":"633c4d21da0e79003c32f0de","isBodyEmpty":true,"children":[]},{"_id":"633c4d22da0e79003c32f0e4","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"58cd4a8450a0c12500e89bf8"},"title":"List Custom Report Column Labels","icon":"","type":"endpoint","slug":"listcolumns","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"listColumns","link_url":"","link_external":false,"previousSlug":"","category":"58cd4a8450a0c12500e89bf9","createdAt":"2022-10-04T15:11:30.264Z","parentDoc":"633c4d21da0e79003c32f0de","isBodyEmpty":true,"children":[]}]}]},{"_id":"609158e8204c7e001baff966","title":"Recruiting","slug":"recruiting","order":3,"reference":true,"isAPI":true,"project":"58bec8f49d43720f0043fdb2","version":"58bec8f49d43720f0043fdb5","createdAt":"2021-05-04T14:23:36.068Z","__v":0,"pages":[{"_id":"61977e85d53f8f0188f2f568","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[]},"title":"Introduction","type":"basic","slug":"introduction-1","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","createdAt":"2021-11-19T10:37:57.700Z","category":"609158e8204c7e001baff966","parentDoc":null,"icon":"","isBodyEmpty":false,"children":[]},{"_id":"609158e8204c7e001baff967","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"609158e7204c7e001baff965"},"title":"XML","type":"basic","slug":"xml","order":1,"isReference":true,"hidden":false,"sync_unique":"tag__XML","link_url":"","link_external":false,"previousSlug":"","category":"609158e8204c7e001baff966","createdAt":"2021-05-04T14:23:36.577Z","parentDoc":null,"deprecated":false,"icon":"","isBodyEmpty":true,"children":[{"_id":"609158e8204c7e001baff96d","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"609158e7204c7e001baff965"},"title":"Retrieve open positions","type":"endpoint","slug":"get_xml","order":0,"isReference":true,"hidden":false,"sync_unique":"get_xml","link_url":"","link_external":false,"previousSlug":"","category":"609158e8204c7e001baff966","createdAt":"2021-05-04T14:23:36.745Z","parentDoc":"609158e8204c7e001baff967","deprecated":false,"icon":"","isBodyEmpty":true,"children":[]}]},{"_id":"619f69abf46f110069009f4a","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"609158e7204c7e001baff965"},"title":"Application","type":"basic","slug":"application","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Application","link_url":"","link_external":false,"previousSlug":"","category":"609158e8204c7e001baff966","createdAt":"2021-11-25T10:47:07.538Z","icon":"","parentDoc":null,"isBodyEmpty":true,"children":[{"_id":"618928e7b37f00007b393cee","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"609158e7204c7e001baff965"},"title":"Creating applications in Personio","type":"endpoint","slug":"post_v1-recruiting-applications","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_v1-recruiting-applications","link_url":"","link_external":false,"previousSlug":"","category":"609158e8204c7e001baff966","createdAt":"2021-11-08T13:40:55.499Z","parentDoc":"619f69abf46f110069009f4a","icon":"","isBodyEmpty":false,"children":[]}]},{"_id":"619f69abf46f110069009f4b","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"609158e7204c7e001baff965"},"title":"Application Documents","type":"basic","slug":"application-documents","order":3,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Application Documents","link_url":"","link_external":false,"previousSlug":"","category":"609158e8204c7e001baff966","createdAt":"2021-11-25T10:47:07.538Z","icon":"","parentDoc":null,"isBodyEmpty":true,"children":[{"_id":"618928e7b37f00007b393cef","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"609158e7204c7e001baff965"},"title":"Upload documents to be attached to applications","type":"endpoint","slug":"post_v1-recruiting-applications-documents","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_v1-recruiting-applications-documents","link_url":"","link_external":false,"previousSlug":"","category":"609158e8204c7e001baff966","createdAt":"2021-11-08T13:40:55.500Z","parentDoc":"619f69abf46f110069009f4b","icon":"","isBodyEmpty":false,"children":[]}]}]}]},"baseUrl":"/","apiBaseUrl":"/","search":{"appId":"T28YKFATPY","searchApiKey":"YzY0MThjMDM2YWVjMDI2ODRiZWQ5ODA0NTQ1ODhiMmQzMDE0ZDc4MjRiNGExNjBkMzQ2YmViZmIwZTBkNDRjYXRhZ0ZpbHRlcnM9KHByb2plY3Q6NThiZWM4ZjQ5ZDQzNzIwZjAwNDNmZGIyKSwodmVyc2lvbjpub25lLHZlcnNpb246NThiZWM4ZjQ5ZDQzNzIwZjAwNDNmZGI1KSwoaGlkZGVuOm5vbmUsaGlkZGVuOmZhbHNlKSwoaW5kZXg6Q3VzdG9tUGFnZSxpbmRleDpQYWdlLGluZGV4OkRpc2N1c3MsaW5kZXg6QmxvZyk=","indexName":"readme_search_v2","projectsMeta":[{"modules":{"docs":true,"landing":true,"suggested_edits":false,"discuss":true,"reference":true,"examples":true,"changelog":true,"custompages":false,"logs":false,"tutorials":false,"graphql":false},"id":"58bec8f49d43720f0043fdb2","name":"Personio Developer Hub","subdomain":"personio","subpath":"","nav_names":{"discuss":"","docs":"Documentation","reference":"API Reference","changelog":"","tutorials":"","recipes":""}}],"UrlManager":{"options":{"child":false,"parent":null,"hasOneChild":false,"project":null,"version":null,"lang":"en"},"defaults":{"lang":"en"}},"urlManagerOpts":{"lang":"en","parent":{"childrenProjects":[]},"project":{"subdomain":"personio"},"version":"1.0"}},"doc":{"metadata":{"image":[],"title":"","description":"","keywords":"","robots":"index"},"mdx":{"altBody":"","status":"rdmd"},"api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"58cd4a8450a0c12500e89bf8"},"swagger":{"path":"/company/documents"},"next":{"description":"For the latest CRUD functionalities, please do visit our Documents Management v2 API documentation","pages":[{"type":"url","value":"https://developer.personio.de/v2.0/reference/get_v2-document-management-documents","name":"Documents Management v2"}]},"algolia":{"recordCount":1,"publishPending":false,"translationFailure":false,"updatedAt":"2024-10-02T12:53:02.638Z"},"title":"Upload Document","icon":"","updates":[],"type":"endpoint","slug":"post_company-documents","excerpt":"This endpoint is responsible for uploading documents for the company employees.\nThe Documents endpoint has a rate limit of 60 requests per minute.","body":"","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_company-documents","link_url":"","link_external":false,"reusableContent":[],"previousSlug":"","slugUpdatedAt":"2022-02-10T17:20:21.508Z","revision":73,"_id":"620642eec4d147006f4b1cbe","pendingAlgoliaPublish":false,"category":{"title":"Personnel Data","slug":"personnel-data","order":2,"reference":true,"_id":"58cd4a8450a0c12500e89bf9","apiSetting":"58cd4a8450a0c12500e89bf8","project":"58bec8f49d43720f0043fdb2","__v":0,"createdAt":"2017-03-18T14:56:04.717Z","from_sync":false,"isAPI":true,"version":"58bec8f49d43720f0043fdb5","type":"reference","id":"58cd4a8450a0c12500e89bf9"},"createdAt":"2022-02-11T11:05:18.491Z","updatedAt":"2024-10-02T12:53:02.659Z","parentDoc":"620642eec4d147006f4b1cba","project":"58bec8f49d43720f0043fdb2","version":{"version":"1.0","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["58bec8f59d43720f0043fdb6","58beca30362a592f00396740","58beca4b2710c31b00414cb2","58c1db2d0de1f70f00a0b840","58c318c439b3fd0f0039ef38","58c334b02c506d0f00c1aeab","58c69a1eebb6c70f003482c9","58c6acb4ebb6c70f00348462","58cd35eebef8592f00efb455","58cd362950a0c12500e89a68","58cd362c72a4cb1900438ea7","58cd38cbd7d86d1900476413","58cd38cd51a94e3100d5bdb6","58cd38cf72a4cb1900438eea","58cd3aff72a4cb1900438f0f","58cd3da0bef8592f00efb459","58cd3da265903d3700d08363","58cd3f4265903d3700d08385","58cd3f9b50a0c12500e89b4c","58cd408265903d3700d083a8","58cd485f50a0c12500e89bd4","58cd4a8450a0c12500e89bf9","58cd4aafd7d86d1900476521","58ce970ea6027e1b00db4bed","5943ab89b03361002dff3c20","5b27d022ba156500032234d5","5b27d2a36814190003f640ed","5b27d4b14a48b70003b371fc","5b28b87494e1f7000317f654","5b28b88636a5030003c3f672","5b28c2538b57130003e712fa","5b55dd1cb065af000305e217","5b55dd9a6bd0940003c996d3","5c34c6163365e70025b48b6f","5c374cf97267aa42020e6281","5c374d58a6af2943c3dac097","5cdbe8965c024f004b319c2b","5cece58fa4dd7d0045f4e395","5d380ff13810e8003f49d587","60646e26c44914007fc12db3","609158e8204c7e001baff966","615c253879b7fc0174732f0f","6376bee1127d99000316955b","63d3f5ad609d9b00316661ba","645e595f750cac094b038204","645e59841d43c500187c885b","645e5a084bfecf13f03bbf97","649b0c11964de6005f04e0d7","649b0cc11362fb00633429b4","67239f85efa67b00103fae40"],"pdfStatus":"","_id":"58bec8f49d43720f0043fdb5","createdAt":"2017-03-07T14:51:32.985Z","project":"58bec8f49d43720f0043fdb2","releaseDate":"2017-03-07T14:51:32.985Z","__v":39,"updatedAt":"2024-10-31T15:17:25.348Z"},"__v":1,"pendingTempStagingPublish":false,"user":"635be8877ecb880043fc6809","lastUpdatedHash":"be2bc49874c9c65fcfaa5627fa2efe80a9c0d5bc","mdxAltBody":"","isApi":true,"tutorials":[],"id":"620642eec4d147006f4b1cbe"},"glossaryTerms":[],"hideTOC":false,"loginUrl":"https://dash.readme.com/to/personio","meta":{"_id":"620642eec4d147006f4b1cbe","description":"This endpoint is responsible for uploading documents for the company employees. The Documents endpoint has a rate limit of 60 requests per minute.","hidden":false,"image":[],"keywords":"","metaTitle":"Upload Document","parent":"620642eec4d147006f4b1cba","robots":"index","slug":"post_company-documents","title":"Upload Document","type":"reference"},"oasDefinition":{"openapi":"3.0.0","info":{"version":"1.0","title":"Personnel Data","description":"API for reading and writing personnel data including data about attendances, absences, documents, etc"},"x-readme":{"samples-languages":["curl","python","ruby","java","php","node"],"explorer-enabled":true,"proxy-enabled":true},"paths":{"/company/employees":{"parameters":[{"$ref":"#/components/parameters/XPersonioPartnerID"},{"$ref":"#/components/parameters/XPersonioAppID"}],"get":{"security":[{"BearerAuth":[]}],"tags":["Employees"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Pagination attribute to limit the number of employees returned per page.","schema":{"type":"integer","minimum":1,"default":10,"example":10}},{"name":"offset","in":"query","required":false,"description":"Pagination attribute to identify the first item in the collection to return.","schema":{"type":"integer","minimum":0,"default":0,"example":0}},{"name":"email","in":"query","required":false,"description":"Find an employee with the given email address. The response is still a list, containing only the filtered employee. NOTE: when using the updated_since filter, the email filter is ignored.","schema":{"type":"string"}},{"name":"attributes[]","in":"query","description":"A list of attributes that will be returned for the employees, ie. a projection of the employee fields and relationships. In case `updated_since` query parameter is used, this list will additionally be used to exclude the employees that had none of the provided `attributes[]` updated since `updated_since`, ie. a selection filter.","example":"?attributes[]=first_name&attributes[]=last_name","required":false,"schema":{"type":"array","items":{"type":"string"},"example":["first_name","last_name"]}},{"name":"updated_since","in":"query","required":false,"description":"Filter to select and return only the employees that have been updated after `updated_since`. When it is used together with the `attributes[]` query parameter, the filter will select only the employees that have had any of the provided `attributes[]` updated since `updated_since`. The format is `ISO 8601` (2022-12-24T08:15:30) or `YYYY-MM-DD`. NOTE: when using the `updated_since` filter, the `email`, `limit`, and `offset` parameters are ignored.\n<details> <summary><b>Examples with <code>updated_since</code> and <code>attributes[]</code>:</b></summary><br /> In an example company that has 17 employees:<br /><br /> <details>\n <summary>\n <code class=\"language-html\">?updated_since=2022-12-24T08:15:30</code>\n will yield 10 employees that were recently updated:\n </summary>\n<p><pre class=\"prettyprint\"><code language=\"json\" class=\"language-json\"> {\n \"success\": true,\n \"metadata\": {\n \"total_elements\": 10,\n \"current_page\": 0,\n \"total_pages\": 10\n },\n \"offset\": 0,\n \"limit\": 1,\n \"data\": [\n {\n \"type\": \"Employee\",\n \"attributes\": {\n \"id\": {\n \"label\": \"ID\",\n \"value\": 1,\n \"type\": \"integer\",\n \"universal_id\": \"id\"\n },\n \"first_name\": {\n \"label\": \"First name\",\n \"value\": \"Alexander\",\n \"type\": \"standard\",\n \"universal_id\": \"first_name\"\n },\n \"last_name\": {\n \"label\": \"Last name\",\n \"value\": \"Bergmann\",\n \"type\": \"standard\",\n \"universal_id\": \"last_name\"\n },\n \"email\": {\n \"label\": \"Email\",\n \"value\": \"alexander.bergmann@demo.com\",\n \"type\": \"standard\",\n \"universal_id\": \"email\"\n }\n }\n }, ...\n ],\n ...\n ...\n} </code></pre></p> </details><br /> <details>\n <summary>\n <code class=\"language-html\">?attributes[]=first_name</code>\n will yield all 17 employees:\n </summary>\n<p><pre class=\"prettyprint\"><code language=\"json\" class=\"language-json\"> {\n \"success\": true,\n \"metadata\": {\n \"total_elements\": 17,\n \"current_page\": 0,\n \"total_pages\": 17\n },\n \"offset\": 0,\n \"limit\": 1,\n \"data\": [\n {\n \"type\": \"Employee\",\n \"attributes\": {\n \"id\": {\n \"label\": \"ID\",\n \"value\": 1,\n \"type\": \"integer\",\n \"universal_id\": \"id\"\n },\n \"first_name\": {\n \"label\": \"First name\",\n \"value\": \"Alexander\",\n \"type\": \"standard\",\n \"universal_id\": \"first_name\"\n }\n }\n }\n ]\n} </code></pre></p> </details><br /> <details>\n <summary>\n <code class=\"language-html\">?attributes[]=first_name&updated_since=2022-12-24T08:15:30</code>\n will yield 3 employees, ones that had their <code>first_name</code> changed since <code>2022-12-24T08:15:30</code>:\n </summary>\n<p><pre class=\"prettyprint\"><code language=\"json\" class=\"language-json\"> {\n \"success\": true,\n \"metadata\": {\n \"total_elements\": 3,\n \"current_page\": 0,\n \"total_pages\": 3\n },\n \"offset\": 0,\n \"limit\": 1,\n \"data\": [\n {\n \"type\": \"Employee\",\n \"attributes\": {\n \"id\": {\n \"label\": \"ID\",\n \"value\": 1,\n \"type\": \"integer\",\n \"universal_id\": \"id\"\n },\n \"first_name\": {\n \"label\": \"First name\",\n \"value\": \"Alexander\",\n \"type\": \"standard\",\n \"universal_id\": \"first_name\"\n }\n }\n }\n ]\n} </code></pre></p> </details> </details>","example":"2022-12-24T08:15:30","schema":{"type":"string","example":"2022-12-24T08:15:30"}}],"description":"List Company Employees","summary":"List Employees","responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmployeesResponse"},"examples":{"response":{"value":{"success":true,"metadata":{"total_elements":2,"current_page":0,"total_pages":3},"offset":0,"limit":20,"data":[{"type":"Employee","attributes":{"id":{"label":"ID","value":1,"type":"integer","universal_id":"id"},"first_name":{"label":"First name","value":"Alexander","type":"standard","universal_id":"first_name"},"last_name":{"label":"Last name","value":"Bergmann","type":"standard","universal_id":"last_name"},"preferred_name":{"label":"Name (preferred)","value":"Alexander Bergmann","type":"standard","universal_id":"preferred_name"},"email":{"label":"Email","value":"alexander.bergmann@demo.email","type":"standard","universal_id":"email"},"gender":{"label":"Gender","value":"male","type":"standard","universal_id":"gender"},"status":{"label":"Status","value":"active","type":"standard","universal_id":"status"},"position":{"label":"Position","value":"CTO","type":"standard","universal_id":"position"},"supervisor":{"label":"Supervisor","value":{"type":"Employee","attributes":{"id":{"label":"ID","value":2,"type":"integer","universal_id":"id"}}},"type":"standard","universal_id":"supervisor"},"employment_type":{"label":"Employment type","value":"external","type":"standard","universal_id":"employment_type"},"weekly_working_hours":{"label":"Weekly hours","value":"40","type":"standard","universal_id":"weekly_working_hours"},"hire_date":{"label":"Hire date","value":"2014-11-09T00:00:00+01:00","type":"date","universal_id":"hire_date"},"contract_end_date":{"label":"Contract ends","value":null,"type":"date","universal_id":"contract_end_date"},"termination_date":{"label":"Termination date","value":null,"type":"date","universal_id":"termination_date"},"termination_type":{"label":"Termination type","value":null,"type":"standard","universal_id":"termination_type"},"termination_reason":{"label":"Termination reason","value":null,"type":"standard","universal_id":"termination_reason"},"probation_period_end":{"label":"Probation period end","value":null,"type":"date","universal_id":"probation_period_end"},"created_at":{"label":"created_at","value":"2017-05-23T09:49:03+02:00","type":"date","universal_id":"created_at"},"last_modified_at":{"label":"Last modified","value":"2020-11-18T17:33:55+01:00","type":"date","universal_id":"last_modified_at"},"subcompany":{"label":"Subcompany","value":{"type":"Subcompany","attributes":{"id":7033,"name":"CS Demo GmbH"}},"type":"standard","universal_id":"subcompany"},"office":{"label":"Office","value":{"type":"Office","attributes":{"id":131014,"name":"Munich"}},"type":"standard","universal_id":"office"},"department":{"label":"Department","value":{"type":"Department","attributes":{"id":281521,"name":"Customer Support"}},"type":"standard","universal_id":"department"},"cost_centers":{"label":"Cost center","value":[{"type":"CostCenter","attributes":{"id":82957,"name":"Cost center 1","percentage":100}}],"type":"standard","universal_id":"cost_centers"},"holiday_calendar":{"label":"Public holidays","value":{"type":"HolidayCalendar","attributes":{"id":2,"name":"Deutschland (Bayern) Feiertage","country":"DE","state":"Bayern"}},"type":"standard","universal_id":"holiday_calendar"},"absence_entitlement":{"label":"Absence entitlement","value":[{"type":"TimeOffType","attributes":{"id":113437,"name":"Paid vacation","category":"paid_vacation","entitlement":24}}],"type":"standard","universal_id":"absence_entitlement"},"work_schedule":{"label":"Work schedule","value":{"type":"WorkSchedule","attributes":{"id":97188,"name":"Full-time, 40 hours without time tracking, (mon,tue,wed,thu,fri)","valid_from":null,"monday":"08:00","tuesday":"08:00","wednesday":"08:00","thursday":"08:00","friday":"08:00","saturday":"00:00","sunday":"00:00"}},"type":"standard","universal_id":"work_schedule"},"fix_salary":{"label":"Fix salary","value":3000,"type":"decimal","universal_id":"fix_salary","currency":"EUR"},"fix_salary_interval":{"label":"Salary interval","value":"monthly","type":"standard","universal_id":"fix_salary_interval"},"hourly_salary":{"label":"Hourly salary","value":0,"type":"decimal","universal_id":"hourly_salary","currency":"EUR"},"vacation_day_balance":{"label":"Vacation day balance","value":2,"type":"decimal","universal_id":"vacation_day_balance"},"last_working_day":{"label":"Last day of work","value":null,"type":"date","universal_id":"last_working_day"},"profile_picture":{"label":"Profile Picture","value":"https://api.personio.de/v1/company/employees/1132888/profile-picture","type":"standard","universal_id":"profile_picture"},"team":{"label":"Team","value":{"type":"Team","attributes":{"id":59026,"name":"T_X"}},"type":"standard","universal_id":"team"},"dynamic_24407":{"label":"Titel","value":"Dr","universal_id":null,"type":"standard"},"dynamic_21827":{"label":"IBAN","value":"DE98 8989 9898 0000 8989 00","universal_id":"iban","type":"standard"},"dynamic_33400":{"label":"Anniversary Date","value":"2021-01-01","universal_id":null,"type":"date"}}}]}}}}}}}},"post":{"security":[{"BearerAuth":[]}],"tags":["Employees"],"summary":"Create an Employee","description":"Creates a new employee. If the employee's status is not provided, it will be set based on the `hire_date` value - if it is in the past, status will be `active`, otherwise `onboarding`. This endpoint responds with the `id` of the created employee in case of success.\n","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"employee":{"type":"object","properties":{"email":{"type":"string","example":"john.dou@demo.com","description":"The e-mail field is required for the employee creation. Updating of this field is not currently supported."},"first_name":{"type":"string","example":"John"},"last_name":{"type":"string","example":"Dou"},"preferred_name":{"type":"string","example":"John Dou"},"gender":{"type":"string","example":"male"},"position":{"type":"string","example":"developer"},"subcompany":{"type":"string","description":"The subcompany employee belongs to. Should be predefined in Personio. Otherwise will be ignored with showing meta error in the response.","example":"ACME"},"department":{"type":"string","description":"The department employee belongs to. Should be predefined in Personio. Otherwise will be ignored with showing meta error in the response.","example":"IT"},"office":{"type":"string","description":"The office employee belongs to. Should be predefined in Personio. Otherwise will be ignored with showing meta error in the response.","example":"Madrid"},"hire_date":{"type":"string","example":"2020-01-31","format":"date","description":"Employee hire date. Format: \"yyyy-mm-dd\". If `status` is not provided, it will be set to `active` if the hire date is in the past, or to `onboarding` if it's in the future.","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"weekly_working_hours":{"type":"number","example":40},"status":{"type":"string","description":"Status of the employee. Overrides the status determined based on the value of `hire_date`.","example":"active"},"supervisor_id":{"description":"Employee ID of the Supervisor to be assigned. It needs to belong to a current existing employee, otherwise an error will be returned. If not present, no supervisor will be assigned.","type":"number","example":5},"custom_attributes":{"type":"object","properties":{"dynamic_{{ field uid }}":{"type":"string","description":"Dynamic field, represented by unique id.","example":"German"}}}},"required":["email","first_name","last_name"]}}}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"employee[email]":{"description":"Employee email","type":"string"},"employee[first_name]":{"description":"Employee first name","type":"string"},"employee[last_name]":{"description":"Employee last name","type":"string"},"employee[preferred_name]":{"description":"Employee preferred name","type":"string"},"employee[gender]":{"description":"Employee gender","type":"string","enum":["male","female","diverse"]},"employee[position]":{"description":"Employee position","type":"string"},"employee[department]":{"description":"Employee department","type":"string"},"employee[hire_date]":{"type":"string","example":"2020-01-31","format":"date","description":"Employee hire date. Format: yyyy-mm-dd","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"employee[weekly_working_hours]":{"description":"Employee weekly working hours","type":"number"},"employee[supervisor_id]":{"description":"Employee ID of the Supervisor to be assigned. It needs to belong to a current existing employee, otherwise an error will be returned. If not present, no supervisor will be assigned.","type":"number"},"employee[status]":{"description":"Employee status","type":"string","enum":["onboarding","active","leave","inactive"]}},"required":["employee[email]","employee[first_name]","employee[last_name]"]}}}},"responses":{"200":{"description":"Successful creation of a employee","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/EmployeeCreatedResponse"}]},"examples":{"response":{"value":{"success":true,"data":{"id":81723,"message":"success"}}}}}}},"422":{"description":"Employee creation failed due to invalid payload","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/EmployeeCreationErrorResponse"}]},"examples":{"response":{"value":{"success":false,"error":{"code":422,"message":"Supervisor with ID 1 not found"}}}}}}}}}},"/company/employees/{employee_id}":{"parameters":[{"$ref":"#/components/parameters/XPersonioPartnerID"},{"$ref":"#/components/parameters/XPersonioAppID"}],"patch":{"security":[{"BearerAuth":[]}],"tags":["Employees"],"summary":"Update Employee by ID","description":"Updates an existing employee. Note: Only the fields that are listed in the body example are updatable. Attributes that are not part of the sample request body but are present inside the request are ignored. It's not possible to update the Email field.\n","parameters":[{"name":"employee_id","in":"path","required":true,"description":"Numeric `id` of the employee","schema":{"type":"integer","format":"int32"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"employee":{"type":"object","properties":{"first_name":{"type":"string","example":"John"},"last_name":{"type":"string","example":"Dou"},"preferred_name":{"type":"string","example":"John Dou"},"gender":{"type":"string","example":"male"},"position":{"type":"string","example":"developer"},"subcompany":{"type":"string","description":"The subcompany employee belongs to. Should be predefined in Personio. Otherwise will be ignored with showing meta error in the response.","example":"ACME"},"department":{"type":"string","description":"The department employee belongs to. Should be predefined in Personio. Otherwise will be ignored with showing meta error in the response.","example":"IT"},"office":{"type":"string","description":"The office employee belongs to. Should be predefined in Personio. Otherwise will be ignored with showing meta error in the response.","example":"Madrid"},"hire_date":{"type":"string","example":"2020-01-31","format":"date","description":"Employee hire date. Format: \"yyyy-mm-dd\". Update of the `hire_date` will not update employee status on its own (for that you'll need to update the `status` field)","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"weekly_working_hours":{"type":"number","example":40},"status":{"type":"string","description":"Status of the employee.","example":"active"},"supervisor_id":{"type":"number","description":"Employee ID of the Supervisor to be assigned. It needs to belong to a current existing employee and not the same as the one of the employee being updated, otherwise an error will be returned. If sent as null, will unset the employee's supervisor.","example":5},"custom_attributes":{"type":"object","properties":{"dynamic_{{ field uid }}":{"type":"string","description":"Dynamic field, represented by unique id.","example":"German"}}}}}}}},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"employee[first_name]":{"description":"Employee first name","type":"string"},"employee[last_name]":{"description":"Employee last name","type":"string"},"employee[preferred_name]":{"description":"Employee preferred name","type":"string"},"employee[gender]":{"description":"Employee gender","type":"string","enum":["male","female","diverse"]},"employee[position]":{"description":"Employee position","type":"string"},"employee[department]":{"description":"Employee department","type":"string"},"employee[hire_date]":{"type":"string","example":"2020-01-31","format":"date","description":"Employee hire date. Format: yyyy-mm-dd","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"employee[weekly_working_hours]":{"description":"Employee weekly working hours","type":"number"},"employee[supervisor_id]":{"description":"Employee ID of the Supervisor to be assigned. It needs to belong to a current existing employee and not the same as the one of the employee being updated, otherwise an error will be returned. If sent as null, will unset the employee's supervisor.","type":"number"},"employee[status]":{"description":"Employee status","type":"string","enum":["onboarding","active","leave","inactive"]}}}}}},"responses":{"200":{"description":"Employee is updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmployeeUpdatedResponse"}}}},"422":{"description":"Employee update failed due to invalid payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmployeeUpdateErrorResponse"}}}}}},"get":{"security":[{"BearerAuth":[]}],"tags":["Employees"],"description":"Get Employee by ID","summary":"Get Employee by ID","parameters":[{"name":"employee_id","in":"path","required":true,"description":"Numeric `id` of the employee","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmployeeResponse"},"examples":{"response":{"value":{"success":true,"data":{"type":"Employee","attributes":{"id":{"label":"ID","value":1,"type":"integer","universal_id":"id"},"first_name":{"label":"First name","value":"Alexander","type":"standard","universal_id":"first_name"},"last_name":{"label":"Last name","value":"Bergmann","type":"standard","universal_id":"last_name"},"preferred_name":{"label":"Name (preferred)","value":"Alexander Bergmann","type":"standard","universal_id":"preferred_name"},"email":{"label":"Email","value":"alexander.bergmann@demo.email","type":"standard","universal_id":"email"},"gender":{"label":"Gender","value":"male","type":"standard","universal_id":"gender"},"status":{"label":"Status","value":"active","type":"standard","universal_id":"status"},"position":{"label":"Position","value":"CTO","type":"standard","universal_id":"position"},"supervisor":{"label":"Supervisor","value":{"type":"Employee","attributes":{"id":{"label":"ID","value":2,"type":"integer","universal_id":"id"}}},"type":"standard","universal_id":"supervisor"},"employment_type":{"label":"Employment type","value":"external","type":"standard","universal_id":"employment_type"},"weekly_working_hours":{"label":"Weekly hours","value":"40","type":"standard","universal_id":"weekly_working_hours"},"hire_date":{"label":"Hire date","value":"2014-11-09T00:00:00+01:00","type":"date","universal_id":"hire_date"},"contract_end_date":{"label":"Contract ends","value":null,"type":"date","universal_id":"contract_end_date"},"termination_date":{"label":"Termination date","value":null,"type":"date","universal_id":"termination_date"},"termination_type":{"label":"Termination type","value":null,"type":"standard","universal_id":"termination_type"},"termination_reason":{"label":"Termination reason","value":null,"type":"standard","universal_id":"termination_reason"},"probation_period_end":{"label":"Probation period end","value":null,"type":"date","universal_id":"probation_period_end"},"created_at":{"label":"created_at","value":"2017-05-23T09:49:03+02:00","type":"date","universal_id":"created_at"},"last_modified_at":{"label":"Last modified","value":"2020-11-18T17:33:55+01:00","type":"date","universal_id":"last_modified_at"},"subcompany":{"label":"Subcompany","value":{"type":"Subcompany","attributes":{"id":7033,"name":"CS Demo GmbH"}},"type":"standard","universal_id":"subcompany"},"office":{"label":"Office","value":{"type":"Office","attributes":{"id":131014,"name":"Munich"}},"type":"standard","universal_id":"office"},"department":{"label":"Department","value":{"type":"Department","attributes":{"id":281521,"name":"Customer Support"}},"type":"standard","universal_id":"department"},"cost_centers":{"label":"Cost center","value":[{"type":"CostCenter","attributes":{"id":82957,"name":"Cost center 1","percentage":100}}],"type":"standard","universal_id":"cost_centers"},"holiday_calendar":{"label":"Public holidays","value":{"type":"HolidayCalendar","attributes":{"id":2,"name":"Deutschland (Bayern) Feiertage","country":"DE","state":"Bayern"}},"type":"standard","universal_id":"holiday_calendar"},"absence_entitlement":{"label":"Absence entitlement","value":[{"type":"TimeOffType","attributes":{"id":113437,"name":"Paid vacation","category":"paid_vacation","entitlement":24}}],"type":"standard","universal_id":"absence_entitlement"},"work_schedule":{"label":"Work schedule","value":{"type":"WorkSchedule","attributes":{"id":97188,"name":"Full-time, 40 hours without time tracking, (mon,tue,wed,thu,fri)","valid_from":null,"monday":"08:00","tuesday":"08:00","wednesday":"08:00","thursday":"08:00","friday":"08:00","saturday":"00:00","sunday":"00:00"}},"type":"standard","universal_id":"work_schedule"},"fix_salary":{"label":"Fix salary","value":3000,"type":"decimal","universal_id":"fix_salary","currency":"EUR"},"fix_salary_interval":{"label":"Salary interval","value":"monthly","type":"standard","universal_id":"fix_salary_interval"},"hourly_salary":{"label":"Hourly salary","value":0,"type":"decimal","universal_id":"hourly_salary","currency":"EUR"},"last_working_day":{"label":"Last day of work","value":null,"type":"date","universal_id":"last_working_day"},"profile_picture":{"label":"Profile Picture","value":"https://api.personio.de/v1/company/employees/1132888/profile-picture","type":"standard","universal_id":"profile_picture"},"team":{"label":"Team","value":{"type":"Team","attributes":{"id":59026,"name":"T_X"}},"type":"standard","universal_id":"team"},"dynamic_24407":{"label":"Titel","value":"Dr","universal_id":null,"type":"standard"},"dynamic_21827":{"label":"IBAN","value":"DE98 8989 9898 0000 8989 00","universal_id":"iban","type":"standard"},"dynamic_33400":{"label":"Anniversary Date","value":"2021-01-01","universal_id":null,"type":"date"},"dynamic_180883":{"label":"Birthday","value":"1983-08-18","universal_id":"date_of_birth","type":"date"}}}}}}}}},"404":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Employee404ErrorResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":404,"message":"Es ist ein Problem aufgetreten "}}}}}}}}}},"/company/employees/{employee_id}/absences/balance":{"parameters":[{"$ref":"#/components/parameters/XPersonioPartnerID"},{"$ref":"#/components/parameters/XPersonioAppID"}],"get":{"security":[{"BearerAuth":[]}],"tags":["Employees"],"description":"Retrieve the absence balance for a specific employee","summary":"Get Absence Balance for Employee","parameters":[{"name":"employee_id","in":"path","required":true,"description":"Numeric `id` of the employee","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmployeeAbsenceBalance"}}}},"404":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Employee404ErrorResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":404,"message":"Es ist ein Problem aufgetreten "}}}}}}}}}},"/company/employees/custom-attributes":{"get":{"security":[{"BearerAuth":[]}],"tags":["Employees"],"description":"This endpoint is an alias for `/company/employees/attributes`.","summary":"List Allowed Custom Attributes","parameters":[{"$ref":"#/components/parameters/XPersonioPartnerID"},{"$ref":"#/components/parameters/XPersonioAppID"}],"responses":{"200":{"description":"Please refer to `/company/employees/attributes`"}}}},"/company/employees/attributes":{"get":{"security":[{"BearerAuth":[]}],"tags":["Employees"],"description":"Lists all the allowed atrributes per API credentials including custom (dynamic) attributes.","summary":"List Allowed Attributes","parameters":[{"$ref":"#/components/parameters/XPersonioPartnerID"},{"$ref":"#/components/parameters/XPersonioAppID"}],"responses":{"200":{"description":"","content":{"application/json":{"examples":{"response":{"value":{"success":true,"data":[{"key":"first_name","label":"First Name","type":"standard","universal_id":"first_name","options":[]},{"key":"last_name","label":"Last Name","type":"standard","universal_id":"last_name","options":[]},{"key":"dynamic_1","label":"IBAN","type":"standard","universal_id":"iban","options":[]},{"key":"dynamic_2","label":"Marital status","type":"list","universal_id":null,"options":["married","single"]},{"key":"dynamic_3","label":"Language Skills","type":"tags","universal_id":null,"options":["English","French","Spanish","German"]}]}}}}}}}}},"/company/employees/{employee_id}/profile-picture/{width}":{"parameters":[{"$ref":"#/components/parameters/XPersonioPartnerID"},{"$ref":"#/components/parameters/XPersonioAppID"}],"get":{"security":[{"BearerAuth":[]}],"tags":["Employees"],"description":"Show employee's profile picture. If profile picture is missing, the 404 error will be thrown. The `Profile Picture` attribute has to be whitelisted.","summary":"Get Employee Profile Picture","parameters":[{"name":"employee_id","in":"path","required":true,"description":"Numeric `id` of the employee","schema":{"type":"integer","format":"int32"}},{"name":"width","in":"path","required":true,"description":"Width of the image. Default is original size","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"When the employee doesn't exist or employee doesn't have profile picture set or Profile Picture attribute is not whitelisted, this error occurs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Employee404ErrorResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":404,"message":"Etwas ist schiefgelaufen ..."}}}}}}}}}},"/company/attendances":{"parameters":[{"$ref":"#/components/parameters/XPersonioPartnerID"},{"$ref":"#/components/parameters/XPersonioAppID"}],"get":{"security":[{"BearerAuth":[]}],"tags":["Attendances"],"description":"Fetch attendance data for the company employees. The result can be `paginated` and `filtered` by period, the date and/or time they were updated, and/or specific employee/employees. The result contains a list of attendances.","summary":"List Attendances","parameters":[{"name":"start_date","in":"query","required":true,"description":"First day of the period to be queried. It is inclusive, so the day specified as start_date will also be considered on the results","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":true,"description":"Last day of the period to be queried. It is inclusive, so the day specified as end_date will also be considered on the results.","schema":{"type":"string","format":"date"}},{"name":"updated_from","in":"query","required":false,"description":"Datetime from when the queried periods have been updated. Same format as updated_at. It is inclusive, so the day specified as updated_from will also be considered on the results. Can be just the date, or the date and the time, with or without the timezone.","schema":{"type":"string","format":"datetime"}},{"name":"updated_to","in":"query","required":false,"schema":{"type":"string","format":"datetime"},"description":"Datetime until when the queried periods have been updated. Same format as updated_at. It is inclusive, so the day specified as updated_to will also be considered on the results. Can be just the date, or the date and the time, with or without the timezone."},{"name":"includePending","in":"query","required":false,"description":"Returns AttendancePeriods with a status of pending, rejected and confirmed. For pending periods, the end_date attribute is nullable. The status of each period is included in the response.","schema":{"type":"boolean"}},{"name":"employees[]","in":"query","required":false,"description":"A list of Personio employee ID's to filter the results. The result filters including only attendances of provided employees.","explode":true,"schema":{"type":"array","items":{"type":"integer"},"example":"?employees[]=1&employees[]=2"},"allowReserved":true},{"name":"limit","in":"query","required":false,"description":"Pagination attribute to limit how many attendances are per page","schema":{"type":"integer","minimum":1,"default":200}},{"name":"offset","in":"query","required":false,"description":"The offset from the first record that would be returned. With 3 results [A, B, C] and an offset of 1, the following two results will be returned [B, C].","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"The Attendance periods matching the provided filters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttendancePeriodsResponse"},"examples":{"response":{"value":{"success":true,"metadata":{"total_elements":2,"current_page":0,"total_pages":3},"offset":0,"limit":200,"data":[{"id":1234,"type":"AttendancePeriod","attributes":{"employee":325659,"date":"2017-01-17","start_time":"09:00","end_time":"18:00","updated_at":"2017-01-17T16:41:08+00:00","status":"confirmed","break":50,"comment":"I was super productive","is_holiday":false,"is_on_time_off":"false,","project":{"id":567,"type":"Project","attributes":{"name":"A project name","active":true}}}},{"id":1235,"type":"AttendancePeriod","attributes":{"employee":325660,"date":"2017-01-18","start_time":"09:30","end_time":"18:30","updated_at":"2017-01-18T16:41:08+01:00","status":"pending","break":60,"comment":"I wasn't productive","is_holiday":false,"is_on_time_off":true,"project":null}}]}}}}}},"401":{"$ref":"#/components/responses/401UnauthorizedResponse"},"403":{"$ref":"#/components/responses/403ForbiddenResponse"}}},"post":{"security":[{"BearerAuth":[]}],"tags":["Attendances"],"description":"This endpoint is responsible for adding attendance data for the company employees. It is possible to add attendances for one or many employees at the same time. The payload sent on the request should be a list of attendance periods, in the form of an array containing attendance period objects.","summary":"Create an Attendance","requestBody":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/AttendanceCreateRequest"}]}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/NewAttendancePeriodParametersRequest"}}},"description":"List of attendance periods to create","required":true},"responses":{"200":{"description":"The attendance periods are successfully created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewAttendancePeriodResponse"},"examples":{"response":{"value":{"success":true,"data":{"id":[1,2],"message":"success"}}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttendanceCreateUpdate400ErrorResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":400,"message":"Error when trying to insert Attendances periods rows","detailed_message":[{"success":true,"error_msg":null,"id":1,"employee":1234,"date":"2017-01-01","start_time":"09:00","end_time":"18:00","break":60,"comment":"","project_id":5},{"success":false,"error_msg":"Existing overlapping attendances periods","id":null,"employee":1234,"date":"2017-01-01","start_time":"09:00","end_time":"18:00","break":60,"comment":"","project_id":null}]}}}}}}},"401":{"$ref":"#/components/responses/401UnauthorizedResponse"},"403":{"$ref":"#/components/responses/403ForbiddenResponse"}}}},"/company/attendances/{id}":{"parameters":[{"$ref":"#/components/parameters/XPersonioPartnerID"},{"$ref":"#/components/parameters/XPersonioAppID"}],"delete":{"security":[{"BearerAuth":[]}],"tags":["Attendances"],"description":"This endpoint is responsible for deleting attendance data for the company employees.","summary":"Delete Attendance by ID","parameters":[{"name":"id","in":"path","description":"ID of the attendance period to delete","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"skip_approval","in":"query","required":false,"description":"Optional, default value is true. If set to false, the approval status of the attendance period will be \"pending\" if an approval rule is set for the attendances type. The respective approval flow will be triggered.","schema":{"type":"boolean","default":true}}],"responses":{"200":{"description":"Success response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletedAttendanceResponse"},"examples":{"response":{"value":{"success":true,"data":{"message":"The attendance period was deleted."}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttendanceDelete400ErrorResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":400,"message":"Bad Request"}}}}}}},"401":{"$ref":"#/components/responses/401UnauthorizedResponse"},"403":{"$ref":"#/components/responses/403ForbiddenResponse"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Attendance404ErrorResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":404,"message":"The attendance period was not found."}}}}}}}}},"patch":{"security":[{"BearerAuth":[]}],"tags":["Attendances"],"description":"This endpoint is responsible for updating attendance data for the company employees. Attributes are not required and if not specified, the current value will be used. It is not possible to change the employee id.","summary":"Update Attendance by ID","parameters":[{"name":"id","in":"path","description":"ID of the attendance period to update","required":true,"schema":{"type":"integer","format":"int32"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttendanceUpdateRequest"}}},"description":"Attendance period data to update. At least one of the properties (`date`, `start_time`, `end_time`, `break`, `comment`, `project_id`, `skip_approval`) is required.","required":true},"responses":{"200":{"description":"Success response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatedAttendanceResponse"},"examples":{"response":{"value":{"success":true,"data":{"message":"The attendance period was updated."}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttendanceCreateUpdate400ErrorResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":400,"message":"Error when trying to insert Attendances periods rows."}}}}}}},"401":{"$ref":"#/components/responses/401UnauthorizedResponse"},"403":{"$ref":"#/components/responses/403ForbiddenResponse"},"404":{"description":"Not found response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Attendance404ErrorResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":404,"message":"The attendance period was not found."}}}}}}}}}},"/company/attendances/projects":{"parameters":[{"$ref":"#/components/parameters/XPersonioPartnerID"},{"$ref":"#/components/parameters/XPersonioAppID"}],"get":{"security":[{"BearerAuth":[]}],"tags":["Projects"],"description":"Provides a list of all company projects.","summary":"List Projects","responses":{"200":{"description":"List of projects returned","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Project"}}}}}}}}},"post":{"security":[{"BearerAuth":[]}],"tags":["Projects"],"description":"Creates a project into the company account","summary":"Create a Project","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","example":"A project name"},"active":{"type":"boolean","example":true,"default":false}}}}}},"responses":{"200":{"description":"Project created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"$ref":"#/components/schemas/Project"}}}}}},"400":{"description":"Invalid data was sent","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"name":{"type":"array","items":{"type":"string","example":"Project name cannot be empty"}}}}}}}}}}}},"/company/attendances/projects/{id}":{"delete":{"security":[{"BearerAuth":[]}],"tags":["Projects"],"description":"Deletes a project from the company account","summary":"Delete Project by ID","parameters":[{"name":"id","in":"path","required":true,"description":"Numeric `id` of the project","schema":{"type":"integer","format":"int32"}}],"responses":{"204":{"description":"Project was successfully deleted"},"404":{"description":"Project does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"message":{"type":"string","example":"Project 5 not found"}}}}}}}},"patch":{"security":[{"BearerAuth":[]}],"tags":["Projects"],"description":"Updates a project with the given data","summary":"Update Project by ID","parameters":[{"name":"id","in":"path","required":true,"description":"Numeric `id` of the project","schema":{"type":"integer","format":"int32"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","example":"A project name"},"active":{"type":"boolean","description":"Marks the availability of the project","example":true}}}}}},"responses":{"200":{"description":"Project updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"$ref":"#/components/schemas/Project"}}}}}},"400":{"description":"Invalid data was sent","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"active":{"type":"array","items":{"type":"string","example":"Active field needs to be of type boolean"}}}}}}}}},"404":{"description":"Project not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"message":{"type":"string","example":"Project 5 not found"}}}}}}}}},"/company/time-off-types":{"parameters":[{"$ref":"#/components/parameters/XPersonioPartnerID"},{"$ref":"#/components/parameters/XPersonioAppID"}],"get":{"security":[{"BearerAuth":[]}],"tags":["Absences"],"description":"Provides a list of absence types for absences **time unit** set to either **days** or **hours**. For example 'Paid vacation', 'Parental leave' or 'Home office'.","summary":"List Time-Off Types","parameters":[{"name":"limit","in":"query","required":false,"description":"Pagination attribute to limit how many records will be returned per page","schema":{"type":"integer","minimum":1,"default":200}},{"name":"offset","in":"query","required":false,"description":"Pagination attribute to identify which page you are requesting, by the form of telling an offset from the first record that would be returned.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"$ref":"#/components/schemas/TimeOffTypeResource"}}}},"examples":{"response":{"value":{"success":true,"data":[{"type":"TimeOffType","attributes":{"id":1234,"name":"Paid vacation","category":"paid_vacation","unit":"day","approval_required":true}},{"type":"TimeOffType","attributes":{"id":1235,"name":"Home office","category":"offsite_work","unit":"hour","approval_required":true}}]}}}}}}}}},"/company/time-offs":{"parameters":[{"$ref":"#/components/parameters/XPersonioPartnerID"},{"$ref":"#/components/parameters/XPersonioAppID"}],"get":{"security":[{"BearerAuth":[]}],"tags":["Absences"],"description":"Fetches absence periods for absences with **time unit** set to **days**. The result can be `paginated` and `filtered` by period and/or specific employee/employees. The result contains a list of absence periods.","summary":"List Time-Offs","parameters":[{"name":"start_date","in":"query","required":false,"description":"First day of the period to be queried. It is inclusive, so the result starts from and including the provided `start_date`","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Last day of the period to be queried. It is inclusive, so the result ends on `end_date` including absences from the `end_date`","schema":{"type":"string","format":"date"}},{"name":"updated_from","in":"query","required":false,"description":"Query the periods that created or modified from the date `updated_from`. It is inclusive, so all the periods created or modified from the beginning of the `updated_from` will be included in the results","schema":{"type":"string","format":"date"}},{"name":"updated_to","in":"query","required":false,"description":"Query the periods that created or modified until the date `updated_to`. It is inclusive, so all the periods created or modified until the end of the `updated_to` will be included in the results","schema":{"type":"string","format":"date"}},{"name":"employees[]","in":"query","required":false,"description":"A list of Personio employee ID's to filter the results. The result filters including only absences of provided employees","explode":true,"schema":{"type":"array","items":{"type":"integer"}},"allowReserved":true},{"name":"limit","in":"query","required":false,"description":"Pagination attribute to limit the number of absence periods per page","schema":{"type":"integer","minimum":1,"default":200}},{"name":"offset","in":"query","required":false,"description":"Pagination attribute to identify which page number you are requesting","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AbsencePeriodsResponse"},"examples":{"response":{"value":{"success":true,"metadata":{"total_elements":1,"current_page":1,"total_pages":1},"data":[{"type":"TimeOffPeriod","attributes":{"id":12345,"status":"approved","start_date":"2017-12-27T00:00:00+0100","end_date":"2017-12-29T00:00:00+0100","days_count":3,"half_day_start":false,"half_day_end":false,"time_off_type":{"type":"TimeOffType","attributes":{"id":54321,"name":"Vacation","category":"offsite_work"}},"employee":{"type":"Employee","attributes":{"id":{"label":"id","value":4567,"type":"integer","universal_id":"id"},"first_name":{"label":"First name","value":"Michael","type":"standard","universal_id":"first_name"},"last_name":{"label":"Last name","value":"Miller","type":"standard","universal_id":"last_name"},"email":{"label":"Email","value":"michael.miller@demo.com","type":"standard","universal_id":"email"}}},"certificate":{"status":"not-required"},"created_at":"2017-01-17T10:32:18+0100","updated_at":"2017-01-17T10:32:18+0100"}}],"offset":"0,","limit":"200,"}}}}}}}},"post":{"security":[{"BearerAuth":[]}],"tags":["Absences"],"description":"Adds absence data for absence types with **time unit** set to **days**.","summary":"Create a Time-Off","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/CreateTimeOffPeriodRequest"}}},"description":"Absence data","required":true},"x-readme":{"code-samples":[{"language":"powershell","code":"Auto-generated code snippets for this language may not be supported"},{"language":"php","code":"Auto-generated code snippets for this language may not be supported"}]},"responses":{"200":{"description":"The absence period is successfully created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AbsencePeriodResponse"}}},"examples":{"response":{"value":{"success":true,"data":{"type":"TimeOffPeriod","attributes":{"id":12345,"status":"approved","start_date":"2017-12-27T00:00:00+0100","end_date":"2017-12-29T00:00:00+0100","days_count":3,"half_day_start":false,"half_day_end":false,"time_off_type":{"type":"TimeOffType","attributes":{"id":54321,"name":"Vacation","category":"offsite_work"}},"employee":{"type":"Employee","attributes":{"id":{"label":"id","value":4567,"type":"integer","universal_id":"id"},"first_name":{"label":"First name","value":"Michael","type":"standard","universal_id":"first_name"},"last_name":{"label":"Last name","value":"Miller","type":"standard","universal_id":"last_name"},"email":{"label":"Email","value":"michael.miller@demo.com","type":"standard","universal_id":"email"}}},"certificate":{"status":"not-required"},"created_at":"2017-01-17T10:32:18+0100","created_by":"API","updated_at":"2017-01-17T10:32:18+0100"}}}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorInsertingAbsenceResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":400,"message":"Error when trying to insert absence period"}}}}}}},"404":{"description":"Employee or Absence type not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":0,"message":"Time-off type not found."}}}}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCreateAbsenceResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":0,"message":"The given data failed to pass validation.","error_data":"{...}"}}}}}}}}}},"/company/time-offs/{id}":{"parameters":[{"$ref":"#/components/parameters/XPersonioPartnerID"},{"$ref":"#/components/parameters/XPersonioAppID"}],"delete":{"security":[{"BearerAuth":[]}],"tags":["Absences"],"description":"Deletes absence period data for absence types with **time unit** set to **days**.","summary":"Delete Time-Off by ID","parameters":[{"name":"id","in":"path","description":"ID of the absence period to delete","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Success response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletedAbsenceResponse"},"examples":{"response":{"value":{"success":true,"data":{"message":"The absence period was deleted."}}}}}}},"400":{"description":"Bad request response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorAbsenceResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":400,"message":"The absence period id is invalid."}}}}}}},"404":{"description":"Not found response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorAbsenceResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":404,"message":"The absence period was not found."}}}}}}}}},"get":{"security":[{"BearerAuth":[]}],"tags":["Absences"],"description":"Gets an absence period for absences with **time unit** set to **days**.","summary":"Get Time-Off by ID","parameters":[{"name":"id","in":"path","required":true,"description":"Numeric `id` of the absence period","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AbsencePeriodResponse"},"examples":{"response":{"value":{"success":true,"data":{"type":"TimeOffPeriod","attributes":{"id":12345,"status":"approved","start_date":"2017-12-27T00:00:00+0100","end_date":"2017-12-29T00:00:00+0100","days_count":3,"half_day_start":false,"half_day_end":false,"time_off_type":{"type":"TimeOffType","attributes":{"id":45678,"name":"Vacation","category":"offsite_work"}},"employee":{"type":"Employee","attributes":{"id":{"label":"id","value":2367,"type":"integer","universal_id":"id"},"first_name":{"label":"First name","value":"Michael","type":"standard","universal_id":"first_name"},"last_name":{"label":"Last name","value":"Miller","type":"standard","universal_id":"last_name"},"email":{"label":"Email","value":"michael.miller@demo.com","type":"standard","universal_id":"email"}}},"certificate":{"status":"not-required"},"created_at":"2017-01-17T10:32:18+0100","updated_at":"2017-01-17T10:32:18+0100"}}}}}}}},"404":{"description":"Not found response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorAbsenceResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":404,"message":"The absence period was not found."}}}}}}}}}},"/company/absence-periods":{"parameters":[{"$ref":"#/components/parameters/XPersonioPartnerID"},{"$ref":"#/components/parameters/XPersonioAppID"}],"get":{"security":[{"BearerAuth":[]}],"tags":["Absences"],"description":"Fetches absence periods for absences with **time unit** set to **hours**. The result can be `paginated` and `filtered` by period and/or specific employee/employees. The result contains a list of hourly absence periods.","summary":"List Absence Periods","parameters":[{"name":"start_date","in":"query","required":false,"description":"When both start_date and end_date values are provided, the list of absences returned is a set that has all absences that intersects the window expressed as [start_date, end_date]. When either value is unspecified, the list of absences returned are unbounded in the direction of the unspecified value.","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"When both start_date and end_date values are provided, the list of absences returned is a set that has all absences that intersects the window expressed as [start_date, end_date]. When either value is unspecified, the list of absences returned are unbounded in the direction of the unspecified value.","schema":{"type":"string","format":"date"}},{"name":"updated_from","in":"query","required":false,"description":"Filter by periods that were created or modified from the date updated_from. It is inclusive, so all the periods created or modified from the beginning of the updated_from will be included in the results.","schema":{"type":"string","format":"date-time"}},{"name":"updated_to","in":"query","required":false,"description":"Filter by periods that were created or modified until the date updated_to. It is inclusive, so all the periods created or modified until the end of the updated_to will be included in the results.","schema":{"type":"string","format":"date-time"}},{"name":"employees[]","in":"query","required":false,"description":"A list of Personio employee ID's to filter the results. The result filters including only absences of provided employees","explode":true,"schema":{"type":"array","items":{"type":"integer"}},"allowReserved":true},{"name":"absence_types[]","in":"query","required":false,"description":"A list of Personio absence type IDs to filter the results. The result filters including only absences of provided absence types.","explode":true,"schema":{"type":"array","items":{"type":"string"}},"allowReserved":true},{"name":"absence_periods[]","in":"query","required":false,"description":"A list of Personio absence period IDs to filter the results. The result filters including only absences containing the provided ids.","explode":true,"schema":{"type":"array","items":{"type":"string"}},"allowReserved":true},{"name":"limit","in":"query","required":false,"description":"Pagination attribute to limit how many absence periods are returned per page.","schema":{"type":"integer","minimum":1,"default":200}},{"name":"offset","in":"query","required":false,"description":"Pagination attribute to identify which page you are requesting, by the form of telling an offset from the first record that would be returned.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HourlyAbsencePeriodsResponse"},"examples":{"response":{"value":{"success":true,"metadata":{"total_elements":1,"current_page":1,"total_pages":1},"data":[{"type":"AbsencePeriod","attributes":{"id":"9bba303f-0fbc-4514-9958-0befa21923fb","measurement_unit":"hour","effective_duration":960,"employee":{"type":"Employee","attributes":{"id":{"label":"id","value":2367,"type":"integer","universal_id":"id"},"first_name":{"label":"First name","value":"Michael","type":"standard","universal_id":"first_name"},"last_name":{"label":"Last name","value":"Miller","type":"standard","universal_id":"last_name"},"email":{"label":"Email","value":"michael.miller@demo.com","type":"standard","universal_id":"email"}}},"absence_type":{"type":"AbsenceType","attributes":{"id":"9bba303f-0fbc-4514-9958-0befa21923fb","name":"Absence Type Name","time_off_type_id":45678}},"certificate":{"status":"not-required"},"start":"2022-05-31T22:00:00.0Z","end":"2022-06-02T22:00:00.0Z","half_day_start":true,"half_day_end":false,"comment":"this is a comment","origin":"web","status":"approved","created_by":1,"created_at":"2022-06-20T14:29:56.510Z","updated_at":"2022-06-20T14:29:56.510Z","approved_at":"2022-06-20T14:29:56.510Z","breakdowns":[{"date":"2022-06-01","effective_duration":480},{"date":"2022-06-02","effective_duration":480}]}}],"offset":"0,","limit":"200,"}}}}}},"400":{"description":"Bad request","content":{"problem+json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"AbsenceType Not Found","content":{"problem+json":{"schema":{"properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"integer","example":404},"message":{"type":"string","example":"models.absence-types.not-found"}}}}}}}},"500":{"description":"Internal server error","content":{"problem+json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"security":[{"BearerAuth":[]}],"tags":["Absences"],"description":"Adds absence data for absence types with **time unit** set to **hours**. Note that creating periods for absence types with certificate requirement enabled is not supported!","summary":"Create an Absence Period","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/CreateAbsencePeriodRequest"}}},"description":"Absence data","required":true},"x-readme":{"code-samples":[{"language":"powershell","code":"Auto-generated code snippets for this language may not be supported"},{"language":"php","code":"Auto-generated code snippets for this language may not be supported"}]},"responses":{"201":{"description":"The absence period was successfully created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/HourlyAbsencePeriodResponse"}}},"examples":{"response":{"value":{"success":true,"data":[{"type":"AbsencePeriod","attributes":{"id":"9bba303f-0fbc-4514-9958-0befa21923fb","measurement_unit":"hour","effective_duration":960,"employee":{"type":"Employee","attributes":{"id":{"label":"id","value":2367,"type":"integer","universal_id":"id"},"first_name":{"label":"First name","value":"Michael","type":"standard","universal_id":"first_name"},"last_name":{"label":"Last name","value":"Miller","type":"standard","universal_id":"last_name"},"email":{"label":"Email","value":"michael.miller@demo.com","type":"standard","universal_id":"email"}}},"absence_type":{"type":"AbsenceType","attributes":{"id":"9bba303f-0fbc-4514-9958-0befa21923fb","name":"Absence Type Name","time_off_type_id":45678}},"certificate":{"status":"not-required"},"start":"2022-05-31T22:00:00.0Z","end":"2022-06-02T22:00:00.0Z","half_day_start":true,"half_day_end":false,"comment":"this is a comment","origin":"web","status":"approved","timezone":"Europe/Berlin","created_by":1,"created_at":"2022-06-20T14:29:56.510Z","updated_at":"2022-06-20T14:29:56.510Z","approved_at":"2022-06-20T14:29:56.510Z","breakdowns":[{"date":"2022-06-01","effective_duration":480},{"date":"2022-06-02","effective_duration":480}]}}]}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorInsertingAbsenceResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":400,"message":"Error when trying to insert absence period"}}}}}}},"404":{"description":"Employee or Absence type not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":0,"message":"Absence type not found."}}}}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCreateAbsenceResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":0,"message":"The given data failed to pass validation.","error_data":"{...}"}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":0,"message":"Something went wrong"}}}}}}}}}},"/company/absence-periods/{id}":{"parameters":[{"$ref":"#/components/parameters/XPersonioPartnerID"},{"$ref":"#/components/parameters/XPersonioAppID"}],"delete":{"security":[{"BearerAuth":[]}],"tags":["Absences"],"description":"Deletes absence period data for absence types with **time unit** set to **hours**.","summary":"Delete Absence Period by ID","parameters":[{"name":"id","in":"path","description":"ID of the absence period to delete","required":true,"schema":{"type":"string","format":"uuid","example":"61fe126b-a7b3-449a-b5ee-3865a6fcc546"}}],"responses":{"200":{"description":"Success response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletedAbsenceResponse"},"examples":{"response":{"value":{"success":true,"data":{"message":"The absence period was deleted."}}}}}}},"400":{"description":"Bad request response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorAbsenceResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":400,"message":"The absence period id is invalid."}}}}}}},"404":{"description":"Not found response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorAbsenceResponse"},"examples":{"response":{"value":{"success":false,"error":{"code":404,"message":"The absence period was not found."}}}}}}}}}},"/company/document-categories":{"parameters":[{"$ref":"#/components/parameters/XPersonioPartnerID"},{"$ref":"#/components/parameters/XPersonioAppID"}],"get":{"security":[{"BearerAuth":[]}],"tags":["Documents"],"description":"This endpoint is responsible for fetching all document categories of the company. The result contains a list of document categories.","summary":"List Document Categories","responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentCategoriesResponse"},"examples":{"response":{"value":{"success":true,"data":[{"id":1,"type":"DocumentCategory","attributes":{"name":"Certificates of employment"}},{"id":2,"type":"DocumentCategory","attributes":{"name":"Other documents"}}]}}}}}}}}},"/company/documents":{"parameters":[{"$ref":"#/components/parameters/XPersonioPartnerID"},{"$ref":"#/components/parameters/XPersonioAppID"}],"post":{"security":[{"BearerAuth":[]}],"tags":["Documents"],"description":"This endpoint is responsible for uploading documents for the company employees.\nThe Documents endpoint has a rate limit of 60 requests per minute.\n","summary":"Upload Document","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/DocumentUploadRequest"}}},"description":"Data necessary for document upload."},"x-readme":{"code-samples":[{"language":"powershell","code":"Auto-generated code snippets for this language may not be supported"},{"language":"php","code":"Auto-generated code snippets for this language may not be supported"},{"language":"ruby","code":"Auto-generated code snippets for this language may not be supported"},{"language":"java","code":"Auto-generated code snippets for this language may not be supported"}]},"responses":{"201":{"description":"The document was successfully uploaded to the employees profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentUploadSuccessResponse"},"examples":{"response":{"value":{"success":true,"data":{"id":1,"type":"Document","attributes":{"title":"Personio","date":"2022-02-02","comment":"Enable better organisations","employee":{"type":"Employee","attributes":{"id":{"label":"ID","value":1,"type":"integer","universal_id":"id"},"first_name":{"label":"First name","value":"Demo","type":"standard","universal_id":"first_name"},"last_name":{"label":"Last name","value":"Account","type":"standard","universal_id":"last_name"},"email":{"label":"Email","value":"demo.account@demo.de","type":"standard","universal_id":"email"}}},"category":{"id":1,"type":"DocumentCategory","attributes":{"name":"Other documents"}}}}}}}}}},"404":{"description":"This status code is returned if the provided employee_id or category_id are not found within the company.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentUploadFailedWithBadDocumentCategoryResponse"},"examples":{"response":{"value":{"success":false,"error":{"message":"No query results for model [DocumentCategory] 1","code":0}}}}}}},"422":{"description":"This status code is returned if the provided request parameters cannot be processed or if the parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentUploadFailedWithUnsupportedFileTypeResponse"},"examples":{"response":{"value":{"success":false,"error":{"message":"The given data was invalid.","code":0,"error_data":{"file":["The file must be a file of type: pdf, docx, doc, jpg, zip, png, txt, jpeg, odt, xlsx, rtf, htm, xls, p7s, pptx, pages, rar, ppt, gif, tif, html, msg, asc, tiff, wps, bmp, 7z, csv, ics, vcf, dotx, numbers, eps, gz, ods, otf, odp, odg, rtfd, txz, webarchive, xml, xps, md, fax."]}}}}}}}}}}},"/company/custom-reports/reports":{"get":{"tags":["Custom Reports"],"parameters":[{"$ref":"#/components/parameters/XPersonioPartnerID"},{"$ref":"#/components/parameters/XPersonioAppID"},{"name":"report_ids","in":"query","schema":{"type":"array","items":{"type":"string"}},"example":"eea50309-d1b1-47d6-bc7e-27de7a3ab491, baa50309-d1b1-47d6-bc76-27de7a3ab491","required":false,"description":"A list of report ID's to filter the results."},{"name":"status","in":"query","schema":{"type":"string"},"example":"up_to_date","required":false,"description":"The status of the report to filter the results."}],"description":"This endpoint provides you with metadata about existing custom reports in your Personio account, such as report name, report type, report date / timeframe.","summary":"List Custom Reports","operationId":"listReports","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicListReportsResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAPIException"}}}}}}},"/company/custom-reports/reports/{report_id}":{"get":{"tags":["Custom Reports"],"parameters":[{"$ref":"#/components/parameters/XPersonioPartnerID"},{"$ref":"#/components/parameters/XPersonioAppID"},{"name":"report_id","in":"path","schema":{"type":"string"},"example":"eea50309-d1b1-47d6-bc7e-27de7a3ab491","description":"The ID of the report to filter the result.","required":true},{"name":"locale","in":"query","description":"locale used to translate localized fields.","schema":{"type":"string"},"example":"de","required":false},{"name":"page","in":"query","description":"Pagination parameter to identify the page to return.","schema":{"type":"integer"},"example":1,"required":false},{"name":"limit","in":"query","description":"Pagination parameter to limit the number of employees returned per page.","schema":{"type":"integer"},"example":10,"required":false}],"description":"This endpoint provides you with the data of an existing Custom Report.","summary":"Get Custom Report by ID","operationId":"listReportItems","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReportResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAPIException"}}}},"404":{"description":"Report not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAPIException"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAPIException"}}}}}}},"/company/custom-reports/columns":{"get":{"tags":["Custom Reports"],"parameters":[{"$ref":"#/components/parameters/XPersonioPartnerID"},{"$ref":"#/components/parameters/XPersonioAppID"},{"name":"columns","in":"query","schema":{"type":"array","items":{"type":"string"}},"example":"first_name,last_name","description":"The columns to filter the results.","required":false},{"name":"locale","in":"query","schema":{"type":"string"},"example":"en","description":"locale used to translate localized fields.","required":false},{"name":"report_id","in":"query","schema":{"type":"string"},"example":"eea50309-d1b1-47d6-bc7e-27de7a3ab491","description":"The ID of the report to filter the result of the columns. If no ID is passed, all columns for the company are returned.","required":false}],"description":"This endpoint provides human-readable labels for report table columns. It is particularly important if you get a report with custom attributes or absence data to match the column IDs to the translation.","summary":"List Custom Report Column Labels","operationId":"listColumns","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicListColumnsResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAPIException"}}}}}}}},"servers":[{"url":"https://api.personio.de/v1"}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"XPersonioPartnerID":{"name":"X-Personio-Partner-ID","in":"header","required":false,"description":"The partner identifier","schema":{"type":"string"}},"XPersonioAppID":{"name":"X-Personio-App-ID","in":"header","required":false,"description":"The application identifier","schema":{"type":"string"}}},"schemas":{"Response":{"title":"Default response object","type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}},"required":["success","data"]},"DocumentUploadRequest":{"type":"object","properties":{"title":{"type":"string","description":"Title of the document. Maximum length is 255 characters."},"comment":{"type":"string","description":"Optional comment that can be added to the uploaded document."},"employee_id":{"type":"integer","description":"Employee identifier"},"category_id":{"type":"integer","description":"Document Category identifier"},"date":{"type":"string","format":"date","description":"Optional date can be added to the uploaded document. Must follow the format: Y-m-d"},"file":{"type":"string","format":"binary","description":"The document that shall be uploaded to an employees profile. Maximum file size is 30MB."}},"required":["title","employee_id","category_id","file"]},"DocumentUploadFailedWithBadDocumentCategoryResponse":{"type":"object","allOf":[{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string","example":"No query results for model [DocumentCategory] 1"},"code":{"type":"integer","example":0}}}}}]},"DocumentUploadFailedWithUnsupportedFileTypeResponse":{"type":"object","allOf":[{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string","example":"The given data was invalid."},"code":{"type":"integer","example":0},"error_data":{"type":"object","properties":{"file":{"type":"array","items":{"type":"string","example":"The file must be a file of type: pdf, docx, doc, jpg, zip, png, txt, jpeg, odt, xlsx, rtf, htm, xls, p7s, pptx, pages, rar, ppt, gif, tif, html, msg, asc, tiff, wps, bmp, 7z, csv, ics, vcf, dotx, numbers, eps, gz, ods, otf, odp, odg, rtfd, txz, webarchive, xml, xps, md, fax."}}}}}}}}]},"DocumentUploadSuccessResponse":{"type":"object","allOf":[{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"id":{"type":"integer","example":1},"type":{"type":"string","example":"Document"},"attributes":{"type":"object","properties":{"title":{"type":"string","example":"Document Title"},"date":{"type":"string","example":"2022-01-01"},"comment":{"type":"string","example":"Optional Test Comment"},"employee":{"$ref":"#/components/schemas/DocumentEmployeeResponseObject"},"category_id":{"$ref":"#/components/schemas/DocumentCategory"}}}}}}}]},"DocumentEmployeeResponseObject":{"type":"object","properties":{"id":{"type":"object","properties":{"label":{"type":"string","example":"ID"},"value":{"type":"integer","example":1},"type":{"type":"string","example":"standard"},"universal_id":{"type":"string","example":"id"}}},"first_name":{"type":"object","properties":{"label":{"type":"string","example":"First name"},"value":{"type":"string","example":"Michael"},"type":{"type":"string","example":"standard"},"universal_id":{"type":"string","example":"first_name"}}},"last_name":{"type":"object","properties":{"label":{"type":"string","example":"Last name"},"value":{"type":"string","example":"Dou"},"type":{"type":"string","example":"standard"},"universal_id":{"type":"string","example":"last_name"}}},"email":{"type":"object","properties":{"label":{"type":"string","example":"Email"},"value":{"type":"string","example":"michaeldou@demo.de"},"type":{"type":"string","example":"standard"},"universal_id":{"type":"string","example":"email"}}}}},"DocumentCategoriesResponse":{"type":"object","allOf":[{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/DocumentCategory"}}}}]},"DocumentCategory":{"type":"object","properties":{"id":{"type":"integer","example":1},"type":{"type":"string","example":"DocumentCategory"},"attributes":{"type":"object","properties":{"name":{"type":"string","example":"Certificates of employment"}}}}},"DeletedAbsenceResponse":{"title":"Default response object","type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"message":{"example":"The absence period was deleted."}}}}},"DeletedAttendanceResponse":{"title":"Default response object","type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"message":{"example":"The attendance period was deleted"}}}}},"UpdatedAttendanceResponse":{"title":"Default response object","type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"message":{"example":"The attendance period was updated."}}}}},"ErrorResponse":{"title":"Default error response","type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"integer","example":0},"message":{"example":"Something went wrong"}}}}},"ErrorCreateAbsenceResponse":{"title":"Default error response","type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"integer","example":0},"message":{"example":"The given data failed to pass validation."}}}}},"ErrorAbsenceResponse":{"title":"404 absence error","type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"integer","example":404},"message":{"example":"The absence period was not found."}}}}},"ErrorInsertingAbsenceResponse":{"title":"400 absence error","type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"integer","example":400},"message":{"example":"Error when trying to insert absence period"}}}}},"AttendanceCreateUpdate400ErrorResponse":{"title":"400 [Bad Request] Attendances Creation Error","type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"integer","example":400},"message":{"type":"string","example":"Error when trying to insert Attendances periods rows"},"detailed_message":{"type":"array","items":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error_msg":{"type":"string","example":"Existing overlapping attendances periods"},"id":{"type":"integer","nullable":true,"example":null},"employee":{"type":"integer","example":1234},"date":{"type":"string","example":"2017-01-01"},"start_time":{"type":"string","example":"09:00"},"end_time":{"type":"string","example":"18:00"},"break":{"type":"integer","example":60},"comment":{"type":"string","example":"Optional Test Comment"},"project_id":{"type":"integer","nullable":true,"example":null}}}}}}}},"AttendanceDelete400ErrorResponse":{"title":"400 [Bad Request] Attendance Error","type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"integer","example":400},"message":{"example":"Bad Request"}}}}},"Attendance404ErrorResponse":{"title":"404 [Not Found] Attendance Error","type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"integer","example":404},"message":{"example":"The attendance period was not found."}}}}},"Employee404ErrorResponse":{"title":"404 [Not Found] Employee Error","type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"integer","example":0},"message":{"example":"Es ist ein Problem aufgetreten"}}}}},"EmployeeCreatedResponse":{"title":"Successfully created employee response","type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"id":{"type":"number","example":1},"message":{"type":"string","example":"success"}}}}},"EmployeeCreationErrorResponse":{"title":"Employee creation failed due to invalid payload","type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"number","example":422},"message":{"type":"string","example":"Supervisor with ID 1 not found"}}}}},"EmployeeUpdatedResponse":{"title":"Successfully updated employee response","type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"id":{"type":"number","example":12345}}},"meta":{"type":"array","items":{"type":"string"},"default":[]}}},"EmployeeUpdateErrorResponse":{"title":"Employee update failed due to invalid payload","type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"number","example":422},"message":{"type":"string","example":"Supervisor with ID 1 not found"}}}}},"Office":{"type":"object","properties":{"label":{"example":"Office"},"value":{"type":"object","properties":{"type":{"type":"string","example":"Office"},"attributes":{"type":"object","properties":{"name":{"example":"Munich"}}}}},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"office"}}},"Department":{"type":"object","properties":{"label":{"example":"Department"},"value":{"type":"object","properties":{"type":{"type":"string","example":"Department"},"attributes":{"type":"object","required":["id","name"],"properties":{"id":{"type":"integer","example":1},"name":{"type":"string","example":"Marketing"}}}}},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"department"}}},"CostCenters":{"type":"object","properties":{"label":{"example":"Cost center"},"value":{"type":"array","items":{"type":"object","properties":{"type":{"example":"CostCenter"},"attributes":{"type":"object","properties":{"name":{"example":"Cost Center One"},"id":{"type":"number","example":1},"percentage":{"type":"number","example":50}}}}}},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"cost_center"}}},"HolidayCalendar":{"type":"object","properties":{"label":{"example":"Holiday Calendar"},"value":{"type":"object","properties":{"type":{"example":"HolidayCalendar"},"attributes":{"type":"object","properties":{"id":{"type":"number","example":1},"name":{"example":"DE (Hamburg) Feiertage"},"country":{"example":"DE"},"state":{"example":"Hamburg"}}}}},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"holiday_calendar"}}},"WorkSchedule":{"type":"object","properties":{"label":{"example":"WorkSchedule"},"value":{"type":"object","properties":{"type":{"example":"WorkSchedule"},"attributes":{"type":"object","properties":{"id":{"type":"number","example":1},"name":{"example":"Standard Hours"},"monday":{"example":"08:30","pattern":"^\\d\\d:\\d\\d$"},"tuesday":{"example":"08:30","pattern":"^\\d\\d:\\d\\d$"},"wednesday":{"example":"08:30","pattern":"^\\d\\d:\\d\\d$"},"thursday":{"example":"08:30","pattern":"^\\d\\d:\\d\\d$"},"friday":{"example":"08:30","pattern":"^\\d\\d:\\d\\d$"},"saturday":{"example":"00:00","pattern":"^\\d\\d:\\d\\d$"},"sunday":{"example":"00:00","pattern":"^\\d\\d:\\d\\d$"}}}}},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"work_schedule"}}},"Team":{"type":"object","properties":{"label":{"example":"Team"},"value":{"type":"object","properties":{"type":{"type":"string","example":"Team"},"attributes":{"type":"object","properties":{"name":{"example":"Management"}}}}},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"team"}}},"AbsenceEntitlement":{"type":"object","properties":{"label":{"example":"Absence entitlement"},"value":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["TimeOffType"]},"attributes":{"type":"object","properties":{"id":{"type":"integer","example":1},"name":{"example":"Paid Vacation"},"entitlement":{"example":30}}}}}}},"required":["label","value"]},"Supervisor":{"type":"object","properties":{"label":{"type":"string","example":"Supervisor"},"value":{"$ref":"#/components/schemas/ShortEmployee"}}},"Employee":{"type":"object","properties":{"id":{"type":"object","properties":{"label":{"example":"ID"},"value":{"example":1},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"id"}}},"first_name":{"type":"object","properties":{"label":{"example":"First name"},"value":{"example":"Michael"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"first_name"}}},"last_name":{"type":"object","properties":{"label":{"example":"Last name"},"value":{"example":"Dou"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"last_name"}}},"preferred_name":{"type":"object","properties":{"label":{"example":"Name (preferred)"},"value":{"example":"Michael Dou"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"preferred_name"}}},"email":{"type":"object","properties":{"label":{"example":"Email"},"value":{"example":"michael.dou@personio.de"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"email"}}},"gender":{"type":"object","properties":{"label":{"example":"Gender"},"value":{"example":"male"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"gender"}}},"status":{"type":"object","properties":{"label":{"example":"Status"},"value":{"example":"active"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"status"}}},"position":{"type":"object","properties":{"label":{"example":"Position"},"value":{"example":"Online Marketing Specialist"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"position"}}},"supervisor":{"$ref":"#/components/schemas/Supervisor"},"employment_type":{"type":"object","properties":{"label":{"example":"Employment type"},"value":{"example":"internal"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"employment_type"}}},"weekly_working_hours":{"type":"object","properties":{"label":{"example":"Weekly hours"},"value":{"example":40},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"weekly_working_hours"}}},"hire_date":{"type":"object","properties":{"label":{"example":"Hire date"},"value":{"example":"2012-02-01T00:00:00+0100"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"hire_date"}}},"contract_end_date":{"type":"object","properties":{"label":{"example":"Contact end date"},"value":{"example":"2020-02-01T00:00:00+0100"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"contract_end_date"}}},"termination_date":{"type":"object","properties":{"label":{"example":"Termonation date"},"value":{"example":"2020-02-01T00:00:00+0100"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"termination_date"}}},"termination_type":{"type":"object","properties":{"label":{"example":"Termonation type"},"value":{"example":null},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"termination_type"}}},"termination_reason":{"type":"object","properties":{"label":{"example":"Termonation reason"},"value":{"example":null},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"termination_reason"}}},"probation_period_end":{"type":"object","properties":{"label":{"example":"Probation period end"},"value":{"example":"2020-02-01T00:00:00+0100"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"probation_period_end"}}},"created_at":{"type":"object","properties":{"label":{"example":"Created at"},"value":{"example":"2018-02-01T00:00:00+0100"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"created_at"}}},"last_modified_at":{"type":"object","properties":{"label":{"example":"Last modified"},"value":{"example":"2020-11-18T17:33:55+01:00"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"last_modified_at"}}},"subcompany":{"$ref":"#/components/schemas/Office"},"office":{"$ref":"#/components/schemas/Office"},"department":{"$ref":"#/components/schemas/Department"},"cost_centers":{"$ref":"#/components/schemas/CostCenters"},"holiday_calendar":{"$ref":"#/components/schemas/HolidayCalendar"},"work_schedule":{"$ref":"#/components/schemas/WorkSchedule"},"absence_entitlement":{"$ref":"#/components/schemas/AbsenceEntitlement"},"team":{"$ref":"#/components/schemas/Team"},"fix_salary":{"type":"object","properties":{"label":{"example":"Fix salary"},"value":{"example":4000},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"fix_salary"},"currency":{"example":"EUR","type":"string"}}},"fix_salary_interval":{"type":"object","properties":{"label":{"example":"Salary interval"},"value":{"example":"monthly"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"fix_salary_interval"}}},"hourly_salary":{"type":"object","properties":{"label":{"example":"Hourly salary"},"value":{"example":0},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"hourly_salary"},"currency":{"example":"EUR","type":"string"}}},"last_working_day":{"type":"object","properties":{"label":{"example":"Last day of work"},"value":{"example":null},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"last_working_day"}}},"profile_picture":{"type":"object","properties":{"label":{"example":"Profile Picture"},"value":{"example":"http://api.dev.personio.de/v1/company/employees/1/profile-picture"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"profile_picture"}}},"dynamic_21827":{"type":"object","properties":{"label":{"example":"IBAN"},"value":{"example":"DE98 8989 9898 0000 8989 00"},"type":{"description":"The type of the field.","$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"iban"}}}}},"EmployeesResponse":{"title":"List of Employees","allOf":[{"$ref":"#/components/schemas/Response"},{"type":"object","properties":{"metadata":{"type":"object","required":["total_elements","current_page","total_pages"],"properties":{"total_elements":{"type":"integer","description":"The total number of items matching the query filters."},"total_pages":{"type":"integer","description":"The total number of pages distributing sets of items matching the query filters."},"current_page":{"type":"integer","description":"Current page number containing the returned set of items matching with the query filters. The page number range is from 0 to total_pages - 1"}}},"offset":{"type":"integer"},"limit":{"type":"integer"},"data":{"type":"array","items":{"type":"object","properties":{"type":{"example":"Employee"},"attributes":{"$ref":"#/components/schemas/Employee"}}}}}}]},"EmployeeResponse":{"title":"Employee Response","allOf":[{"$ref":"#/components/schemas/Response"},{"type":"object","properties":{"data":{"type":"object","properties":{"type":{"example":"Employee"},"attributes":{"$ref":"#/components/schemas/Employee"}}}}}]},"EmployeeAbsenceBalance":{"title":"Employee Absence Balance","type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","example":1234},"name":{"type":"string","example":"Paid Vacation"},"category":{"type":"string","example":"custom_absence"},"balance":{"type":"number","description":"Effective balance, as of request date; not deducting any upcoming absence periods, but only what has been taken. If the absence period is currently ongoing, the effective balance only considers the part of the period until today.\n","example":10.5},"available_balance":{"type":"number","description":"Available balance is what actually left to be planned (where upcoming absence periods are already deducted).","example":8.5}}}}}},"Project":{"type":"object","properties":{"id":{"type":"integer","example":1},"type":{"type":"string","example":"Project"},"attributes":{"type":"object","properties":{"name":{"type":"string","example":"Project name"},"active":{"example":true,"description":"Marks the availability of the project. The default value is false.","type":"boolean"},"created_at":{"example":"2022-02-01T12:00:00+0100","type":"string","format":"datetime"},"updated_at":{"example":"2022-02-01T12:00:00+0100","type":"string","format":"datetime"}}}}},"AttendanceProject":{"type":"object","properties":{"id":{"type":"integer","example":1},"type":{"type":"string","example":"Project"},"attributes":{"type":"object","properties":{"name":{"type":"string","example":"Project name"},"active":{"example":true,"description":"Marks the availability of the project. When a new project is created, it's set by default to false.","type":"boolean"}}}}},"Attendance":{"type":"object","properties":{"employee":{"example":1,"type":"integer"},"date":{"type":"string","format":"date"},"start_time":{"type":"string","pattern":"^\\d\\d:\\d\\d$","example":"08:00"},"end_time":{"type":"string","nullable":true,"pattern":"^\\d\\d:\\d\\d$","example":"17:00"},"break":{"type":"integer","example":60},"comment":{"type":"string","example":"I was productive as hell"},"is_holiday":{"type":"boolean","example":false},"is_on_time_off":{"type":"boolean","example":false},"status":{"type":"string","enum":["confirmed","pending","rejected"]},"project":{"type":"object","nullable":true,"properties":{"id":{"type":"integer","example":5},"type":{"type":"string","example":"Project"},"attributes":{"type":"object","properties":{"name":{"type":"string","example":"A project name"},"active":{"type":"boolean","example":true}}}}}}},"AttendanceCreateRequest":{"type":"object","properties":{"attendances":{"type":"array","items":{"type":"object","required":["employee","date","start_time","break"],"properties":{"employee":{"type":"integer","minimum":1,"example":1},"date":{"type":"string","format":"date"},"start_time":{"type":"string","pattern":"^\\d\\d:\\d\\d$","example":"08:00","description":"Format: hh:mm"},"end_time":{"type":"string","nullable":true,"pattern":"^\\d\\d:\\d\\d$","example":"17:00","description":"Format: hh:mm"},"break":{"type":"integer","minimum":0,"example":60},"comment":{"type":"string","nullable":true,"example":"I was productive as hell"},"project_id":{"type":"integer","nullable":true,"example":5}}},"minItems":1},"skip_approval":{"type":"boolean","description":"Optional, default value is true. If set to false, the approval status of the attendance period will be \"pending\" if an approval rule is set for the attendances type. The respective approval flow will be triggered."}}},"AttendanceUpdateRequest":{"type":"object","properties":{"date":{"type":"string","format":"date"},"start_time":{"type":"string","pattern":"^\\d\\d:\\d\\d$","example":"08:00","description":"Format: hh:mm"},"end_time":{"type":"string","nullable":true,"pattern":"^\\d\\d:\\d\\d$","example":"17:00","description":"Format: hh:mm"},"break":{"type":"integer","minimum":0,"example":60},"comment":{"type":"string","nullable":true,"example":"I was productive as hell"},"project_id":{"type":"integer","nullable":true,"example":5},"skip_approval":{"type":"boolean","description":"Optional, default value is true. If set to false, the approval status of the attendance period will be \"pending\" if an approval rule is set for the attendances type. The respective approval flow will be triggered."}}},"AttendancePeriodsResponse":{"title":"List All Attendance Periods response","type":"object","allOf":[{"$ref":"#/components/schemas/Response"},{"type":"object","properties":{"metadata":{"type":"object","required":["total_elements","current_page","total_pages"],"properties":{"total_elements":{"type":"integer","description":"The total number of items matching the query filters."},"total_pages":{"type":"integer","description":"The total number of pages distributing sets of items matching the query filters."},"current_page":{"type":"integer","description":"Current page number containing the returned set of items matching with the query filters. The page number range is from 0 to total_pages - 1"}}},"offset":{"type":"integer"},"limit":{"type":"integer"},"data":{"type":"array","items":{"type":"object","required":["id","type","attributes"],"properties":{"id":{"type":"integer","example":1},"type":{"example":"AttendancePeriod"},"attributes":{"$ref":"#/components/schemas/Attendance"}}}}}}]},"NewAttendancePeriodParametersRequest":{"title":"Create a New Attendance Period request","type":"object","properties":{"attendances[][employee]":{"type":"integer","description":"Employee identifier"},"attendances[][date]":{"type":"string","format":"date","description":"Attendance date. Format: yyyy-mm-dd","example":"2020-01-31"},"attendances[][start_time]":{"type":"string","pattern":"^\\d\\d:\\d\\d$","description":"Start time. Format: hh:mm","example":"08:00"},"attendances[][end_time]":{"type":"string","nullable":true,"pattern":"^\\d\\d:\\d\\d$","description":"End time. Format: hh:mm","example":"12:00"},"attendances[]break":{"type":"integer","minimum":0,"format":"int32","description":"Break in minutes"},"attendances[][comment]":{"type":"string","nullable":true,"description":"Optional comment"},"skip_approval":{"type":"boolean","description":"Optional, default value is true. If set to false, the approval status of the attendance period will be \"pending\" if an approval rule is set for the attendances type. The respective approval flow will be triggered."},"project_id":{"type":"integer","nullable":true,"format":"int32","description":"The ID of the project","example":5}},"required":["attendances[][employee]","attendances[][date]","attendances[][start_time]","attendances[]break"]},"NewAttendancePeriodResponse":{"type":"object","allOf":[{"$ref":"#/components/schemas/Response"},{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"array","items":{"type":"integer","example":1}},"message":{"example":"Success"}}}}}]},"TimeOffTypeResource":{"title":"Type of time-off resource","type":"object","properties":{"type":{"type":"string","enum":["TimeOffType"],"description":"Time-off type resource name"},"attributes":{"type":"object","properties":{"id":{"type":"integer","description":"identifier","example":1},"name":{"type":"string","example":"Paid vacation"},"category":{"type":"string","nullable":true,"enum":["family_care","maternity_parental_leave","child_care","short_time_allowance","quarantine","lockout","irrevocable_exemption","sick_leave","voluntary_military_service","unlawful_strike","lawful_strike","paid_vacation","unpaid_vacation","unexcused_absence","offsite_work","other","undefined"],"example":"offsite_work"},"unit":{"type":"string","enum":["day","hour"],"example":"day"},"approval_required":{"type":"boolean","example":true}}}}},"CreateTimeOffPeriodRequest":{"title":"Create time-off periods","type":"object","properties":{"employee_id":{"type":"integer","description":"Employee identifier"},"time_off_type_id":{"type":"integer","description":"Time-off type identifier"},"start_date":{"type":"string","format":"date","description":"Absence start date. Format: yyyy-mm-dd","example":"2020-01-31"},"end_date":{"type":"string","format":"date","description":"Absence end date. Format: yyyy-mm-dd","example":"2020-01-31"},"half_day_start":{"type":"boolean","example":false,"description":"Whether the start date is a half-day off."},"half_day_end":{"type":"boolean","example":false,"description":"Whether the end date is a half-day off."},"comment":{"type":"string","example":"Some Comment","description":"Optional comment"},"skip_approval":{"type":"boolean","example":false,"description":"Optional, default value is true. If set to false, the approval status of the absence request will be \"pending\" if an approval rule is set for the absence type in Personio. The respective approval flow will be triggered."}},"required":["employee_id","time_off_type_id","start_date","end_date","half_day_start","half_day_end"]},"CreateAbsencePeriodRequest":{"title":"Create Absence periods with **time unit** set to **hours**","type":"object","properties":{"employee_id":{"type":"integer","description":"Employee identifier","example":10735},"time_off_type_id":{"type":"integer","description":"Time-off type identifier","example":10735},"start_date":{"type":"string","format":"date","description":"Absence start date. Format: yyyy-mm-dd","example":"2020-01-31"},"end_date":{"type":"string","format":"date","description":"Absence end date. Format: yyyy-mm-dd","example":"2020-01-31"},"start_time":{"type":"string","format":"date","description":"Absence start time. Format: HH:mm (hours and minutes) and only required if the start_date and end_date are the same (partial-day absence)","example":"03:00"},"end_time":{"type":"string","format":"date","description":"Absence end time. Format: HH:mm (hours and minutes) and only required if the start_date and end_date are the same (partial-day absence)","example":"15:00"},"half_day_start":{"type":"boolean","example":false,"description":"Whether the start date is a half-day off, only considered if the start_date and end_date are not the same (more than one day absence)"},"half_day_end":{"type":"boolean","example":false,"description":"Whether the end date is a half-day off, only considered if the start_date and end_date are not the same (more than one day absence)"},"comment":{"type":"string","example":"Some Comment","description":"Optional comment"},"skip_approval":{"type":"boolean","example":false,"description":"Optional, default value is true. If set to false, the approval status of the absence request will be \"pending\" if an approval rule is set for the absence type in Personio. The respective approval flow will be triggered."}},"required":["employee_id","time_off_type_id","start_date","end_date"]},"AbsencePeriodsResponse":{"title":"List All Absence Periods response","type":"object","allOf":[{"$ref":"#/components/schemas/Response"},{"type":"object","properties":{"metadata":{"type":"object","required":["total_elements","current_page","total_pages"],"properties":{"total_elements":{"type":"integer","description":"The total number of items matching the query filters."},"total_pages":{"type":"integer","description":"The total number of pages distributing sets of items matching the query filters."},"current_page":{"type":"integer","description":"Current page number containing the returned set of items matching with the query filters. The page number range is from 0 to total_pages - 1"}}},"offset":{"type":"integer"},"limit":{"type":"integer"},"data":{"type":"array","items":{"type":"object","required":["type","attributes"],"properties":{"type":{"example":"TimeOffPeriod"},"attributes":{"$ref":"#/components/schemas/Absence"}}}}}}]},"HourlyAbsencePeriodsResponse":{"title":"List All Hourly Absence Periods response","type":"object","allOf":[{"$ref":"#/components/schemas/Response"},{"type":"object","properties":{"metadata":{"type":"object","required":["total_elements","current_page","total_pages"],"properties":{"total_elements":{"type":"integer","description":"The total number of items matching the query filters."},"total_pages":{"type":"integer","description":"The total number of pages distributing sets of items matching the query filters."},"current_page":{"type":"integer","description":"Current page number containing the returned set of items matching with the query filters. The page number range is from 0 to total_pages - 1"}}},"offset":{"type":"integer"},"limit":{"type":"integer"},"data":{"type":"array","items":{"type":"object","required":["type","attributes"],"properties":{"type":{"example":"AbsencePeriod"},"attributes":{"$ref":"#/components/schemas/HourlyAbsence"}}}}}}]},"HourlyAbsencePeriodResponseAttributes":{"type":"object","required":["id","employee","absence_type_id","start","half_day_start","half_day_end","origin","status","certificate","created_by","effective_duration","created_at","updated_at","breakdowns"],"properties":{"id":{"type":"string","example":"9bba303f-0fbc-4514-9958-0befa21923fb"},"measurement_unit":{"type":"string","enum":["minutes"],"example":"minutes"},"effective_duration":{"type":"integer","example":60,"description":"Period effective duration in minutes"},"employee":{"$ref":"#/components/schemas/ShortEmployee"},"absence_type_id":{"$ref":"#/components/schemas/AbsenceType"},"certificate":{"type":"object","properties":{"status":{"example":"not-required","type":"string"}}},"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time","nullable":true},"half_day_start":{"type":"boolean"},"half_day_end":{"type":"boolean"},"comment":{"type":"string"},"origin":{"type":"string","nullable":true,"enum":["web","api","mobile","slack","msteams"],"example":"web"},"status":{"type":"string","example":"approved"},"created_by":{"type":"integer","example":1,"description":"ID of the employee who created the absence period."},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"approved_at":{"type":"string","format":"date-time","nullable":true},"breakdowns":{"type":"array","description":"Breakdowns of effective duration by day of absence.","items":{"$ref":"#/components/schemas/AbsencePeriodBreakdown"}}}},"AbsencePeriodResponse":{"title":"Absence Periods response","type":"object","allOf":[{"$ref":"#/components/schemas/Response"},{"type":"object","properties":{"data":{"type":"object","required":["type","attributes"],"properties":{"type":{"example":"TimeOffPeriod"},"attributes":{"$ref":"#/components/schemas/Absence"}}}}}]},"HourlyAbsencePeriodResponse":{"title":"Absence Periods response","type":"object","allOf":[{"$ref":"#/components/schemas/Response"},{"type":"object","properties":{"data":{"type":"object","required":["type","attributes"],"properties":{"type":{"example":"AbsencePeriod"},"attributes":{"$ref":"#/components/schemas/HourlyAbsence"}}}}}]},"Absence":{"type":"object","properties":{"id":{"type":"integer","example":1},"status":{"type":"string","example":"approved"},"start_date":{"type":"string","example":"2017-12-27T00:00:00+0100"},"end_date":{"type":"string","example":"2017-12-79T00:00:00+0100"},"days_count":{"type":"number","example":3},"half_day_start":{"type":"boolean","example":false},"half_day_end":{"type":"boolean","example":false},"time_off_type":{"type":"object","properties":{"type":{"type":"string","example":"TimeOffType"},"attributes":{"type":"object","properties":{"id":{"type":"integer","example":1},"name":{"type":"string","example":"Vacation"},"category":{"type":"string","example":"offsite_work"}}}}},"employee":{"$ref":"#/components/schemas/ShortEmployee"},"certificate":{"type":"object","properties":{"status":{"example":"not-required","type":"string"}}},"created_at":{"type":"string","example":"2017-01-17T10:32:18+0100"},"created_by":{"type":"string","example":"API","description":"API if the origin is api, otherwise returns an admin employee's name who's account is used to create the absence"},"updated_at":{"type":"string","example":"2017-01-17T10:32:18+0100"}}},"HourlyAbsence":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"61fe126b-a7b3-449a-b5ee-3865a6fcc546"},"measurement_unit":{"type":"string","example":"hours"},"effective_duration":{"type":"integer","example":16,"description":"Period effective duration in minutes"},"employee":{"$ref":"#/components/schemas/ShortEmployee"},"absence_type":{"$ref":"#/components/schemas/AbsenceType"},"certificate":{"type":"object","properties":{"status":{"example":"not-required","type":"string"}}},"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time","nullable":true},"half_day_start":{"type":"boolean"},"half_day_end":{"type":"boolean"},"comment":{"type":"string"},"origin":{"type":"string","example":"web"},"status":{"type":"string","example":"approved"},"timezone":{"type":"string","example":"Europe/Berlin"},"created_by":{"type":"integer","example":1,"description":"ID of the employee who created the absence period."},"created_at":{"type":"string","example":"2017-01-17T10:32:18+0100"},"updated_at":{"type":"string","example":"2017-01-17T10:32:18+0100"},"approved_at":{"type":"string","format":"date-time","nullable":true},"breakdowns":{"type":"array","description":"Breakdowns of effective duration by day of absence.","items":{"$ref":"#/components/schemas/AbsencePeriodBreakdown"}}}},"AbsenceType":{"type":"object","required":["id"],"properties":{"id":{"type":"string","format":"uuid","example":"61fe126b-a7b3-449a-b5ee-3865a6fcc546"},"name":{"type":"string","example":"Absence Type Name"},"time_off_type_id":{"type":"integer","example":1}}},"AbsencePeriodBreakdown":{"type":"object","required":["date","effective_duration"],"properties":{"date":{"type":"string","format":"date"},"effective_duration":{"description":"Number representing the value of duration in minutes.","type":"integer","example":60}}},"ShortEmployee":{"type":"object","properties":{"type":{"type":"string","example":"Employee"},"attributes":{"type":"object","properties":{"id":{"type":"object","properties":{"label":{"example":1},"value":{"example":"id"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"id"}}},"first_name":{"type":"object","properties":{"label":{"example":"First Name"},"value":{"example":"Michael"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"first_name"}}},"last_name":{"type":"object","properties":{"label":{"example":"Last Name"},"value":{"example":"Dou"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"last_name"}}},"email":{"type":"object","properties":{"label":{"example":"Email"},"value":{"example":"michael.dou@personio.de"},"type":{"$ref":"#/components/schemas/TypeEnum"},"universal_id":{"example":"email"}}}}}}},"TypeEnum":{"type":"string","example":"standard","enum":["standard","date","integer","decimal","list","link","tags","multiline"]},"PublicListReportsResponse":{"type":"object","properties":{"success":{"type":"boolean"},"metadata":{"$ref":"#/components/schemas/PublicReportMetaData"},"offset":{"type":"integer"},"limit":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicReportData"}}}},"PublicReportResponse":{"type":"object","properties":{"success":{"type":"boolean"},"metadata":{"$ref":"#/components/schemas/PublicReportMetaData"},"offset":{"type":"integer","deprecated":true},"limit":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicReportItemsData"}}}},"PublicListColumnsResponse":{"type":"object","properties":{"success":{"type":"boolean"},"metadata":{"$ref":"#/components/schemas/PublicReportMetaData"},"offset":{"type":"integer"},"limit":{"type":"integer"},"data":{"$ref":"#/components/schemas/PublicColumnData"}}},"PublicReportMetaData":{"type":"object","properties":{"total_elements":{"type":"integer"},"current_page":{"type":"integer"},"total_pages":{"type":"integer"}}},"PublicReportData":{"type":"object","properties":{"type":{"type":"string","example":"Report"},"attributes":{"$ref":"#/components/schemas/PublicReportAttributes"}}},"PublicReportItemsData":{"type":"object","properties":{"type":{"type":"string","example":"Report"},"attributes":{"oneOf":[{"$ref":"#/components/schemas/PublicReportItemsAttributes"},{"$ref":"#/components/schemas/PublicTimeframeReportItemsAttributes"},{"$ref":"#/components/schemas/PublicHistoricalReportItemsAttributes"}]}}},"PublicColumnData":{"type":"object","properties":{"type":{"type":"string","example":"Column"},"attributes":{"type":"array","items":{"$ref":"#/components/schemas/PublicColumnAttributes"}}}},"PublicColumnAttributes":{"type":"object","properties":{"attribute_id":{"type":"string","example":"first_name"},"human_readable":{"type":"string","example":"First Name"},"data_type":{"type":"string","example":"TEXT"}}},"PublicReportAttributes":{"type":"object","properties":{"id":{"type":"string","example":"eb7482f3-2323-43e2-87ed-99d2399e8e22"},"name":{"type":"string","example":"Employee vacations past month"},"description":{"type":"string","example":"Shows vacations of all employees that were taken past month"},"author_first_name":{"type":"string","description":"Report author","example":"Robert"},"author_last_name":{"type":"string","description":"Report author","example":"Sirano"},"type":{"type":"string","example":"point_in_time","enum":["point_in_time","historical_data","timeframe"]},"status":{"type":"string","example":"up_to_date","enum":["up_to_date","updating","update_failed"]},"start_date":{"type":"string","format":"date","example":"2022-09-01"},"end_date":{"type":"string","format":"date","example":"2022-09-30"},"created_at":{"type":"string","format":"date-time","example":"2022-04-10T17:32:28Z"},"updated_at":{"type":"string","format":"date-time","example":"2022-04-10T17:32:28Z"},"data_refreshed_at":{"type":"string","format":"date-time","example":"2022-04-10T17:32:28Z"},"columns":{"type":"array","items":{"type":"string"}},"filters":{"type":"array","items":{"type":"object","properties":{"column":{"type":"string","example":"office_id"},"comparison":{"type":"string","example":"eq"},"value":{"type":"string","example":1}}}},"period_type":{"type":"string","example":"fixed","enum":["fixed","today","last_day_of_this_month","this_year","last_month","last_thirty_days","this_month","year_to_date"]}}},"PublicReportItemsAttributes":{"type":"object","properties":{"id":{"type":"string","example":"eb7482f3-2323-43e2-87ed-99d2399e8e22"},"name":{"type":"string","example":"Employee vacations at a specific point in time"},"description":{"type":"string","example":"Shows vacations of all employees on a specific date"},"author_first_name":{"type":"string","description":"Report author","example":"Robert"},"author_last_name":{"type":"string","description":"Report author","example":"Sirano"},"type":{"type":"string","example":"point_in_time","enum":["point_in_time"]},"status":{"type":"string","example":"created","enum":["up_to_date","updating","update_failed"]},"start_date":{"type":"string","format":"date-time","example":"2022-04-10"},"end_date":{"type":"string","format":"date-time","example":"2022-04-10"},"created_at":{"type":"string","format":"date-time","example":"2022-04-10T17:32:28Z"},"updated_at":{"type":"string","format":"date-time","example":"2022-04-10T17:32:28Z"},"data_refreshed_at":{"type":"string","format":"date-time","example":"2022-04-10T17:32:28Z"},"columns":{"type":"array","items":{"type":"string"}},"filters":{"type":"array","items":{"type":"object","properties":{"column":{"type":"string","example":"office_id"},"comparison":{"type":"string","example":"eq"},"value":{"type":"string","example":1}}}},"period_type":{"type":"string","example":"fixed","enum":["fixed","today","yesterday","last_day_of_this_week","last_day_of_last_week","last_day_of_this_month","last_day_of_last_month","last_day_of_this_quarter","last_day_of_last_quarter","last_day_of_this_year","last_day_of_last_year"]},"items":{"type":"array","items":{"type":"object","properties":{"employee_id":{"type":"integer","example":17},"attributes":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/DefaultAttribute"},{"$ref":"#/components/schemas/EntityAttribute"},{"$ref":"#/components/schemas/DurationAttribute"},{"$ref":"#/components/schemas/CostCenterAttribute"},{"$ref":"#/components/schemas/AbsenceOverviewAttribute"},{"$ref":"#/components/schemas/AbsencePeriodAttribute"},{"$ref":"#/components/schemas/PerformanceTargetAttribute"},{"$ref":"#/components/schemas/PerformanceKpiAttribute"},{"$ref":"#/components/schemas/SalaryAttribute"},{"$ref":"#/components/schemas/CompensationAttribute"}]}}}}}}},"PublicTimeframeReportItemsAttributes":{"type":"object","properties":{"id":{"type":"string","example":"eb7482f3-2323-43e2-87ed-99d2399e8e22"},"name":{"type":"string","example":"Employee vacations past month"},"description":{"type":"string","example":"Shows vacations of all employees that were taken past month"},"author_first_name":{"type":"string","description":"Report author","example":"Robert"},"author_last_name":{"type":"string","description":"Report author","example":"Sirano"},"type":{"type":"string","example":"timeframe","enum":["timeframe"]},"status":{"type":"string","example":"created","enum":["up_to_date","updating","update_failed"]},"start_date":{"type":"string","format":"date-time","example":"2022-04-01"},"end_date":{"type":"string","format":"date-time","example":"2022-04-10"},"created_at":{"type":"string","format":"date-time","example":"2022-04-10T17:32:28Z"},"updated_at":{"type":"string","format":"date-time","example":"2022-04-10T17:32:28Z"},"data_refreshed_at":{"type":"string","format":"date-time","example":"2022-04-10T17:32:28Z"},"columns":{"type":"array","items":{"type":"string"}},"filters":{"type":"array","items":{"type":"object","properties":{"column":{"type":"string","example":"office_id"},"comparison":{"type":"string","example":"eq"},"value":{"type":"string","example":1}}}},"period_type":{"type":"string","example":"fixed","enum":["fixed","today","yesterday","this_week","last_week","this_month","last_month","last_thirty_days","next_month","this_quarter","last_quarter","this_year","year_to_date","last_year","next_year"]},"items":{"type":"array","items":{"type":"object","properties":{"employee_id":{"type":"integer","example":17},"attributes":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/DefaultAttribute"},{"$ref":"#/components/schemas/EntityAttribute"},{"$ref":"#/components/schemas/DurationAttribute"},{"$ref":"#/components/schemas/CostCenterAttribute"},{"$ref":"#/components/schemas/AbsenceOverviewAttribute"},{"$ref":"#/components/schemas/AbsencePeriodAttribute"},{"$ref":"#/components/schemas/PerformanceTargetAttribute"},{"$ref":"#/components/schemas/PerformanceKpiAttribute"},{"$ref":"#/components/schemas/SalaryAttribute"},{"$ref":"#/components/schemas/CompensationAttribute"}]}}}}}}},"PublicHistoricalReportItemsAttributes":{"type":"object","properties":{"id":{"type":"string","example":"eb7482f3-2323-43e2-87ed-99d2399e8e22"},"name":{"type":"string","example":"Department changes in the past year"},"description":{"type":"string","example":"Shows department changes of all employees over the past year"},"author_first_name":{"type":"string","description":"Report author","example":"Robert"},"author_last_name":{"type":"string","description":"Report author","example":"Sirano"},"type":{"type":"string","example":"historical_data","enum":["historical_data"]},"status":{"type":"string","example":"created","enum":["up_to_date","updating","update_failed"]},"start_date":{"type":"string","format":"date-time","example":"2022-01-01"},"end_date":{"type":"string","format":"date-time","example":"2022-09-30"},"created_at":{"type":"string","format":"date-time","example":"2022-04-10T17:32:28Z"},"updated_at":{"type":"string","format":"date-time","example":"2022-04-10T17:32:28Z"},"data_refreshed_at":{"type":"string","format":"date-time","example":"2022-04-10T17:32:28Z"},"columns":{"type":"array","items":{"type":"string"}},"filters":{"type":"array","items":{"type":"object","properties":{"column":{"type":"string","example":"office_id"},"comparison":{"type":"string","example":"eq"},"value":{"type":"string","example":1}}}},"period_type":{"type":"string","example":"fixed","enum":["fixed","today","yesterday","this_week","last_week","this_month","last_month","last_thirty_days","next_month","this_quarter","last_quarter","this_year","year_to_date","last_year","next_year"]},"items":{"type":"array","items":{"type":"object","properties":{"employee_id":{"type":"integer","example":17},"historical_attributes":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/DefaultHistoricalAttribute"},{"$ref":"#/components/schemas/EntityHistoricalAttribute"},{"$ref":"#/components/schemas/DurationHistoricalAttribute"},{"$ref":"#/components/schemas/CostCenterHistoricalAttribute"},{"$ref":"#/components/schemas/SalaryHistoricalAttribute"}]}}}}}}},"DefaultAttribute":{"type":"object","properties":{"attribute_id":{"type":"string","example":"first_name"},"data_type":{"type":"string","enum":["TEXT"]},"value":{"type":"string","example":"Robert"},"employee_id":{"type":"integer","example":17}}},"EntityAttribute":{"type":"object","properties":{"attribute_id":{"type":"string","example":"department"},"entity_id":{"type":"string","example":1},"data_type":{"type":"string","enum":["ENTITY"]},"value":{"type":"string","example":"IT"},"employee_id":{"type":"integer","example":17}}},"CostCenterAttribute":{"type":"object","properties":{"attribute_id":{"type":"string","example":"cost_center"},"data_type":{"type":"string","enum":["COST_CENTER"]},"employee_id":{"type":"integer","example":17},"cost_centers":{"type":"array","items":{"$ref":"#/components/schemas/CostCenter"}}}},"CostCenter":{"type":"object","properties":{"cost_center_id":{"type":"string","example":1},"value":{"type":"string","example":"Test Center"},"weight":{"type":"string","example":"100%"}}},"AbsenceOverviewAttribute":{"type":"object","properties":{"attribute_id":{"type":"string","example":"absence_123"},"data_type":{"type":"string","enum":["ABSENCE_OVERVIEW"]},"start_date":{"type":"string","format":"date","example":"2022-03-01"},"end_date":{"type":"string","format":"date","example":"2022-03-03"},"duration_days":{"type":"string","example":2},"duration_hours":{"type":"string","example":5},"employee_id":{"type":"integer","example":17}}},"AbsencePeriodAttribute":{"type":"object","properties":{"attribute_id":{"type":"string","example":"absence_123:periods"},"data_type":{"type":"string","enum":["ABSENCE_PERIOD"]},"start_date":{"type":"string","format":"date","example":"2022-03-01"},"end_date":{"type":"string","format":"date","example":"2022-03-03"},"half_day_at_start":{"type":"boolean"},"half_day_at_end":{"type":"boolean"},"employee_id":{"type":"integer","example":17}}},"DurationAttribute":{"type":"object","properties":{"attribute_id":{"type":"string","example":"attendance_contractual_target_hours"},"data_type":{"type":"string","enum":["DURATION"]},"duration":{"type":"integer","example":10},"employee_id":{"type":"integer","example":17}}},"PerformanceTargetAttribute":{"type":"object","properties":{"attribute_id":{"type":"string","example":"performance_target_name"},"data_type":{"type":"string","enum":["PERFORMANCE_TARGET"]},"employee_id":{"type":"integer","example":17},"performance_targets":{"type":"array","items":{"$ref":"#/components/schemas/PerformanceTarget"}}}},"PerformanceTarget":{"type":"object","properties":{"performance_target_id":{"type":"string","example":1},"performance_target_value":{"type":"string","example":20}}},"PerformanceKpiAttribute":{"type":"object","properties":{"attribute_id":{"type":"string"},"data_type":{"type":"string","enum":["PERFORMANCE_KPI"]},"employee_id":{"type":"integer","example":17},"performance_target_kpis":{"type":"array","items":{"$ref":"#/components/schemas/PerformanceTarget"}}}},"PerformanceTargetKpi":{"type":"object","properties":{"performance_target_id":{"type":"string","example":"id_123"},"performance_kpis":{"type":"array","items":{"$ref":"#/components/schemas/PerformanceKpi"}}}},"PerformanceKpi":{"type":"object","properties":{"performance_kpi_id":{"type":"string","example":"kpi_123"},"performance_kpi_value":{"type":"string","example":14}}},"SalaryAttribute":{"type":"object","properties":{"attribute_id":{"type":"string","example":"salary_123"},"data_type":{"type":"string","enum":["SALARY"]},"amount":{"type":"string","example":12.2},"currency_symbol":{"type":"string","example":"$"},"employee_id":{"type":"integer","example":17}}},"CompensationAttribute":{"type":"object","properties":{"attribute_id":{"type":"string","example":"ABCXXX"},"data_type":{"type":"string","enum":["COMPENSATION"]},"amount":{"type":"string","example":12.2},"currency_code":{"type":"string","example":"USD"},"currency_symbol":{"type":"string","example":"$"},"overtime_hours":{"type":"string","example":12},"bonus_type":{"type":"string","example":"MAX"},"employee_id":{"type":"integer","example":17}}},"DefaultHistoricalAttribute":{"type":"object","properties":{"attribute_id":{"type":"string","example":"first_name"},"data_type":{"type":"string","enum":["TEXT"]},"value":{"type":"string","example":"Robert"},"employee_id":{"type":"integer","example":17},"effective_date":{"type":"string","example":"2021-01-01"}}},"DurationHistoricalAttribute":{"type":"object","properties":{"attribute_id":{"type":"string","example":"attendance_contractual_target_hours"},"data_type":{"type":"string","enum":["DURATION"]},"duration":{"type":"integer","example":10},"employee_id":{"type":"integer","example":17},"effective_date":{"type":"string","example":"2021-01-01"}}},"EntityHistoricalAttribute":{"type":"object","properties":{"attribute_id":{"type":"string","example":"department"},"entity_id":{"type":"string","example":1},"data_type":{"type":"string","enum":["ENTITY"]},"value":{"type":"string","example":"IT"},"employee_id":{"type":"integer","example":17},"effective_date":{"type":"string","example":"2021-01-01"}}},"CostCenterHistoricalAttribute":{"type":"object","properties":{"attribute_id":{"type":"string","example":"cost_center"},"data_type":{"type":"string","enum":["COST_CENTER"]},"employee_id":{"type":"integer","example":17},"cost_centers":{"type":"array","items":{"$ref":"#/components/schemas/CostCenter"}},"effective_date":{"type":"string","example":"2021-01-01"}}},"SalaryHistoricalAttribute":{"type":"object","properties":{"attribute_id":{"type":"string","example":"salary_123"},"data_type":{"type":"string","enum":["SALARY"]},"amount":{"type":"string","example":12.2},"currency_symbol":{"type":"string","example":"$"},"employee_id":{"type":"integer","example":17},"effective_date":{"type":"string","example":"2021-01-01"}}},"PublicAPIException":{"type":"array","items":{"$ref":"#/components/schemas/CustomReportsErrorResponse"}},"CustomReportsErrorResponse":{"type":"object","properties":{"status":{"type":"integer","example":500},"trace_id":{"type":"string","example":"ABCXXX"},"timestamp":{"type":"string","format":"date-time","example":"2020-01-01T00:00:00Z"},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorDetails"}}}},"ErrorDetails":{"type":"object","properties":{"title":{"type":"string","example":"Not Found"},"details":{"type":"string","example":"Report not found"},"type":{"type":"string","example":"search"},"_meta":{"type":"array","items":{"$ref":"#/components/schemas/ErrorMeta"}}}},"ErrorMeta":{"type":"object","properties":{"field":{"type":"string","example":"ID"},"description":{"type":"string","example":"Report ID not found"}}}},"examples":{"401UnauthorizedErrorExample":{"value":{"success":false,"error":{"message":"Authorization is not provided","code":401}}},"403ForbiddenErrorExample":{"value":{"success":false,"error":{"message":"Provided authorization is not valid","code":403}}}},"responses":{"401UnauthorizedResponse":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"response":{"$ref":"#/components/examples/401UnauthorizedErrorExample"}}}}},"403ForbiddenResponse":{"description":"Forbidden Access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"response":{"$ref":"#/components/examples/403ForbiddenErrorExample"}}}}}}},"_id":"58cd4a8450a0c12500e89bf8"},"oasPublicUrl":"@personio/v1.0#3pfh7vm2n29l5l","oauth":false,"rdmd":{"baseUrl":"/","body":"","opts":{"alwaysThrow":false,"compatibilityMode":false,"copyButtons":true,"correctnewlines":false,"markdownOptions":{"fences":true,"commonmark":true,"gfm":true,"ruleSpaces":false,"listItemIndent":"1","spacedTable":true,"paddedTable":true},"normalize":true,"lazyImages":true,"reusableContent":{"tags":{},"wrap":false},"safeMode":false,"settings":{"position":true},"theme":"light","baseUrl":"/","terms":[],"variables":{"user":{},"defaults":[{"source":"security","_id":"640201ebb4e93c007aad11f1","name":"bearerAuth","type":"http","scheme":"bearer","apiSetting":"609158e7204c7e001baff965"},{"source":"security","_id":"671a09d65afe4c001f2e5a22","name":"BearerAuth","type":"http","scheme":"bearer","apiSetting":"58cd4a8450a0c12500e89bf8"}]}},"terms":[],"variables":{"user":{},"defaults":[{"source":"security","_id":"640201ebb4e93c007aad11f1","name":"bearerAuth","type":"http","scheme":"bearer","apiSetting":"609158e7204c7e001baff965"},{"source":"security","_id":"671a09d65afe4c001f2e5a22","name":"BearerAuth","type":"http","scheme":"bearer","apiSetting":"58cd4a8450a0c12500e89bf8"}]},"mdx":false},"slugUrl":"/reference/post_company-documents","suggestedEdits":false,"variables":{"defaults":[{"source":"security","_id":"640201ebb4e93c007aad11f1","name":"bearerAuth","type":"http","scheme":"bearer","apiSetting":"609158e7204c7e001baff965"},{"source":"security","_id":"671a09d65afe4c001f2e5a22","name":"BearerAuth","type":"http","scheme":"bearer","apiSetting":"58cd4a8450a0c12500e89bf8"}],"user":{}},"config":{"algoliaIndex":"readme_search_v2","amplitude":{"apiKey":"dc8065a65ef83d6ad23e37aaf014fc84","enabled":true},"asset_url":"https://cdn.readme.io","domain":"readme.io","domainFull":"https://dash.readme.com","encryptedLocalStorageKey":"ekfls-2024-05","fullstory":{"enabled":true,"orgId":"FSV9A"},"metrics":{"billingCronEnabled":"true","dashUrl":"https://m.readme.io","defaultUrl":"https://m.readme.io","exportMaxRetries":12,"wsUrl":"wss://m.readme.io"},"proxyUrl":"https://try.readme.io","readmeRecaptchaSiteKey":"6LesVBYpAAAAAESOCHOyo2kF9SZXPVb54Nwf3i2x","releaseVersion":"5.235.0","sentry":{"dsn":"https://3bbe57a973254129bcb93e47dc0cc46f@o343074.ingest.sentry.io/2052166","enabled":true,"tracesSampleRate":0},"shMigration":{"promoVideo":"","forceWaitlist":false},"sslBaseDomain":"readmessl.com","sslGenerationService":"ssl.readmessl.com","stripePk":"pk_live_5103PML2qXbDukVh7GDAkQoR4NSuLqy8idd5xtdm9407XdPR6o3bo663C1ruEGhXJjpnb2YCpj8EU1UvQYanuCjtr00t1DRCf2a","superHub":{"newProjectsEnabled":true},"wootric":{"accountToken":"NPS-122b75a4","enabled":true}},"context":{"labs":{},"user":{},"terms":[],"variables":{"user":{},"defaults":[{"source":"security","_id":"640201ebb4e93c007aad11f1","name":"bearerAuth","type":"http","scheme":"bearer","apiSetting":"609158e7204c7e001baff965"},{"source":"security","_id":"671a09d65afe4c001f2e5a22","name":"BearerAuth","type":"http","scheme":"bearer","apiSetting":"58cd4a8450a0c12500e89bf8"}]},"project":{"_id":"58bec8f49d43720f0043fdb2","appearance":{"hide_logo":false,"categoriesAsDropdown":false,"header":{"img_size":"auto","img":[],"style":"solid","img_pos":"tl"},"html_footer":"","html_promo":"","theme":"line","main_body":{"type":"links"},"nextStepsLabel":"","showVersion":true,"typography":{"tk_key":"","typekit":false,"body":"Open+Sans:400:sans-serif","headline":"Open+Sans:400:sans-serif","tk_body":"","tk_headline":""},"link_logo_to_url":false,"logo_white":["https://files.readme.io/4e0e706-small-PDark.png","4e0e706-small-PDark.png",656,80,"#ffffff","https://files.readme.io/f785616-PDark.png","65d5019905245d000f7acf9f"],"notheme":false,"promos":[{"extras":{"type":"html","buttonPrimary":"get-started","buttonSecondary":"reference"},"title":"","text":"","_id":"58bec8f49d43720f0043fdb3"}],"stylesheet_hub2":".hub-reference-left > div.magic-block-callout, .hub-reference-left > div.magic-block-textarea {\n margin-top: 30px;\n}\n\n \nbody {\n\tfont-family: \"Inter\",-apple-system,system-ui,BlinkMacSystemFont,\"Segoe UI\",Roboto,\"Helvetica Neue\",Arial,sans-serif !important;\n}\n\na {\n\tcolor: #000; \n font-weight: 600;\n}\n\n/*Top navbar\n#header-top {\n\theight: 80px !important;\n}\n\n#subheader-links a.active {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF;\n color: #0DB5DF !important;\n font-weight: 700;\n}\n\n.theme-line header#hub-header #header-top{\n border-bottom: 1px solid #ffffff;\n}\n\n#hub-subheader-parent #hub-subheader {\n background-color: #f4f7f9;\n \tborder-bottom: 1px solid #ffffff;\n}\n*/\n\nimg.rm-Logo-img { \n\theight: 0;\n width: 0;\n padding: 0 189px 23px 0;\n background-image: url('https://files.readme.io/4e0e706-small-PDark.png');\n background-size: cover;\n}\n\nheader.rm-Header { \n position:sticky; top:0;\n box-shadow: none;\n -webkit-box-shadow: none;\n}\n\n.Header-topuTMpygDG4e1V .rm-SearchToggle-icon,\ndiv.rm-Header-left button.icon-menu,\ndiv.rm-Header-left div { \n color: white !important; \n}\n\ndiv.rm-Header-top {\n border:none;\n background: #000;\n}\n\ndiv.rm-Header-top a.Button { \n color: #fff;\n}\n\ndiv.rm-Header-top a.Button:active,\ndiv.rm-Header-top a.Button:hover { \n color: #fff !important;\n text-decoration: underline;\n}\n\ndiv.rm-Header-bottom { \n\tborder: none;\n\tbackground-color: white;\n}\n\n@media only screen and (max-width: 768px) {\n \na.Button.rm-Header-top-link { \n display:none;\n}\n}\na.Button.rm-Header-bottom-link {\n color: #000 !important;\n font-weight: 400;\n}\n\na.Button.rm-Header-bottom-link.active {\n background: none;\n border-bottom: 2px solid black;\n font-weight: 600;\n}\n\n/*\n\n.rm-Header-bottom-link{\n color: #7d7d8e !important;\n border-radius: 0;\n background: none !important;\n border-color: transparent !important;\n padding-bottom: 20px !important;\n padding-top: 20px !important;\n}\n.rm-Container > nav:nth-child(1){\n padding-bottom: 0px !important;\n padding-top: 0px !important;\n}\n\n.rm-Header-bottom-link:hover {\n\tbox-shadow: inset 0 -2px 0 #384248 !important;\n color: #384248 !important;\n border-radius: 0;\n background: none !important;\n border-color: transparent !important;\n}\n\n.rm-Header-bottom-link.active {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF !important;\n color: #0DB5DF !important;\n font-weight: 700 !important;\n border-radius: 0;\n background: none !important;\n}\n\n.rm-Header-bottom-link.active:hover {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF !important;\n color: #0DB5DF !important;\n font-weight: 700 !important;\n border-radius: 0;\n background: none !important;\n}\n.rm-LandingPage {\n max-width: var(--container-lg) !important;\n width: 100% !important;\n border: none !important\n}\n.rm-Header-bottom-link{\n color: #7d7d8e !important;\n border-radius: 0;\n background: none !important;\n border-color: transparent !important;\n padding-bottom: 20px !important;\n padding-top: 20px !important;\n}\n.rm-Container > nav:nth-child(1){\n padding-bottom: 0px !important;\n padding-top: 0px !important;\n}\n\n.rm-Header-bottom-link:hover {\n\tbox-shadow: inset 0 -2px 0 #384248 !important;\n color: #384248 !important;\n border-radius: 0;\n background: none !important;\n border-color: transparent !important;\n}\n\n.rm-Header-bottom-link.active {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF !important;\n color: #0DB5DF !important;\n font-weight: 700 !important;\n border-radius: 0;\n background: none !important;\n}\n\n.rm-Header-bottom-link.active:hover {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF !important;\n color: #0DB5DF !important;\n font-weight: 700 !important;\n border-radius: 0;\n background: none !important;\n}\n*/\n\n\n\n/*Main section of the landing page*/\n#main-landing-section{\n\tmargin: 15px 0;\n}\n\n#main-landing-section mark { \n border-radius: 23px;\n background: #FFFF00;\n padding: 1px 6px;\n}\n/*\n#hub-landing-top h2 {\n font-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 38px;\n font-weight: 700;\n line-height: 44px;\n color: rgb(45, 55, 71) !important;\n}\n\n.hub-landing-description p{\n\tfont-size: 18px;\n line-height: 26px;\n}\n*/\n\n.btn.btn-primary {\n\tbackground-color: #0db5df !important;\n}\n\n.btn.btn-secondary {\n\tbackground-color: #f4f7f9 !important;\n color: #555 !important;\n}\n/*\n#hub-landing-top .hub-landing-description {\n\tfont-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 16px;\n font-weight: 400;\n line-height: 20px;\n}\n*/\nh2.heading{\n\tfont-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 24px;\n font-weight: 700;\n line-height: 32px;\n color: rgb(45, 55, 71);\n}\n\nh3.heading{\n\tfont-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 18px;\n font-weight: 700;\n line-height: 24px;\n color: rgb(45, 55, 71);\n}\n\n\n/*Cards*/\n* {\n box-sizing: border-box;\n}\n\n/* Float two columns side by side */\n.column {\n float: left;\n width: 50%;\n padding: 0 30px;\n}\n\n.row-card {\n margin: 0 -30px;\n}\n\n/* Responsive columns */\n@media screen and (max-width: 600px) {\n .column {\n width: 100%;\n display: block;\n margin-bottom: 20px;\n }\n}\n\n/* Style the cards */\n.card {\n box-shadow: 0 13px 13px 0 rgba(0, 0, 0, 0.04);\n padding: 35px;\n text-align: left;\n background: rgb(255, 255, 255);\n border-radius: 8px;\n border: 1px solid #dce6ec;\n}\n\n.card h2{\n\tfont-size: 22px;\n margin: 0;\n margin-top: 0 !important;\n}\n\n.card p{\n\tfont-size: 16px;\n line-height: 24px;\n}\n\n.card a{\n\tmargin: 0;\n}\n\n\n\n/*Documentation*/\nnav#hub-sidebar ul a.active, nav#hub-sidebar ul>li.subnav-expanded>a {\n color: #555;\n background-color: #CFF0F9;\n \tfont-weight: 500;\n}\n\n.callout.callout_info{\n\tborder-left: 3px solid rgb(11, 152, 187);\n border-radius: 4px;\n}\n\n\n\n\n/*Change log*/\n.hub-changelog-list .changelog-post h3{\n\tfont-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 18px;\n font-weight: 700;\n line-height: 24px;\n color: rgb(45, 55, 71);\n}\n\n#changelog-type-icon.cl-improved, .icon-changelog-type.cl-improved {\n\tbackground-color: #0db5df; \n}\n\n#readmeLogo {\n display: none;\n}","hideTableOfContents":false,"html_body":"","html_footer_meta":"","javascript":"","logo":["https://files.readme.io/425c15b-small-P_DeveloperHub.png","425c15b-small-P_DeveloperHub.png",656,80,"#000000","https://files.readme.io/16460be-P_DeveloperHub.png","65d4f7e29e4634003dea6747"],"logo_white_use":true,"sticky":false,"body":{"style":"none"},"favicon":["https://files.readme.io/4d285de-Favicon.svg","4d285de-Favicon.svg",496,496,"#555555","65d5f780137db000123097e9"],"html_head":"","html_hidelinks":false,"javascript_hub2":"","overlay":"triangles","stylesheet":"","colors":{"body_highlight":"","header_text":"","highlight":"","main":"#000000","main_alt":"","custom_login_link_color":""},"landing":true,"referenceLayout":"column","subheaderStyle":"links","childrenAsPills":false,"global_landing_page":{"html":"","redirect":""},"rdmd":{"callouts":{"useIconFont":false},"theme":{"background":"","border":"","markdownEdge":"","markdownFont":"","markdownFontSize":"","markdownLineHeight":null,"markdownRadius":"","markdownText":"","markdownTitle":"","markdownTitleFont":"","mdCodeBackground":"","mdCodeFont":"","mdCodeRadius":"","mdCodeTabs":"","mdCodeText":"","tableEdges":"","tableHead":"","tableHeadText":"","tableRow":"","tableStripe":"","tableText":"","text":"","title":""}},"splitReferenceDocs":false,"showMetricsInReference":true,"referenceSimpleMode":true,"stylesheet_hub3":"","loginLogo":[],"logo_large":false,"colorScheme":"light","changelog":{"layoutExpanded":false,"showAuthor":true,"showExactDate":false},"allowApiExplorerJsonEditor":false},"custom_domain":"developer.personio.de","childrenProjects":[],"derivedPlan":"startup","description":"Find documentation for the Personio API as well as comprehensive guides for integrating Personio into your existing landscape of tools and services.","error404":"","experiments":[],"first_page":"landing","flags":{"migrationRun":false,"allowImport":false,"allow_hub2":false,"correctnewlines":false,"swagger":false,"hideGoogleAnalytics":false,"jwt":false,"migrationSwaggerRun":false,"autoSslGeneration":true,"hub2":true,"oauth":false,"allowXFrame":false,"speedyRender":false,"cacheEnabled":true,"newApiExplorer":true,"newSearch":true,"alwaysShowDocPublishStatus":false,"cookieAuthentication":false,"directGoogleToStableVersion":false,"disableAnonForum":false,"enterprise":false,"newEditor":true,"newMarkdownBetaProgram":true,"oldMarkdown":false,"rdmdCompatibilityMode":false,"staging":false,"translation":false,"tutorials":true,"allowApiExplorerJsonEditor":false,"useReactApp":true,"newHeader":false,"referenceRedesign":false,"auth0Oauth":false,"graphql":false,"singleProjectEnterprise":false,"dashReact":false,"allowReferenceUpgrade":true,"metricsV2":true,"newEditorDash":true,"enableRealtimeExperiences":false,"reviewWorkflow":true,"star":false,"allowDarkMode":false,"forceDarkMode":false,"useReactGLP":false,"disablePasswordlessLogin":false,"personalizedDocs":false,"myDevelopers":false,"superHub":false,"developerDashboard":false,"allowReusableOTPs":false,"dashHomeRefresh":false,"owlbotAi":false,"apiV2":false,"git":{"read":false,"write":false},"superHubBeta":false,"dashQuickstart":false,"disableAutoTranslate":false,"customBlocks":false,"devDashHub":false,"disableSAMLScoping":false,"allowUnsafeCustomHtmlSuggestionsFromNonAdmins":false,"apiAccessRevoked":false,"passwordlessLogin":"default","disableSignups":false,"billingRedesignEnabled":true,"developerPortal":false,"mdx":false,"superHubDevelopment":false,"annualBillingEnabled":true,"devDashBillingRedesignEnabled":false,"enableOidc":false,"customComponents":false,"disableDiscussionSpamRecaptchaBypass":false,"developerViewUsersData":false,"changelogRssAlwaysPublic":false,"bidiSync":false,"superHubMigrationSelfServeFlow":false,"maskErrorMessages":true},"fullBaseUrl":"https://developer.personio.de/","git":{"migration":{"createRepository":{},"transformation":{},"migratingPages":{},"enableSuperhub":{}},"sync":{"connectedRepository":{"organization":{},"privacy":{}},"installationRequest":{},"github":[]}},"glossaryTerms":[],"graphqlSchema":"","gracePeriod":{"enabled":false,"endsAt":null},"shouldGateDash":false,"hasOneChild":false,"healthCheck":{"provider":"","settings":{}},"intercom_secure_emailonly":false,"intercom":"","is_active":true,"internal":"","jwtExpirationTime":0,"landing_bottom":[{"type":"html","alignment":"left","html":"<section style=\" max-width: 768px; margin: 0 auto; display: flex; flex-direction: column; align-items: center;\">\n\n <svg xmlns=\"http://www.w3.org/2000/svg\" width=\"644\" height=\"112\" fill=\"none\">\n <path stroke=\"#FF0\" stroke-linecap=\"round\" stroke-width=\"29\"\n d=\"M54 97a4485.44 4485.44 0 0 1 245.56-15.03c29.78-1 58.89-2.04 88.44 1.37\" />\n <path fill=\"#151414\"\n d=\"M577.21 97.52c-2.56 0-4.77-.53-6.6-1.57a10.75 10.75 0 0 1-4.27-4.53 15.25 15.25 0 0 1-1.48-6.94v-.02c0-2.67.5-4.98 1.48-6.94 1-1.96 2.4-3.48 4.2-4.54 1.8-1.08 3.94-1.62 6.39-1.62s4.57.52 6.35 1.57c1.8 1.03 3.18 2.5 4.15 4.38.98 1.9 1.48 4.1 1.48 6.63v2.11h-20.7v-4.3h17.46l-3.26 4.02v-2.62c0-1.47-.22-2.7-.68-3.68a4.94 4.94 0 0 0-1.9-2.25c-.8-.5-1.72-.75-2.78-.75-1.07 0-2.01.26-2.84.77a5.24 5.24 0 0 0-1.92 2.28c-.45.98-.68 2.2-.68 3.63v2.65c0 1.39.23 2.57.68 3.56a5.25 5.25 0 0 0 2 2.27c.85.52 1.87.78 3.06.78.94 0 1.75-.15 2.44-.45.69-.3 1.25-.67 1.69-1.12.43-.46.73-.92.89-1.39l.04-.14h6.29l-.08.26a9.8 9.8 0 0 1-3.33 5.37 10.6 10.6 0 0 1-3.4 1.87c-1.32.47-2.88.7-4.68.7ZM524.34 97V71.87h6.84v4.22h.14a6.96 6.96 0 0 1 2.63-3.44 7.59 7.59 0 0 1 4.4-1.3c1.17 0 2.23.21 3.17.62a6.32 6.32 0 0 1 2.36 1.76c.66.76 1.12 1.7 1.39 2.8h.14a7.37 7.37 0 0 1 1.68-2.73 7.93 7.93 0 0 1 2.7-1.8 9.07 9.07 0 0 1 3.42-.64c1.64 0 3.08.35 4.31 1.05a7.38 7.38 0 0 1 2.89 2.96 9.18 9.18 0 0 1 1.03 4.45V97h-6.85V81.53c0-.97-.16-1.79-.49-2.46a3.29 3.29 0 0 0-1.38-1.52 4.39 4.39 0 0 0-2.23-.52c-.86 0-1.61.2-2.27.59a4.01 4.01 0 0 0-1.5 1.64c-.36.7-.54 1.52-.54 2.46V97h-6.59V81.32c0-.9-.16-1.68-.49-2.32a3.33 3.33 0 0 0-1.4-1.45 4.23 4.23 0 0 0-2.16-.52c-.86 0-1.62.2-2.27.61a4.25 4.25 0 0 0-1.55 1.69 5.53 5.53 0 0 0-.54 2.5V97h-6.84Zm-11.44 0V71.87h6.84V97h-6.84Zm3.42-28.36c-1.03 0-1.9-.35-2.6-1.05a3.43 3.43 0 0 1-1.06-2.51c0-.99.36-1.82 1.06-2.51.7-.7 1.57-1.05 2.6-1.05s1.9.35 2.6 1.05a3.38 3.38 0 0 1 1.06 2.5c0 .98-.36 1.81-1.06 2.52-.7.7-1.57 1.05-2.6 1.05Zm-10.64 28.88c-2.78 0-4.84-.59-6.19-1.76-1.34-1.17-2.01-3.1-2.01-5.8V77.04h-3.5v-5.15h3.5v-6.14h6.91v6.14h4.6v5.15h-4.6v12.19c0 1.17.26 2 .77 2.46.54.45 1.32.68 2.35.68.31 0 .58 0 .82-.02l.65-.1v5.02c-.37.06-.84.12-1.4.16-.55.07-1.18.1-1.9.1Zm-38.32-.12a9.64 9.64 0 0 1-4.4-.96 7.54 7.54 0 0 1-2.98-2.7 7.42 7.42 0 0 1-1.06-3.93v-.05c0-1.53.38-2.84 1.15-3.92a7.6 7.6 0 0 1 3.33-2.57c1.45-.63 3.22-1.01 5.3-1.15l9.8-.61v4.26l-8.77.57a5.25 5.25 0 0 0-3 .93 2.56 2.56 0 0 0-1.03 2.14v.04c0 .93.35 1.65 1.05 2.18.7.52 1.65.78 2.84.78a6.1 6.1 0 0 0 2.72-.59c.8-.4 1.44-.95 1.9-1.64a4.17 4.17 0 0 0 .7-2.37V80.2c0-1.11-.35-1.99-1.06-2.63-.7-.66-1.72-.98-3.07-.98-1.28 0-2.3.26-3.05.8s-1.2 1.2-1.38 2l-.04.22h-6.26l.02-.28a7.85 7.85 0 0 1 1.52-4.13 8.89 8.89 0 0 1 3.75-2.8c1.61-.7 3.52-1.04 5.72-1.04 2.17 0 4.06.35 5.65 1.05a8.42 8.42 0 0 1 3.7 2.93 7.5 7.5 0 0 1 1.34 4.43V97h-6.84v-3.75h-.14a7.63 7.63 0 0 1-1.83 2.23 8.46 8.46 0 0 1-2.51 1.43c-.94.32-1.96.49-3.07.49Zm-24.07.12c-2.78 0-4.85-.59-6.19-1.76-1.34-1.17-2.01-3.1-2.01-5.8V77.04h-3.5v-5.15h3.5v-6.14H442v6.14h4.6v5.15H442v12.19c0 1.17.26 2 .77 2.46.54.45 1.32.68 2.35.68.31 0 .58 0 .82-.02l.65-.1v5.02c-.37.06-.84.12-1.4.16-.55.07-1.18.1-1.9.1Zm-28.8-.12a9.64 9.64 0 0 1-4.41-.96 7.53 7.53 0 0 1-2.98-2.7 7.42 7.42 0 0 1-1.05-3.93v-.05c0-1.53.38-2.84 1.14-3.92a7.6 7.6 0 0 1 3.33-2.57c1.46-.63 3.22-1.01 5.3-1.15l9.8-.61v4.26l-8.77.57a5.25 5.25 0 0 0-3 .93 2.56 2.56 0 0 0-1.03 2.14v.04c0 .93.35 1.65 1.06 2.18.7.52 1.64.78 2.83.78a6.1 6.1 0 0 0 2.72-.59c.81-.4 1.45-.95 1.9-1.64a4.17 4.17 0 0 0 .7-2.37V80.2c0-1.11-.35-1.99-1.05-2.63-.7-.66-1.73-.98-3.07-.98-1.28 0-2.3.26-3.05.8s-1.21 1.2-1.38 2l-.05.22h-6.26l.03-.28a7.85 7.85 0 0 1 1.52-4.13 8.89 8.89 0 0 1 3.75-2.8c1.6-.7 3.51-1.04 5.72-1.04 2.17 0 4.05.35 5.65 1.05a8.42 8.42 0 0 1 3.7 2.93 7.5 7.5 0 0 1 1.34 4.43V97h-6.85v-3.75h-.14a7.63 7.63 0 0 1-1.83 2.23 8.44 8.44 0 0 1-2.5 1.43c-.94.32-1.97.49-3.08.49Zm-32.23.12c-2.57 0-4.77-.53-6.61-1.57a10.76 10.76 0 0 1-4.27-4.53 15.24 15.24 0 0 1-1.47-6.94v-.02c0-2.67.49-4.98 1.47-6.94 1-1.96 2.4-3.48 4.2-4.54a12.28 12.28 0 0 1 6.4-1.62c2.45 0 4.57.52 6.35 1.57 1.8 1.03 3.18 2.5 4.15 4.38.98 1.9 1.47 4.1 1.47 6.63v2.11h-20.7v-4.3h17.47l-3.26 4.02v-2.62a8.8 8.8 0 0 0-.68-3.68 4.94 4.94 0 0 0-1.9-2.25c-.8-.5-1.72-.75-2.79-.75-1.06 0-2 .26-2.83.77a5.24 5.24 0 0 0-1.92 2.28c-.46.98-.68 2.2-.68 3.63v2.65c0 1.39.22 2.57.68 3.56a5.25 5.25 0 0 0 1.99 2.27c.86.52 1.88.78 3.07.78.94 0 1.75-.15 2.44-.45.68-.3 1.25-.67 1.68-1.12.44-.46.74-.92.9-1.39l.04-.14h6.28l-.07.26a9.82 9.82 0 0 1-3.33 5.37 10.6 10.6 0 0 1-3.4 1.87c-1.32.47-2.88.7-4.68.7Zm-30.73 0c-2.1 0-3.93-.53-5.46-1.57a10.03 10.03 0 0 1-3.54-4.5 18.22 18.22 0 0 1-1.22-7.01v-.03c0-2.73.42-5.07 1.25-7 .82-1.96 2-3.45 3.51-4.48a9.44 9.44 0 0 1 5.46-1.57c1.19 0 2.28.2 3.28.59 1 .39 1.88.95 2.63 1.68a8 8 0 0 1 1.83 2.6h.14V63.18h6.84V97h-6.84v-4.29h-.14a7.94 7.94 0 0 1-1.79 2.58 8.1 8.1 0 0 1-2.62 1.64c-1 .39-2.11.59-3.33.59Zm2.3-5.68c1.1 0 2.08-.3 2.93-.89a5.94 5.94 0 0 0 1.97-2.57c.47-1.11.7-2.43.7-3.94v-.03a9.6 9.6 0 0 0-.73-3.91 5.78 5.78 0 0 0-1.97-2.55 4.76 4.76 0 0 0-2.9-.92c-1.14 0-2.13.3-2.95.9a5.7 5.7 0 0 0-1.93 2.55c-.45 1.09-.68 2.4-.68 3.93v.03c0 1.51.22 2.83.66 3.94a5.84 5.84 0 0 0 1.92 2.57c.85.6 1.84.9 2.98.9Zm-27.59 5.68c-2.54 0-4.75-.53-6.6-1.57a10.72 10.72 0 0 1-4.32-4.5 15.03 15.03 0 0 1-1.52-7.01v-.05c0-2.7.51-5.02 1.54-6.96a10.85 10.85 0 0 1 4.34-4.5 13.1 13.1 0 0 1 6.54-1.57c2.51 0 4.7.52 6.56 1.57a10.66 10.66 0 0 1 4.36 4.48 14.69 14.69 0 0 1 1.55 6.98v.05c0 2.73-.52 5.08-1.55 7.03a10.7 10.7 0 0 1-4.31 4.5 13.37 13.37 0 0 1-6.59 1.55Zm.03-5.37c1.1 0 2.07-.3 2.88-.9a5.68 5.68 0 0 0 1.9-2.62c.45-1.15.68-2.55.68-4.2v-.04c0-1.62-.23-3-.68-4.15-.46-1.14-1.1-2-1.92-2.6a4.77 4.77 0 0 0-2.91-.91c-1.1 0-2.06.3-2.88.91a5.73 5.73 0 0 0-1.9 2.6 11.23 11.23 0 0 0-.68 4.15v.05c0 1.64.22 3.04.65 4.2a5.83 5.83 0 0 0 1.93 2.62c.82.6 1.8.89 2.93.89Zm-26.23 5.37a13.1 13.1 0 0 1-6.61-1.6 10.7 10.7 0 0 1-4.29-4.52c-1-1.97-1.5-4.3-1.5-6.99v-.02c0-2.69.5-5 1.5-6.94a10.74 10.74 0 0 1 4.29-4.5 12.96 12.96 0 0 1 6.54-1.6c2.28 0 4.26.44 5.93 1.3a9.78 9.78 0 0 1 5.48 8.34v.17h-6.35l-.05-.21c-.2-1.2-.71-2.2-1.54-3a4.61 4.61 0 0 0-3.38-1.22c-1.1 0-2.08.3-2.9.93a5.9 5.9 0 0 0-1.9 2.65c-.44 1.14-.66 2.51-.66 4.1v.03c0 1.64.22 3.04.66 4.2a5.91 5.91 0 0 0 1.9 2.62c.82.6 1.8.89 2.93.89 1.37 0 2.47-.38 3.3-1.15a5.4 5.4 0 0 0 1.62-3.07l.02-.21h6.38v.14a9.87 9.87 0 0 1-5.53 8.39 12.7 12.7 0 0 1-5.84 1.27ZM263.76 97V77.03h-3.42v-5.15h3.42v-2.02c0-1.64.27-3 .82-4.06a5.2 5.2 0 0 1 2.65-2.36 12.5 12.5 0 0 1 4.8-.78c.63 0 1.26.03 1.9.1.64.04 1.16.1 1.55.18v4.53a5.68 5.68 0 0 0-.82-.1 18.78 18.78 0 0 0-.94-.02c-1.13 0-1.95.24-2.49.7-.53.47-.8 1.16-.8 2.07v1.75h5v5.16h-4.83V97h-6.84Zm-17.81.52c-2.55 0-4.75-.53-6.61-1.57a10.72 10.72 0 0 1-4.32-4.5 15.03 15.03 0 0 1-1.52-7.01v-.05c0-2.7.52-5.02 1.55-6.96a10.85 10.85 0 0 1 4.33-4.5 13.1 13.1 0 0 1 6.54-1.57c2.52 0 4.7.52 6.56 1.57a10.66 10.66 0 0 1 4.36 4.48 14.69 14.69 0 0 1 1.55 6.98v.05c0 2.73-.51 5.08-1.55 7.03a10.7 10.7 0 0 1-4.3 4.5 13.37 13.37 0 0 1-6.6 1.55Zm.02-5.37c1.1 0 2.07-.3 2.88-.9a5.69 5.69 0 0 0 1.9-2.62c.45-1.15.68-2.55.68-4.2v-.04c0-1.62-.23-3-.68-4.15-.45-1.14-1.1-2-1.92-2.6a4.77 4.77 0 0 0-2.9-.91c-1.1 0-2.06.3-2.9.91a5.74 5.74 0 0 0-1.89 2.6 11.25 11.25 0 0 0-.68 4.15v.05c0 1.64.22 3.04.66 4.2a5.83 5.83 0 0 0 1.92 2.62c.83.6 1.8.89 2.93.89Zm-36.3 5.37c-2.57 0-4.77-.53-6.62-1.57a10.75 10.75 0 0 1-4.26-4.53 15.25 15.25 0 0 1-1.48-6.94v-.02c0-2.67.5-4.98 1.48-6.94 1-1.96 2.4-3.48 4.2-4.54 1.8-1.08 3.94-1.62 6.4-1.62s4.56.52 6.34 1.57c1.8 1.03 3.18 2.5 4.15 4.38.99 1.9 1.48 4.1 1.48 6.63v2.11h-20.7v-4.3h17.46l-3.25 4.02v-2.62a8.8 8.8 0 0 0-.68-3.68 4.95 4.95 0 0 0-1.9-2.25c-.8-.5-1.73-.75-2.79-.75s-2 .26-2.84.77a5.25 5.25 0 0 0-1.92 2.28c-.45.98-.68 2.2-.68 3.63v2.65c0 1.39.23 2.57.68 3.56a5.25 5.25 0 0 0 2 2.27c.85.52 1.88.78 3.06.78.94 0 1.75-.15 2.44-.45.69-.3 1.25-.67 1.69-1.12.44-.46.73-.92.89-1.39l.05-.14h6.28l-.07.26a9.19 9.19 0 0 1-1.1 2.79 9.8 9.8 0 0 1-2.23 2.58 10.6 10.6 0 0 1-3.4 1.87c-1.33.47-2.89.7-4.69.7Zm-39.1-.52V71.87h6.84V76h.14a7.8 7.8 0 0 1 2.91-3.4 8.58 8.58 0 0 1 4.76-1.24c2.76 0 4.9.84 6.4 2.5 1.51 1.66 2.27 3.97 2.27 6.92V97h-6.84V82.19c0-1.64-.4-2.9-1.18-3.8-.76-.9-1.9-1.36-3.44-1.36a4.9 4.9 0 0 0-2.65.7 4.67 4.67 0 0 0-1.76 1.93c-.4.82-.6 1.8-.6 2.9V97h-6.85Zm-11.44 0V71.87h6.85V97h-6.85Zm3.43-28.36c-1.04 0-1.9-.35-2.6-1.05a3.43 3.43 0 0 1-1.06-2.51c0-.99.35-1.82 1.05-2.51.7-.7 1.57-1.05 2.6-1.05 1.04 0 1.9.35 2.6 1.05a3.38 3.38 0 0 1 1.06 2.5c0 .98-.35 1.81-1.05 2.52-.7.7-1.57 1.05-2.6 1.05ZM147.53 97V63.18h6.85V97h-6.85Zm-24.91.52c-2.56 0-4.77-.53-6.61-1.57a10.75 10.75 0 0 1-4.27-4.53 15.25 15.25 0 0 1-1.47-6.94v-.02c0-2.67.49-4.98 1.47-6.94 1-1.96 2.4-3.48 4.2-4.54 1.81-1.08 3.94-1.62 6.4-1.62s4.57.52 6.35 1.57c1.8 1.03 3.18 2.5 4.15 4.38.98 1.9 1.47 4.1 1.47 6.63v2.11h-20.7v-4.3h17.47l-3.26 4.02v-2.62a8.8 8.8 0 0 0-.68-3.68 4.94 4.94 0 0 0-1.9-2.25c-.8-.5-1.72-.75-2.79-.75-1.06 0-2 .26-2.83.77a5.25 5.25 0 0 0-1.93 2.28c-.45.98-.67 2.2-.67 3.63v2.65c0 1.39.22 2.57.67 3.56a5.25 5.25 0 0 0 2 2.27c.86.52 1.88.78 3.07.78.93 0 1.75-.15 2.43-.45.7-.3 1.25-.67 1.7-1.12.43-.46.73-.92.88-1.39l.05-.14h6.28l-.07.26a9.16 9.16 0 0 1-1.1 2.79 9.8 9.8 0 0 1-2.23 2.58 10.6 10.6 0 0 1-3.4 1.87c-1.32.47-2.89.7-4.68.7ZM83.52 97V71.87h6.85V76h.14a7.82 7.82 0 0 1 2.9-3.4 8.58 8.58 0 0 1 4.76-1.24c2.77 0 4.9.84 6.4 2.5 1.52 1.66 2.27 3.97 2.27 6.92V97H100V82.19c0-1.64-.39-2.9-1.17-3.8-.77-.9-1.92-1.36-3.45-1.36a4.9 4.9 0 0 0-2.65.7 4.66 4.66 0 0 0-1.75 1.93c-.41.82-.61 1.8-.61 2.9V97h-6.85Zm-15.98.52c-2.55 0-4.75-.53-6.61-1.57a10.72 10.72 0 0 1-4.31-4.5 15.03 15.03 0 0 1-1.53-7.01v-.05c0-2.7.52-5.02 1.55-6.96a10.84 10.84 0 0 1 4.34-4.5 13.1 13.1 0 0 1 6.54-1.57c2.51 0 4.7.52 6.56 1.57a10.66 10.66 0 0 1 4.36 4.48 14.7 14.7 0 0 1 1.54 6.98v.05c0 2.73-.51 5.08-1.54 7.03a10.71 10.71 0 0 1-4.32 4.5 13.37 13.37 0 0 1-6.58 1.55Zm.02-5.37c1.11 0 2.07-.3 2.89-.9a5.69 5.69 0 0 0 1.9-2.62c.45-1.15.67-2.55.67-4.2v-.04c0-1.62-.22-3-.68-4.15-.45-1.14-1.09-2-1.92-2.6a4.77 4.77 0 0 0-2.9-.91c-1.1 0-2.06.3-2.89.91a5.74 5.74 0 0 0-1.9 2.6 11.25 11.25 0 0 0-.68 4.15v.05c0 1.64.22 3.04.66 4.2a5.83 5.83 0 0 0 1.92 2.62c.83.6 1.8.89 2.93.89Zm531.07-41.1 1.71-12.96h6.47l-3.44 12.96h-4.74Zm-13.05-6.53c-2.31 0-4.28-.34-5.9-1.01a9.1 9.1 0 0 1-3.83-2.8 8.44 8.44 0 0 1-1.64-4.16l-.02-.21h6.68l.04.2a3.7 3.7 0 0 0 1.48 2.3 5.4 5.4 0 0 0 3.19.82c.87 0 1.61-.1 2.22-.3.61-.22 1.08-.52 1.41-.91.34-.4.52-.87.52-1.41v-.02a2 2 0 0 0-.73-1.62 6.38 6.38 0 0 0-2.58-1.03l-4.26-.9a13.65 13.65 0 0 1-4.08-1.47 6.8 6.8 0 0 1-2.44-2.41 6.65 6.65 0 0 1-.82-3.33v-.03c0-1.6.43-3 1.29-4.17a8.24 8.24 0 0 1 3.66-2.72c1.59-.65 3.45-.98 5.57-.98 2.22 0 4.1.36 5.65 1.08a8.41 8.41 0 0 1 3.59 2.86 7.24 7.24 0 0 1 1.33 4v.24h-6.3l-.02-.19a3.3 3.3 0 0 0-1.27-2.25 4.46 4.46 0 0 0-2.98-.91c-.78 0-1.46.1-2.03.33-.58.21-1.03.53-1.34.93-.31.4-.47.86-.47 1.4v.03c0 .42.1.8.3 1.15.22.33.58.62 1.08.87.5.25 1.17.47 2.02.65l4.26.92c2.64.55 4.53 1.37 5.68 2.46a5.78 5.78 0 0 1 1.73 4.4v.03c0 1.64-.47 3.07-1.4 4.29a9.25 9.25 0 0 1-3.9 2.86c-1.64.67-3.54 1-5.7 1Zm-38-.52V18.87h6.85V23h.14a7.81 7.81 0 0 1 2.9-3.4 8.58 8.58 0 0 1 4.76-1.24c2.77 0 4.9.84 6.4 2.5 1.52 1.66 2.28 3.97 2.28 6.92V44h-6.85V29.19c0-1.64-.39-2.9-1.17-3.8-.77-.9-1.91-1.36-3.45-1.36a4.9 4.9 0 0 0-2.64.7 4.66 4.66 0 0 0-1.76 1.93c-.4.82-.61 1.8-.61 2.9V44h-6.84Zm-15.98.52c-2.55 0-4.75-.53-6.6-1.57a10.72 10.72 0 0 1-4.32-4.5 15.01 15.01 0 0 1-1.52-7.01v-.05c0-2.7.51-5.02 1.54-6.96a10.86 10.86 0 0 1 4.34-4.5 13.1 13.1 0 0 1 6.54-1.57c2.51 0 4.7.52 6.56 1.57a10.65 10.65 0 0 1 4.36 4.48 14.69 14.69 0 0 1 1.55 6.98v.05c0 2.73-.52 5.08-1.55 7.03a10.7 10.7 0 0 1-4.31 4.5 13.36 13.36 0 0 1-6.59 1.55Zm.02-5.37c1.11 0 2.07-.3 2.89-.9a5.68 5.68 0 0 0 1.9-2.62c.45-1.15.68-2.55.68-4.2v-.04c0-1.62-.23-3-.68-4.15-.46-1.14-1.1-2-1.93-2.6a4.76 4.76 0 0 0-2.9-.91c-1.1 0-2.06.3-2.88.91a5.74 5.74 0 0 0-1.9 2.6 11.25 11.25 0 0 0-.68 4.15v.05c0 1.64.22 3.04.65 4.2a5.84 5.84 0 0 0 1.93 2.62c.82.6 1.8.89 2.93.89ZM508.63 44V18.87h6.85V44h-6.85Zm3.42-28.36c-1.03 0-1.9-.35-2.6-1.05a3.43 3.43 0 0 1-1.05-2.51c0-.99.35-1.82 1.05-2.51.7-.7 1.57-1.05 2.6-1.05 1.04 0 1.9.35 2.6 1.05a3.38 3.38 0 0 1 1.06 2.5c0 .98-.35 1.81-1.05 2.52-.7.7-1.57 1.05-2.6 1.05Zm-10.64 28.88c-2.78 0-4.84-.59-6.18-1.76-1.35-1.17-2.02-3.1-2.02-5.8V24.04h-3.5v-5.15h3.5v-6.14h6.91v6.14h4.6v5.15h-4.6v12.19c0 1.17.26 2 .78 2.46.53.45 1.31.68 2.34.68.31 0 .59 0 .82-.02l.66-.1v5.02a17.78 17.78 0 0 1-1.4.16c-.55.06-1.19.1-1.9.1Zm-28.8-.12a9.64 9.64 0 0 1-4.4-.96 7.54 7.54 0 0 1-2.98-2.7 7.42 7.42 0 0 1-1.06-3.93v-.05c0-1.53.38-2.84 1.15-3.92a7.6 7.6 0 0 1 3.33-2.57c1.45-.63 3.22-1.01 5.3-1.15l9.8-.61v4.26l-8.77.57a5.25 5.25 0 0 0-3 .93 2.56 2.56 0 0 0-1.03 2.14v.04c0 .93.35 1.65 1.05 2.18.7.52 1.65.78 2.84.78a6.1 6.1 0 0 0 2.72-.59c.8-.4 1.44-.95 1.9-1.64a4.17 4.17 0 0 0 .7-2.37V27.2c0-1.11-.35-1.99-1.06-2.63-.7-.66-1.72-.98-3.07-.98-1.28 0-2.3.26-3.05.8s-1.2 1.2-1.38 2l-.04.22h-6.26l.02-.28a7.85 7.85 0 0 1 1.52-4.13 8.89 8.89 0 0 1 3.75-2.8c1.61-.7 3.52-1.04 5.72-1.04 2.17 0 4.06.35 5.65 1.05a8.42 8.42 0 0 1 3.7 2.93 7.5 7.5 0 0 1 1.34 4.43V44h-6.84v-3.75h-.14a7.63 7.63 0 0 1-1.83 2.23 8.46 8.46 0 0 1-2.51 1.43c-.94.32-1.96.49-3.07.49Zm-21.84.12c-2.32 0-4.29-.34-5.91-1.01a9.11 9.11 0 0 1-3.82-2.8 8.46 8.46 0 0 1-1.64-4.16l-.02-.21h6.68l.04.2a3.7 3.7 0 0 0 1.48 2.3 5.4 5.4 0 0 0 3.19.82c.87 0 1.61-.1 2.22-.3a3.18 3.18 0 0 0 1.4-.91c.35-.4.52-.87.52-1.41v-.02a2 2 0 0 0-.72-1.62 6.38 6.38 0 0 0-2.58-1.03l-4.27-.9a13.64 13.64 0 0 1-4.07-1.47 6.8 6.8 0 0 1-2.44-2.41 6.65 6.65 0 0 1-.82-3.33v-.03c0-1.6.43-3 1.29-4.17a8.24 8.24 0 0 1 3.65-2.72c1.6-.65 3.46-.98 5.58-.98 2.22 0 4.1.36 5.65 1.08a8.42 8.42 0 0 1 3.59 2.86 7.25 7.25 0 0 1 1.33 4v.24h-6.3l-.03-.19a3.3 3.3 0 0 0-1.26-2.25 4.46 4.46 0 0 0-2.98-.91c-.78 0-1.46.1-2.04.33-.58.21-1.02.53-1.33.93-.32.4-.47.86-.47 1.4v.03c0 .42.1.8.3 1.15.22.33.58.62 1.08.87.5.25 1.17.47 2.02.65l4.26.92c2.64.55 4.53 1.37 5.67 2.46a5.78 5.78 0 0 1 1.74 4.4v.03c0 1.64-.47 3.07-1.4 4.29a9.26 9.26 0 0 1-3.9 2.86c-1.64.67-3.54 1-5.7 1ZM428.99 44V18.87h6.85V44h-6.85Zm3.42-28.36c-1.03 0-1.9-.35-2.6-1.05a3.43 3.43 0 0 1-1.05-2.51c0-.99.35-1.82 1.05-2.51.7-.7 1.57-1.05 2.6-1.05s1.9.35 2.6 1.05a3.38 3.38 0 0 1 1.06 2.5c0 .98-.35 1.81-1.05 2.52-.7.7-1.57 1.05-2.6 1.05ZM401.2 44V18.87h6.85V23h.14a7.8 7.8 0 0 1 2.9-3.4 8.58 8.58 0 0 1 4.76-1.24c2.77 0 4.9.84 6.4 2.5 1.52 1.66 2.28 3.97 2.28 6.92V44h-6.85V29.19c0-1.64-.39-2.9-1.17-3.8-.77-.9-1.91-1.36-3.44-1.36a4.9 4.9 0 0 0-2.65.7 4.66 4.66 0 0 0-1.76 1.93c-.4.82-.61 1.8-.61 2.9V44h-6.84Zm-18.81.4a9.64 9.64 0 0 1-4.41-.96 7.54 7.54 0 0 1-2.98-2.7 7.43 7.43 0 0 1-1.05-3.93v-.05c0-1.53.38-2.84 1.15-3.92a7.6 7.6 0 0 1 3.32-2.57c1.46-.63 3.22-1.01 5.3-1.15l9.8-.61v4.26l-8.77.57a5.26 5.26 0 0 0-3 .93 2.56 2.56 0 0 0-1.03 2.14v.04c0 .93.35 1.65 1.06 2.18.7.52 1.64.78 2.83.78a6.1 6.1 0 0 0 2.72-.59c.81-.4 1.45-.95 1.9-1.64a4.17 4.17 0 0 0 .7-2.37V27.2c0-1.11-.35-1.99-1.05-2.63-.7-.66-1.73-.98-3.07-.98-1.28 0-2.3.26-3.05.8s-1.21 1.2-1.38 2l-.05.22h-6.26l.03-.28a7.86 7.86 0 0 1 1.52-4.13 8.9 8.9 0 0 1 3.75-2.8 14.49 14.49 0 0 1 5.72-1.04c2.17 0 4.05.35 5.65 1.05a8.43 8.43 0 0 1 3.7 2.93 7.5 7.5 0 0 1 1.34 4.43V44h-6.85v-3.75h-.14a7.63 7.63 0 0 1-1.83 2.23 8.43 8.43 0 0 1-2.5 1.43c-.94.32-1.97.49-3.07.49Zm-24.24 8.32c-2.3 0-4.3-.32-6.02-.96a10.42 10.42 0 0 1-4.08-2.56 6.9 6.9 0 0 1-1.83-3.63l-.02-.21h6.65l.07.16c.29.61.87 1.15 1.76 1.62.9.47 2.05.7 3.47.7 1.77 0 3.11-.42 4.03-1.26a4.35 4.35 0 0 0 1.39-3.38v-3.84h-.15a7.18 7.18 0 0 1-1.78 2.27 8.31 8.31 0 0 1-2.65 1.5c-1 .35-2.1.52-3.32.52-2.1 0-3.91-.5-5.44-1.5a9.72 9.72 0 0 1-3.52-4.29 16.8 16.8 0 0 1-1.22-6.7v-.03c0-2.67.42-4.96 1.25-6.86a9.9 9.9 0 0 1 3.56-4.39 9.69 9.69 0 0 1 5.48-1.52c1.2 0 2.28.2 3.26.59a7.7 7.7 0 0 1 2.58 1.66 8.31 8.31 0 0 1 1.8 2.56h.14v-4.3h6.85V43.3c0 1.86-.5 3.49-1.5 4.9a9.65 9.65 0 0 1-4.24 3.32c-1.83.8-4 1.2-6.52 1.2Zm-.12-14.09c1.13 0 2.1-.3 2.93-.89a5.71 5.71 0 0 0 1.93-2.53c.46-1.1.7-2.39.7-3.89v-.02c0-1.5-.24-2.8-.7-3.87a5.49 5.49 0 0 0-1.95-2.5c-.83-.6-1.8-.9-2.9-.9a5 5 0 0 0-2.96.9 5.5 5.5 0 0 0-1.94 2.48 10.02 10.02 0 0 0-.68 3.89v.02c0 1.5.22 2.8.68 3.89a5.64 5.64 0 0 0 1.94 2.53 5 5 0 0 0 2.95.9ZM329.72 44V18.87h6.83v4.39h.14a6.74 6.74 0 0 1 2.04-3.61 5.4 5.4 0 0 1 3.68-1.3 8.12 8.12 0 0 1 1.97.27v6.02a4.97 4.97 0 0 0-1.08-.26 8.02 8.02 0 0 0-1.4-.11 5.9 5.9 0 0 0-2.88.65 4.35 4.35 0 0 0-1.83 1.92 6.86 6.86 0 0 0-.63 3.1V44h-6.85Zm-16 .52c-2.54 0-4.74-.53-6.6-1.57a10.72 10.72 0 0 1-4.32-4.5 15.01 15.01 0 0 1-1.52-7.01v-.05c0-2.7.52-5.02 1.55-6.96a10.86 10.86 0 0 1 4.33-4.5 13.1 13.1 0 0 1 6.54-1.57c2.52 0 4.7.52 6.57 1.57a10.65 10.65 0 0 1 4.35 4.48 14.69 14.69 0 0 1 1.55 6.98v.05c0 2.73-.51 5.08-1.55 7.03a10.7 10.7 0 0 1-4.3 4.5 13.36 13.36 0 0 1-6.6 1.55Zm.03-5.37c1.1 0 2.07-.3 2.88-.9a5.68 5.68 0 0 0 1.9-2.62c.45-1.15.68-2.55.68-4.2v-.04c0-1.62-.23-3-.68-4.15-.45-1.14-1.1-2-1.92-2.6a4.77 4.77 0 0 0-2.9-.91c-1.1 0-2.06.3-2.89.91a5.74 5.74 0 0 0-1.9 2.6 11.25 11.25 0 0 0-.68 4.15v.05c0 1.64.22 3.04.66 4.2a5.84 5.84 0 0 0 1.92 2.62c.83.6 1.8.89 2.93.89ZM275.19 44V18.87h6.85v4.39h.14a6.74 6.74 0 0 1 2.04-3.61 5.4 5.4 0 0 1 3.68-1.3 8.14 8.14 0 0 1 1.97.27v6.02a4.96 4.96 0 0 0-1.08-.26 8 8 0 0 0-1.4-.11 5.9 5.9 0 0 0-2.89.65c-.8.44-1.4 1.08-1.83 1.92a6.86 6.86 0 0 0-.63 3.1V44h-6.84Zm-15.23.52c-2.56 0-4.76-.53-6.6-1.57a10.75 10.75 0 0 1-4.27-4.53 15.25 15.25 0 0 1-1.48-6.94v-.02c0-2.67.5-4.98 1.48-6.94 1-1.96 2.4-3.48 4.2-4.54 1.8-1.08 3.94-1.62 6.39-1.62s4.57.52 6.35 1.57c1.8 1.03 3.18 2.5 4.15 4.38.98 1.9 1.48 4.1 1.48 6.64v2.1h-20.7v-4.3h17.46l-3.26 4.02v-2.62c0-1.47-.22-2.7-.68-3.68a4.94 4.94 0 0 0-1.9-2.25c-.8-.5-1.72-.75-2.78-.75-1.07 0-2.01.26-2.84.77a5.24 5.24 0 0 0-1.92 2.28c-.45.98-.68 2.2-.68 3.63v2.65c0 1.39.23 2.58.68 3.56a5.25 5.25 0 0 0 2 2.27c.85.52 1.87.78 3.06.78.94 0 1.75-.15 2.44-.45.69-.3 1.25-.67 1.69-1.12.43-.46.73-.92.89-1.39l.04-.14h6.29l-.07.26a9.8 9.8 0 0 1-3.33 5.37 10.6 10.6 0 0 1-3.4 1.87c-1.33.47-2.9.7-4.69.7Zm-18.19 0c-2.78 0-4.84-.59-6.18-1.76-1.35-1.17-2.02-3.1-2.02-5.8V24.04h-3.5v-5.15h3.5v-6.14h6.91v6.14h4.6v5.15h-4.6v12.19c0 1.17.26 2 .78 2.46.53.45 1.31.68 2.34.68.31 0 .59 0 .82-.02l.66-.1v5.02c-.38.06-.85.12-1.4.16-.56.06-1.19.1-1.9.1Zm-17.06 0c-2.78 0-4.84-.59-6.19-1.76-1.34-1.17-2.01-3.1-2.01-5.8V24.04H213v-5.15h3.5v-6.14h6.91v6.14h4.6v5.15h-4.6v12.19c0 1.17.26 2 .78 2.46.53.45 1.3.68 2.34.68.31 0 .59 0 .82-.02l.66-.1v5.02a17.78 17.78 0 0 1-1.41.16c-.55.06-1.18.1-1.9.1Zm-25.22 0c-2.56 0-4.76-.53-6.6-1.57a10.75 10.75 0 0 1-4.27-4.53 15.25 15.25 0 0 1-1.48-6.94v-.02c0-2.67.5-4.98 1.48-6.94 1-1.96 2.4-3.48 4.2-4.54 1.8-1.08 3.94-1.62 6.4-1.62s4.56.52 6.34 1.57c1.8 1.03 3.18 2.5 4.15 4.38.98 1.9 1.48 4.1 1.48 6.64v2.1h-20.7v-4.3h17.46l-3.26 4.02v-2.62a8.8 8.8 0 0 0-.67-3.68 4.95 4.95 0 0 0-1.9-2.25c-.8-.5-1.73-.75-2.8-.75-1.05 0-2 .26-2.83.77a5.25 5.25 0 0 0-1.92 2.28c-.45.98-.68 2.2-.68 3.63v2.65c0 1.39.23 2.58.68 3.56a5.25 5.25 0 0 0 2 2.27c.85.52 1.87.78 3.06.78.94 0 1.75-.15 2.44-.45.69-.3 1.25-.67 1.69-1.12.43-.46.73-.92.89-1.39l.04-.14h6.29l-.07.26a9.16 9.16 0 0 1-1.1 2.79 9.8 9.8 0 0 1-2.23 2.58 10.6 10.6 0 0 1-3.4 1.87c-1.33.47-2.9.7-4.69.7Zm-25.2 0c-1.2 0-2.3-.2-3.3-.59-1-.39-1.87-.94-2.62-1.64a8.25 8.25 0 0 1-1.8-2.58h-.15V44h-6.84V10.18h6.84v13.05h.14a8.49 8.49 0 0 1 1.83-2.6 7.73 7.73 0 0 1 2.63-1.68 9.14 9.14 0 0 1 3.3-.6c2.11 0 3.92.53 5.44 1.58a9.87 9.87 0 0 1 3.54 4.48 17.8 17.8 0 0 1 1.24 7v.03c0 2.72-.42 5.05-1.24 7-.83 1.96-2.01 3.46-3.54 4.5a9.44 9.44 0 0 1-5.46 1.58Zm-2.27-5.68c1.14 0 2.13-.3 2.96-.89a5.86 5.86 0 0 0 1.92-2.58c.45-1.1.68-2.42.68-3.93v-.03c0-1.53-.23-2.84-.68-3.93a5.62 5.62 0 0 0-1.95-2.56 4.9 4.9 0 0 0-2.93-.89c-1.1 0-2.08.3-2.93.91a6 6 0 0 0-1.97 2.56 9.9 9.9 0 0 0-.7 3.91v.03c0 1.51.24 2.83.7 3.94a5.93 5.93 0 0 0 1.97 2.57c.85.6 1.82.9 2.93.9Zm-41.41 5.68c-2.11 0-3.93-.53-5.46-1.57a10.03 10.03 0 0 1-3.54-4.5 18.22 18.22 0 0 1-1.22-7.01v-.03c0-2.73.42-5.07 1.24-7 .83-1.96 2-3.45 3.52-4.48a9.44 9.44 0 0 1 5.46-1.57c1.19 0 2.28.2 3.28.58 1 .4 1.88.96 2.63 1.7a7.99 7.99 0 0 1 1.82 2.6h.14V10.17h6.85V44h-6.85v-4.29h-.14a7.94 7.94 0 0 1-1.78 2.58 8.1 8.1 0 0 1-2.62 1.64 9.1 9.1 0 0 1-3.33.59Zm2.3-5.68c1.1 0 2.08-.3 2.93-.89a5.94 5.94 0 0 0 1.97-2.58c.46-1.1.7-2.42.7-3.93v-.03a9.6 9.6 0 0 0-.73-3.91 5.78 5.78 0 0 0-1.97-2.56 4.76 4.76 0 0 0-2.9-.9c-1.14 0-2.13.29-2.96.88a5.7 5.7 0 0 0-1.92 2.56c-.45 1.09-.68 2.4-.68 3.93v.03c0 1.51.22 2.83.66 3.94a5.85 5.85 0 0 0 1.92 2.57c.84.6 1.84.9 2.98.9ZM109.84 44V10.18h6.85V44h-6.85Zm-11.6 0V18.87h6.85V44h-6.85Zm3.42-28.36c-1.03 0-1.9-.35-2.6-1.05a3.43 3.43 0 0 1-1.05-2.51c0-.99.35-1.82 1.05-2.51.7-.7 1.57-1.05 2.6-1.05s1.9.35 2.6 1.05a3.38 3.38 0 0 1 1.06 2.5c0 .98-.35 1.81-1.05 2.52-.7.7-1.57 1.05-2.6 1.05ZM79 44.52a9.26 9.26 0 0 1-4.71-1.13 7.57 7.57 0 0 1-2.95-3.26c-.68-1.4-1.01-3.08-1.01-5.04V18.88h6.84v14.79c0 1.64.39 2.9 1.15 3.82.78.9 1.94 1.35 3.47 1.35a5.1 5.1 0 0 0 2.06-.4 4.47 4.47 0 0 0 1.6-1.12c.43-.5.77-1.09 1-1.76a6.93 6.93 0 0 0 .36-2.25V18.88h6.84V44H86.8v-4.15h-.14a8.26 8.26 0 0 1-1.74 2.49c-.7.7-1.55 1.24-2.56 1.61-.98.38-2.1.57-3.37.57ZM43.87 44v-5.27h9.63c2.03 0 3.59-.41 4.66-1.22a4.25 4.25 0 0 0 1.62-3.59v-.04c0-1.04-.25-1.9-.75-2.6a4.5 4.5 0 0 0-2.23-1.62c-.96-.36-2.17-.54-3.6-.54h-9.33v-4.8h8.48c2 0 3.52-.4 4.55-1.2a4.06 4.06 0 0 0 1.57-3.4v-.05c0-1.34-.46-2.38-1.38-3.11-.93-.75-2.21-1.13-3.87-1.13h-9.35v-5.25h11.18c2.14 0 3.98.34 5.53 1.03a8.12 8.12 0 0 1 3.58 2.95 7.92 7.92 0 0 1 1.27 4.5v.05a7.1 7.1 0 0 1-.87 3.45 7.63 7.63 0 0 1-2.32 2.62 7.57 7.57 0 0 1-3.35 1.3v.13c1.58.11 2.98.53 4.2 1.27a7.84 7.84 0 0 1 2.86 2.86A7.6 7.6 0 0 1 67 34.32v.05c0 1.97-.48 3.67-1.43 5.1a9.23 9.23 0 0 1-4.03 3.36A15.1 15.1 0 0 1 55.3 44H43.87Zm-3.54 0V10.18h7.08V44h-7.08Z\" />\n </svg>\n <div style=\"max-width: 60ch; margin: 48px auto 12px\">\n <p style=\"margin: 0 0 32px 0;\">\n Seamlessly integrate Personio with your existing tools and workflows\n using our powerful APIs, and build automations, scripts, and\n applications that <mark style=\"background-color: #FFFCCC; font-weight: 600;\">supercharge</mark> your HR processes.\n </p>\n <p style=\"display: flex; flex-grow: 0; \">\n <a href=\"/docs?ref=intro\" style=\"\n margin-right: 10px;\n display: flex;\n align-items: center;\n padding: 10px 18px 10px 20px;\n border-radius: 40px;\n border: 1px solid black;\n background: black;\n color: white;\n text-decoration: none;\n \">\n <svg xmlns=\"http://www.w3.org/2000/svg\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"1.5\"\n stroke=\"currentColor\" style=\"height: 14px; width: 14px; margin-right: 8px; \">\n <path stroke-linecap=\"round\" stroke-linejoin=\"round\"\n d=\"M15.59 14.37a6 6 0 0 1-5.84 7.38v-4.8m5.84-2.58a14.98 14.98 0 0 0 6.16-12.12A14.98 14.98 0 0 0 9.631 8.41m5.96 5.96a14.926 14.926 0 0 1-5.841 2.58m-.119-8.54a6 6 0 0 0-7.381 5.84h4.8m2.581-5.84a14.927 14.927 0 0 0-2.58 5.84m2.699 2.7c-.103.021-.207.041-.311.06a15.09 15.09 0 0 1-2.448-2.448 14.9 14.9 0 0 1 .06-.312m-2.24 2.39a4.493 4.493 0 0 0-1.757 4.306 4.493 4.493 0 0 0 4.306-1.758M16.5 9a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0Z\" />\n </svg>\n\n Get Started\n </a>\n <a href=\"/reference?ref=intro\" style=\"\n display: flex;\n align-items: center;\n padding: 10px 20px;\n border-radius: 40px;\n color: black;\n border: 1px solid black;\n text-decoration: none;\n \">\n <svg xmlns=\"http://www.w3.org/2000/svg\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"1.5\"\n stroke=\"currentColor\" style=\"height: 14px; width: 14px; margin-right: 8px; \">\n <path stroke-linecap=\"round\" stroke-linejoin=\"round\"\n d=\"M12 6.042A8.967 8.967 0 0 0 6 3.75c-1.052 0-2.062.18-3 .512v14.25A8.987 8.987 0 0 1 6 18c2.305 0 4.408.867 6 2.292m0-14.25a8.966 8.966 0 0 1 6-2.292c1.052 0 2.062.18 3 .512v14.25A8.987 8.987 0 0 0 18 18a8.967 8.967 0 0 0-6 2.292m0-14.25v14.25\" />\n </svg>\n\n API Reference</a>\n </p>\n <div style=\"background: #EAE5FF; margin-top: 48px; padding: 24px\">\n <p style=\"font-size: 20px; margin: 0 0 9px 0; font-weight: 700\">Partners & publishers</p>\n <p style=\"margin: 0 0 9px 0;\">\n Join Personio’s marketplace and empower 10,000+ businesses with your innovative\n solutions.\n </p>\n <p style=\"margin:0\">\n <a style=\"color: black; font-weight: 700; text-decoration: none;\"\n href=\"https://support.personio.de/hc/en-us/articles/360011430518-First-Steps-Towards-a-Product-Partnership-With-Personio?ref=dev_hero\">\n <span style=\"text-decoration: underline;\">Become\n a product partner</span>\n <svg xmlns=\"http://www.w3.org/2000/svg\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"1.5\"\n stroke=\"currentColor\" style=\"width: 12px; height: 12px;\">\n <path stroke-linecap=\"round\" stroke-linejoin=\"round\"\n d=\"M13.5 6H5.25A2.25 2.25 0 0 0 3 8.25v10.5A2.25 2.25 0 0 0 5.25 21h10.5A2.25 2.25 0 0 0 18 18.75V10.5m-10.5 6L21 3m0 0h-5.25M21 3v5.25\" />\n </svg>\n </a>\n </p>\n </div>\n\n</section>\n\n \n"},{"type":"html","alignment":"left","html":""},{"type":"text","alignment":"center","title":"Personio Webhooks are now live!","text":"We are proud to announce that Webhooks for the Person entity are now available to all Personio customers who have access to the Public API. To get started on your Webhooks journey, please navigate to https://developer.personio.de/v2.0/reference/webhooks"}],"mdxMigrationStatus":"rdmd","metrics":{"monthlyLimit":0,"thumbsEnabled":true,"planLimit":1000000,"realtime":{"dashEnabled":false,"hubEnabled":false},"monthlyPurchaseLimit":0,"meteredBilling":{}},"modules":{"docs":true,"landing":true,"suggested_edits":false,"discuss":true,"reference":true,"examples":true,"changelog":true,"custompages":false,"logs":false,"tutorials":false,"graphql":false},"name":"Personio Developer Hub","nav_names":{"discuss":"","docs":"Documentation","reference":"API Reference","changelog":"","tutorials":"","recipes":""},"oauth_url":"","onboardingCompleted":{"documentation":true,"appearance":true,"jwt":true,"api":true,"logs":true,"domain":true,"metricsSDK":false},"owlbot":{"enabled":false,"isPaying":false,"customization":{"answerLength":"long","customTone":"","defaultAnswer":"","forbiddenWords":"","tone":"neutral"},"copilot":{"enabled":false,"hasBeenUsed":false,"installedCustomPage":""}},"owner":{"id":null,"email":null,"name":null},"plan":"startup","planOverride":"","planSchedule":{"stripeScheduleId":null,"changeDate":null,"nextPlan":null},"planStatus":"active","planTrial":"startup","readmeScore":{"components":{"newDesign":{"enabled":true,"points":25},"reference":{"enabled":true,"points":50},"tryItNow":{"enabled":true,"points":35},"syncingOAS":{"enabled":true,"points":10},"customLogin":{"enabled":true,"points":25},"metrics":{"enabled":false,"points":40},"recipes":{"enabled":false,"points":15},"pageVoting":{"enabled":true,"points":1},"suggestedEdits":{"enabled":false,"points":10},"support":{"enabled":true,"points":5},"htmlLanding":{"enabled":true,"points":5},"guides":{"enabled":true,"points":10},"changelog":{"enabled":true,"points":5},"glossary":{"enabled":false,"points":1},"variables":{"enabled":true,"points":1},"integrations":{"enabled":false,"points":2}},"percentScore":62.5,"totalScore":172},"reCaptchaSiteKey":"6LcmlxEpAAAAAOueYtfm2GJ5GH3jsvZYf_6bIkr1","reference":{"alwaysUseDefaults":true,"defaultExpandResponseExample":false,"defaultExpandResponseSchema":false,"enableOAuthFlows":false},"seo":{"overwrite_title_tag":false},"stable":{"_id":"58bec8f49d43720f0043fdb5","createdAt":"2017-03-07T14:51:32.985Z","is_beta":false,"is_deprecated":false,"project":"58bec8f49d43720f0043fdb2","categories":["58bec8f59d43720f0043fdb6","58beca30362a592f00396740","58beca4b2710c31b00414cb2","58c1db2d0de1f70f00a0b840","58c318c439b3fd0f0039ef38","58c334b02c506d0f00c1aeab","58c69a1eebb6c70f003482c9","58c6acb4ebb6c70f00348462","58cd35eebef8592f00efb455","58cd362950a0c12500e89a68","58cd362c72a4cb1900438ea7","58cd38cbd7d86d1900476413","58cd38cd51a94e3100d5bdb6","58cd38cf72a4cb1900438eea","58cd3aff72a4cb1900438f0f","58cd3da0bef8592f00efb459","58cd3da265903d3700d08363","58cd3f4265903d3700d08385","58cd3f9b50a0c12500e89b4c","58cd408265903d3700d083a8","58cd485f50a0c12500e89bd4","58cd4a8450a0c12500e89bf9","58cd4aafd7d86d1900476521","58ce970ea6027e1b00db4bed","5943ab89b03361002dff3c20","5b27d022ba156500032234d5","5b27d2a36814190003f640ed","5b27d4b14a48b70003b371fc","5b28b87494e1f7000317f654","5b28b88636a5030003c3f672","5b28c2538b57130003e712fa","5b55dd1cb065af000305e217","5b55dd9a6bd0940003c996d3","5c34c6163365e70025b48b6f","5c374cf97267aa42020e6281","5c374d58a6af2943c3dac097","5cdbe8965c024f004b319c2b","5cece58fa4dd7d0045f4e395","5d380ff13810e8003f49d587","60646e26c44914007fc12db3","609158e8204c7e001baff966","615c253879b7fc0174732f0f","6376bee1127d99000316955b","63d3f5ad609d9b00316661ba","645e595f750cac094b038204","645e59841d43c500187c885b","645e5a084bfecf13f03bbf97","649b0c11964de6005f04e0d7","649b0cc11362fb00633429b4","67239f85efa67b00103fae40"],"codename":"","is_hidden":false,"is_stable":true,"releaseDate":"2017-03-07T14:51:32.985Z","version":"1.0","version_clean":"1.0.0","__v":39,"updatedAt":"2024-10-31T15:17:25.348Z"},"subdomain":"personio","subpath":"","superHubWaitlist":false,"topnav":{"edited":true,"left":[],"right":[{"type":"url","url":"https://www.personio.com/partner/tech/","text":"Become a Partner"}],"bottom":[]},"trial":{"trialEndsAt":"2017-03-21T14:51:32.942Z","trialDeadlineEnabled":true},"translate":{"languages":[],"provider":"transifex","key_public":"","org_name":"","project_name":"","show_widget":false},"url":"https://www.personio.de","versions":[{"_id":"649b0c84f81290003b150171","version":"0-UNRELEASED","version_clean":"0.0.0-UNRELEASED","codename":"DO-NOT-PUBLISH-experiments","is_stable":false,"is_beta":false,"is_hidden":true,"is_deprecated":false,"categories":["649b0c84f81290003b150125","58beca30362a592f00396740","58beca4b2710c31b00414cb2","58c1db2d0de1f70f00a0b840","58c318c439b3fd0f0039ef38","58c334b02c506d0f00c1aeab","58c69a1eebb6c70f003482c9","58c6acb4ebb6c70f00348462","58cd35eebef8592f00efb455","58cd362950a0c12500e89a68","58cd362c72a4cb1900438ea7","58cd38cbd7d86d1900476413","58cd38cd51a94e3100d5bdb6","58cd38cf72a4cb1900438eea","58cd3aff72a4cb1900438f0f","58cd3da0bef8592f00efb459","58cd3da265903d3700d08363","58cd3f4265903d3700d08385","58cd3f9b50a0c12500e89b4c","58cd408265903d3700d083a8","58cd485f50a0c12500e89bd4","649b0c84f81290003b150126","58cd4aafd7d86d1900476521","649b0c84f81290003b150127","649b0c84f81290003b150128","5b27d022ba156500032234d5","5b27d2a36814190003f640ed","5b27d4b14a48b70003b371fc","5b28b87494e1f7000317f654","5b28b88636a5030003c3f672","5b28c2538b57130003e712fa","5b55dd1cb065af000305e217","5b55dd9a6bd0940003c996d3","5c34c6163365e70025b48b6f","5c374cf97267aa42020e6281","5c374d58a6af2943c3dac097","5cdbe8965c024f004b319c2b","649b0c84f81290003b150129","5d380ff13810e8003f49d587","649b0c84f81290003b15012a","649b0c84f81290003b15012b","615c253879b7fc0174732f0f","6376bee1127d99000316955b","63d3f5ad609d9b00316661ba","645e595f750cac094b038204","645e59841d43c500187c885b","649b0c84f81290003b15012c","649b0c11964de6005f04e0d7","649b0c85f81290003b150173","649c196758b306006af5e9e0","649c1da8f379e10026080982","649d8da78a0e9600580364f7","6583065db2c392006b1412fd","658306b6e5fdd7005474ab3f","658307b011e4a7007984fd7a","65830801ecb6b8001064c305","658309290f1c6c003f3f11b3","658309734b0064003a79444d","65830a22d5b662003826dd45","65830ad517bb6f004123202f","65830b53d5b662003826e1dd","65830b86530a5a002aead6a8","65830be317bb6f004123208d","65830c985bfa7d00782c1b6e","6584371a95105d004e98ebf7","658437e84ad97d003055fe4c","658438673518a80045c3783a","658438b16dd539005a952db9","658438ec6dd539005a952e06","65843b911c90ba0030d6675d","65843bf11cae46000ef05222","65843c8679a2070022b5736c","65843cd8c0cfb0003883379a","65843d46477c9f002a36951a","65843d8579a2070022b573dd"],"createdAt":"2023-06-27T16:21:24.927Z","project":"58bec8f49d43720f0043fdb2","releaseDate":"2017-03-07T14:51:32.985Z","__v":2,"updatedAt":"2023-12-21T13:28:37.411Z","forked_from":"58bec8f49d43720f0043fdb5"},{"_id":"58bec8f49d43720f0043fdb5","createdAt":"2017-03-07T14:51:32.985Z","is_beta":false,"is_deprecated":false,"project":"58bec8f49d43720f0043fdb2","categories":["58bec8f59d43720f0043fdb6","58beca30362a592f00396740","58beca4b2710c31b00414cb2","58c1db2d0de1f70f00a0b840","58c318c439b3fd0f0039ef38","58c334b02c506d0f00c1aeab","58c69a1eebb6c70f003482c9","58c6acb4ebb6c70f00348462","58cd35eebef8592f00efb455","58cd362950a0c12500e89a68","58cd362c72a4cb1900438ea7","58cd38cbd7d86d1900476413","58cd38cd51a94e3100d5bdb6","58cd38cf72a4cb1900438eea","58cd3aff72a4cb1900438f0f","58cd3da0bef8592f00efb459","58cd3da265903d3700d08363","58cd3f4265903d3700d08385","58cd3f9b50a0c12500e89b4c","58cd408265903d3700d083a8","58cd485f50a0c12500e89bd4","58cd4a8450a0c12500e89bf9","58cd4aafd7d86d1900476521","58ce970ea6027e1b00db4bed","5943ab89b03361002dff3c20","5b27d022ba156500032234d5","5b27d2a36814190003f640ed","5b27d4b14a48b70003b371fc","5b28b87494e1f7000317f654","5b28b88636a5030003c3f672","5b28c2538b57130003e712fa","5b55dd1cb065af000305e217","5b55dd9a6bd0940003c996d3","5c34c6163365e70025b48b6f","5c374cf97267aa42020e6281","5c374d58a6af2943c3dac097","5cdbe8965c024f004b319c2b","5cece58fa4dd7d0045f4e395","5d380ff13810e8003f49d587","60646e26c44914007fc12db3","609158e8204c7e001baff966","615c253879b7fc0174732f0f","6376bee1127d99000316955b","63d3f5ad609d9b00316661ba","645e595f750cac094b038204","645e59841d43c500187c885b","645e5a084bfecf13f03bbf97","649b0c11964de6005f04e0d7","649b0cc11362fb00633429b4","67239f85efa67b00103fae40"],"codename":"","is_hidden":false,"is_stable":true,"releaseDate":"2017-03-07T14:51:32.985Z","version":"1.0","version_clean":"1.0.0","__v":39,"updatedAt":"2024-10-31T15:17:25.348Z"},{"_id":"6527bc3eb308ad001a4f25c0","version":"2.0","version_clean":"2.0.0","codename":"Stable and Ready for Scaled Usage","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["6527bc3eb308ad001a4f2574","58beca30362a592f00396740","58beca4b2710c31b00414cb2","58c1db2d0de1f70f00a0b840","58c318c439b3fd0f0039ef38","58c334b02c506d0f00c1aeab","58c69a1eebb6c70f003482c9","58c6acb4ebb6c70f00348462","58cd35eebef8592f00efb455","58cd362950a0c12500e89a68","58cd362c72a4cb1900438ea7","58cd38cbd7d86d1900476413","58cd38cd51a94e3100d5bdb6","58cd38cf72a4cb1900438eea","58cd3aff72a4cb1900438f0f","58cd3da0bef8592f00efb459","58cd3da265903d3700d08363","58cd3f4265903d3700d08385","58cd3f9b50a0c12500e89b4c","58cd408265903d3700d083a8","58cd485f50a0c12500e89bd4","6527bc3eb308ad001a4f2575","58cd4aafd7d86d1900476521","6527bc3eb308ad001a4f2576","6527bc3eb308ad001a4f2577","5b27d022ba156500032234d5","5b27d2a36814190003f640ed","5b27d4b14a48b70003b371fc","5b28b87494e1f7000317f654","5b28b88636a5030003c3f672","5b28c2538b57130003e712fa","5b55dd1cb065af000305e217","5b55dd9a6bd0940003c996d3","5c34c6163365e70025b48b6f","5c374cf97267aa42020e6281","5c374d58a6af2943c3dac097","5cdbe8965c024f004b319c2b","6527bc3eb308ad001a4f2578","5d380ff13810e8003f49d587","6527bc3eb308ad001a4f2579","6527bc3eb308ad001a4f257a","615c253879b7fc0174732f0f","6376bee1127d99000316955b","63d3f5ad609d9b00316661ba","645e595f750cac094b038204","645e59841d43c500187c885b","6527bc3eb308ad001a4f257b","649b0c11964de6005f04e0d7","6527bc3eb308ad001a4f257c","6527bc3fb308ad001a4f25c2","6527bff7852f670074188446","6527d2b80618570039103154","65325081e701d900334acc0e","6538cdfaa9b625005a56d663","653bd759bcfb7a006ea777bc","653bd90bf88c1c0027301906","655cb153e417660068aeead2","6565f6b1ebea3800183fee3d","65685b78dfbc80001ca9a1c2","6571ef90cb0b810046bf4530","659fb2d670b5ae006bd7f90c","659fb2e049bc73007fe54bc0","65cf7cdc112665007358994b","65cf8191249c29006d6e9afe","65d4b2e62db206000ff6d6a9","65dc5ab25cf05f0049c63cca","65dc5b4d28676000363844cd","65dc5f4aa06c53006f84ca45","65dcb4e8b037af006f71a2d4","65dcb504d10d9c002aa58b12","65df04401bb78b006b641959","65df0455a1ebcf0021c7e6df","65df2213c85755005b88ec30","65df222600d64d000f9a8567","65f2e7493401930016929844","65f9662d4ebdd7003d959bba","65f9663f690838004b9208b6","65fbfe1df2b2bf00665f3cd6","65fc0b7c40e02e004513d1fb","65fc0bc31513cc001c8c83c5","65fc628d29396b0012bd8b65","6603da7faec4e000581c802d","66215c80b51417001e5d22cb","66215c812331fb0018ad1e1e","66215cf2ddc66b004ddd74aa","66215cf36998b600608d6208","66215d6939b32f001096f59f","66215d6ad2bf100019706d80","66215db92cac31004cef4799","66215dba45c13d001251d4e6","662f75c627c650001fe4ea62","662fdd74569144005aaa1b8d","662fdd7501b4ca005300ef2c","663341c1e0cd1e005c14bf8d","663341c29091f700423214af","6634f590c09014001ff6c14d","663df74d6e2b7a003d3b10b0","664c75e859e7480036248e1a","66a11ab16c0a50006290acb4","66a2407d1b5fa0004ac4d905","66d0a863bb7a580036f36320","66d1a4bad7abe20018cfe6dc","66d9b820191cd8005b8ba713","66d9b8948761d7005adb7554"],"createdAt":"2023-10-12T09:28:30.006Z","project":"58bec8f49d43720f0043fdb2","releaseDate":"2017-03-07T14:51:32.985Z","__v":2,"updatedAt":"2024-09-05T13:56:36.870Z","forked_from":"58bec8f49d43720f0043fdb5"}],"variableDefaults":[{"source":"security","_id":"640201ebb4e93c007aad11f1","name":"bearerAuth","type":"http","scheme":"bearer","apiSetting":"609158e7204c7e001baff965"},null,{"source":"security","_id":"671a09d65afe4c001f2e5a22","name":"BearerAuth","type":"http","scheme":"bearer","apiSetting":"58cd4a8450a0c12500e89bf8"}],"webhookEnabled":false,"isHubEditable":true},"projectStore":{"data":{"allow_crawlers":"disabled","glossary":[],"canonical_url":null,"description":"Find documentation for the Personio API as well as comprehensive guides for integrating Personio into your existing landscape of tools and services.","parent":null,"homepage_url":"https://www.personio.de","id":"58bec8f49d43720f0043fdb2","is_migrated":false,"name":"Personio Developer Hub","redirects":[],"sitemap":"disabled","subdomain":"personio","suggested_edits":"disabled","uri":"/projects/me","variable_defaults":[{"name":"bearerAuth","scheme":"bearer","source":"security","type":"http","id":"640201ebb4e93c007aad11f1"},{"name":"BearerAuth","scheme":"bearer","source":"security","type":"http","id":"671a09d65afe4c001f2e5a22"}],"webhooks":[],"custom_login":{"login_url":null,"logout_url":null},"onboarding_completed":{"api":true,"appearance":true,"documentation":true,"domain":true,"jwt":true,"logs":true,"metricsSDK":false},"pages":{"not_found":null},"privacy":{"view":"public","password":null},"reference":{"api_sdk_snippets":"enabled","defaults":"always_use","json_editor":"disabled","oauth_flows":"disabled","request_history":"enabled","response_examples":"collapsed","response_schemas":"collapsed"},"seo":{"overwrite_title_tag":"disabled"},"plan":{"type":"startup","grace_period":{"enabled":false,"end_date":null},"trial":{"expired":false,"end_date":"2017-03-21T14:51:32.942Z"}},"health_check":{"provider":"none","settings":{"manual":{"status":"down","url":null},"statuspage":{"id":null}}},"integrations":{"bing":{"verify":null},"google":{"analytics":null,"site_verification":null},"heap":{"id":null},"koala":{"key":null},"localize":{"key":null},"recaptcha":{"site_key":"6LcmlxEpAAAAAOueYtfm2GJ5GH3jsvZYf_6bIkr1","secret_key":null},"segment":{"key":null,"domain":null},"typekit":{"key":null},"zendesk":{"subdomain":null},"intercom":{"app_id":null,"secure_mode":{"key":null,"email_only":false}}},"permissions":{"appearance":{"private_label":"disabled","custom_code":{"css":"enabled","html":"disabled","js":"disabled"}}},"appearance":{"brand":{"primary_color":"#000000","link_color":null,"theme":"light"},"changelog":{"layout":"collapsed","show_author":true,"show_exact_date":false},"markdown":{"callouts":{"icon_font":"emojis"}},"table_of_contents":"enabled","whats_next_label":null,"footer":{"readme_logo":"show"},"logo":{"size":"default","dark_mode":{"uri":"/images/65d5019905245d000f7acf9f","url":"https://files.readme.io/4e0e706-small-PDark.png","name":"4e0e706-small-PDark.png","width":656,"height":80,"color":"#ffffff","links":{"original_url":"https://files.readme.io/f785616-PDark.png"}},"main":{"uri":"/images/65d4f7e29e4634003dea6747","url":"https://files.readme.io/425c15b-small-P_DeveloperHub.png","name":"425c15b-small-P_DeveloperHub.png","width":656,"height":80,"color":"#000000","links":{"original_url":"https://files.readme.io/16460be-P_DeveloperHub.png"}},"favicon":{"uri":null,"url":"https://files.readme.io/4d285de-Favicon.svg","name":"4d285de-Favicon.svg","width":496,"height":496,"color":"#555555","links":{"original_url":"65d5f780137db000123097e9"}}},"custom_code":{"css":".hub-reference-left > div.magic-block-callout, .hub-reference-left > div.magic-block-textarea {\n margin-top: 30px;\n}\n\n \nbody {\n\tfont-family: \"Inter\",-apple-system,system-ui,BlinkMacSystemFont,\"Segoe UI\",Roboto,\"Helvetica Neue\",Arial,sans-serif !important;\n}\n\na {\n\tcolor: #000; \n font-weight: 600;\n}\n\n/*Top navbar\n#header-top {\n\theight: 80px !important;\n}\n\n#subheader-links a.active {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF;\n color: #0DB5DF !important;\n font-weight: 700;\n}\n\n.theme-line header#hub-header #header-top{\n border-bottom: 1px solid #ffffff;\n}\n\n#hub-subheader-parent #hub-subheader {\n background-color: #f4f7f9;\n \tborder-bottom: 1px solid #ffffff;\n}\n*/\n\nimg.rm-Logo-img { \n\theight: 0;\n width: 0;\n padding: 0 189px 23px 0;\n background-image: url('https://files.readme.io/4e0e706-small-PDark.png');\n background-size: cover;\n}\n\nheader.rm-Header { \n position:sticky; top:0;\n box-shadow: none;\n -webkit-box-shadow: none;\n}\n\n.Header-topuTMpygDG4e1V .rm-SearchToggle-icon,\ndiv.rm-Header-left button.icon-menu,\ndiv.rm-Header-left div { \n color: white !important; \n}\n\ndiv.rm-Header-top {\n border:none;\n background: #000;\n}\n\ndiv.rm-Header-top a.Button { \n color: #fff;\n}\n\ndiv.rm-Header-top a.Button:active,\ndiv.rm-Header-top a.Button:hover { \n color: #fff !important;\n text-decoration: underline;\n}\n\ndiv.rm-Header-bottom { \n\tborder: none;\n\tbackground-color: white;\n}\n\n@media only screen and (max-width: 768px) {\n \na.Button.rm-Header-top-link { \n display:none;\n}\n}\na.Button.rm-Header-bottom-link {\n color: #000 !important;\n font-weight: 400;\n}\n\na.Button.rm-Header-bottom-link.active {\n background: none;\n border-bottom: 2px solid black;\n font-weight: 600;\n}\n\n/*\n\n.rm-Header-bottom-link{\n color: #7d7d8e !important;\n border-radius: 0;\n background: none !important;\n border-color: transparent !important;\n padding-bottom: 20px !important;\n padding-top: 20px !important;\n}\n.rm-Container > nav:nth-child(1){\n padding-bottom: 0px !important;\n padding-top: 0px !important;\n}\n\n.rm-Header-bottom-link:hover {\n\tbox-shadow: inset 0 -2px 0 #384248 !important;\n color: #384248 !important;\n border-radius: 0;\n background: none !important;\n border-color: transparent !important;\n}\n\n.rm-Header-bottom-link.active {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF !important;\n color: #0DB5DF !important;\n font-weight: 700 !important;\n border-radius: 0;\n background: none !important;\n}\n\n.rm-Header-bottom-link.active:hover {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF !important;\n color: #0DB5DF !important;\n font-weight: 700 !important;\n border-radius: 0;\n background: none !important;\n}\n.rm-LandingPage {\n max-width: var(--container-lg) !important;\n width: 100% !important;\n border: none !important\n}\n.rm-Header-bottom-link{\n color: #7d7d8e !important;\n border-radius: 0;\n background: none !important;\n border-color: transparent !important;\n padding-bottom: 20px !important;\n padding-top: 20px !important;\n}\n.rm-Container > nav:nth-child(1){\n padding-bottom: 0px !important;\n padding-top: 0px !important;\n}\n\n.rm-Header-bottom-link:hover {\n\tbox-shadow: inset 0 -2px 0 #384248 !important;\n color: #384248 !important;\n border-radius: 0;\n background: none !important;\n border-color: transparent !important;\n}\n\n.rm-Header-bottom-link.active {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF !important;\n color: #0DB5DF !important;\n font-weight: 700 !important;\n border-radius: 0;\n background: none !important;\n}\n\n.rm-Header-bottom-link.active:hover {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF !important;\n color: #0DB5DF !important;\n font-weight: 700 !important;\n border-radius: 0;\n background: none !important;\n}\n*/\n\n\n\n/*Main section of the landing page*/\n#main-landing-section{\n\tmargin: 15px 0;\n}\n\n#main-landing-section mark { \n border-radius: 23px;\n background: #FFFF00;\n padding: 1px 6px;\n}\n/*\n#hub-landing-top h2 {\n font-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 38px;\n font-weight: 700;\n line-height: 44px;\n color: rgb(45, 55, 71) !important;\n}\n\n.hub-landing-description p{\n\tfont-size: 18px;\n line-height: 26px;\n}\n*/\n\n.btn.btn-primary {\n\tbackground-color: #0db5df !important;\n}\n\n.btn.btn-secondary {\n\tbackground-color: #f4f7f9 !important;\n color: #555 !important;\n}\n/*\n#hub-landing-top .hub-landing-description {\n\tfont-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 16px;\n font-weight: 400;\n line-height: 20px;\n}\n*/\nh2.heading{\n\tfont-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 24px;\n font-weight: 700;\n line-height: 32px;\n color: rgb(45, 55, 71);\n}\n\nh3.heading{\n\tfont-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 18px;\n font-weight: 700;\n line-height: 24px;\n color: rgb(45, 55, 71);\n}\n\n\n/*Cards*/\n* {\n box-sizing: border-box;\n}\n\n/* Float two columns side by side */\n.column {\n float: left;\n width: 50%;\n padding: 0 30px;\n}\n\n.row-card {\n margin: 0 -30px;\n}\n\n/* Responsive columns */\n@media screen and (max-width: 600px) {\n .column {\n width: 100%;\n display: block;\n margin-bottom: 20px;\n }\n}\n\n/* Style the cards */\n.card {\n box-shadow: 0 13px 13px 0 rgba(0, 0, 0, 0.04);\n padding: 35px;\n text-align: left;\n background: rgb(255, 255, 255);\n border-radius: 8px;\n border: 1px solid #dce6ec;\n}\n\n.card h2{\n\tfont-size: 22px;\n margin: 0;\n margin-top: 0 !important;\n}\n\n.card p{\n\tfont-size: 16px;\n line-height: 24px;\n}\n\n.card a{\n\tmargin: 0;\n}\n\n\n\n/*Documentation*/\nnav#hub-sidebar ul a.active, nav#hub-sidebar ul>li.subnav-expanded>a {\n color: #555;\n background-color: #CFF0F9;\n \tfont-weight: 500;\n}\n\n.callout.callout_info{\n\tborder-left: 3px solid rgb(11, 152, 187);\n border-radius: 4px;\n}\n\n\n\n\n/*Change log*/\n.hub-changelog-list .changelog-post h3{\n\tfont-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 18px;\n font-weight: 700;\n line-height: 24px;\n color: rgb(45, 55, 71);\n}\n\n#changelog-type-icon.cl-improved, .icon-changelog-type.cl-improved {\n\tbackground-color: #0db5df; \n}\n\n#readmeLogo {\n display: none;\n}","js":null,"html":{"header":null,"home_footer":null,"page_footer":null}},"header":{"type":"line","gradient_color":null,"overlay":{"fill":"auto","type":"triangles","position":"top-left","image":{"uri":null,"url":null,"name":null,"width":null,"height":null,"color":null,"links":{"original_url":null}}}},"navigation":{"first_page":"landing_page","left":[],"logo_link":"landing_page","right":[{"type":"link_url","title":"Become a Partner","url":"https://www.personio.com/partner/tech/","custom_page":null}],"sub_nav":[],"subheader_layout":"links","version":"enabled","links":{"home":{"label":"Home","visibility":"enabled"},"graphql":{"label":"GraphQL","visibility":"disabled"},"guides":{"label":"Guides","alias":"Documentation","visibility":"enabled"},"reference":{"label":"API Reference","alias":"API Reference","visibility":"enabled"},"recipes":{"label":"Recipes","alias":null,"visibility":"disabled"},"changelog":{"label":"Changelog","alias":null,"visibility":"enabled"},"discussions":{"label":"Discussions","alias":null,"visibility":"enabled"}}}}}},"version":{"_id":"58bec8f49d43720f0043fdb5","createdAt":"2017-03-07T14:51:32.985Z","is_beta":false,"is_deprecated":false,"project":"58bec8f49d43720f0043fdb2","categories":["58bec8f59d43720f0043fdb6","58beca30362a592f00396740","58beca4b2710c31b00414cb2","58c1db2d0de1f70f00a0b840","58c318c439b3fd0f0039ef38","58c334b02c506d0f00c1aeab","58c69a1eebb6c70f003482c9","58c6acb4ebb6c70f00348462","58cd35eebef8592f00efb455","58cd362950a0c12500e89a68","58cd362c72a4cb1900438ea7","58cd38cbd7d86d1900476413","58cd38cd51a94e3100d5bdb6","58cd38cf72a4cb1900438eea","58cd3aff72a4cb1900438f0f","58cd3da0bef8592f00efb459","58cd3da265903d3700d08363","58cd3f4265903d3700d08385","58cd3f9b50a0c12500e89b4c","58cd408265903d3700d083a8","58cd485f50a0c12500e89bd4","58cd4a8450a0c12500e89bf9","58cd4aafd7d86d1900476521","58ce970ea6027e1b00db4bed","5943ab89b03361002dff3c20","5b27d022ba156500032234d5","5b27d2a36814190003f640ed","5b27d4b14a48b70003b371fc","5b28b87494e1f7000317f654","5b28b88636a5030003c3f672","5b28c2538b57130003e712fa","5b55dd1cb065af000305e217","5b55dd9a6bd0940003c996d3","5c34c6163365e70025b48b6f","5c374cf97267aa42020e6281","5c374d58a6af2943c3dac097","5cdbe8965c024f004b319c2b","5cece58fa4dd7d0045f4e395","5d380ff13810e8003f49d587","60646e26c44914007fc12db3","609158e8204c7e001baff966","615c253879b7fc0174732f0f","6376bee1127d99000316955b","63d3f5ad609d9b00316661ba","645e595f750cac094b038204","645e59841d43c500187c885b","645e5a084bfecf13f03bbf97","649b0c11964de6005f04e0d7","649b0cc11362fb00633429b4","67239f85efa67b00103fae40"],"codename":"","is_hidden":false,"is_stable":true,"releaseDate":"2017-03-07T14:51:32.985Z","version":"1.0","version_clean":"1.0.0","__v":39,"updatedAt":"2024-10-31T15:17:25.348Z"}},"reqUrl":"/reference/post_company-documents","version":{"_id":"58bec8f49d43720f0043fdb5","createdAt":"2017-03-07T14:51:32.985Z","is_beta":false,"is_deprecated":false,"project":"58bec8f49d43720f0043fdb2","categories":["58bec8f59d43720f0043fdb6","58beca30362a592f00396740","58beca4b2710c31b00414cb2","58c1db2d0de1f70f00a0b840","58c318c439b3fd0f0039ef38","58c334b02c506d0f00c1aeab","58c69a1eebb6c70f003482c9","58c6acb4ebb6c70f00348462","58cd35eebef8592f00efb455","58cd362950a0c12500e89a68","58cd362c72a4cb1900438ea7","58cd38cbd7d86d1900476413","58cd38cd51a94e3100d5bdb6","58cd38cf72a4cb1900438eea","58cd3aff72a4cb1900438f0f","58cd3da0bef8592f00efb459","58cd3da265903d3700d08363","58cd3f4265903d3700d08385","58cd3f9b50a0c12500e89b4c","58cd408265903d3700d083a8","58cd485f50a0c12500e89bd4","58cd4a8450a0c12500e89bf9","58cd4aafd7d86d1900476521","58ce970ea6027e1b00db4bed","5943ab89b03361002dff3c20","5b27d022ba156500032234d5","5b27d2a36814190003f640ed","5b27d4b14a48b70003b371fc","5b28b87494e1f7000317f654","5b28b88636a5030003c3f672","5b28c2538b57130003e712fa","5b55dd1cb065af000305e217","5b55dd9a6bd0940003c996d3","5c34c6163365e70025b48b6f","5c374cf97267aa42020e6281","5c374d58a6af2943c3dac097","5cdbe8965c024f004b319c2b","5cece58fa4dd7d0045f4e395","5d380ff13810e8003f49d587","60646e26c44914007fc12db3","609158e8204c7e001baff966","615c253879b7fc0174732f0f","6376bee1127d99000316955b","63d3f5ad609d9b00316661ba","645e595f750cac094b038204","645e59841d43c500187c885b","645e5a084bfecf13f03bbf97","649b0c11964de6005f04e0d7","649b0cc11362fb00633429b4","67239f85efa67b00103fae40"],"codename":"","is_hidden":false,"is_stable":true,"releaseDate":"2017-03-07T14:51:32.985Z","version":"1.0","version_clean":"1.0.0","__v":39,"updatedAt":"2024-10-31T15:17:25.348Z"},"lang":"en","langFull":"Default","isDetachedProductionSite":false}"></script></div><div id="hub-container"><div class="hub-container"><div state-container ng-attr-id="{{state.current().root !== 'docs' && 'react-app-content-container'}}"><div id="replace-view" ng-non-bindable></div></div></div></div><script>var is_hub = true; var is_hub2 = true; var is_hub_edit = true; </script><div id="ssr-end"><script id="__LOADABLE_REQUIRED_CHUNKS__" type="application/json">[6859,1802,9772,3284,7449,7372,9082,572,5312,5548,2395,6522,7112,4608,8263,1282,2852,3880,7783,1456,1666,5798,2144,2637,4674,1731,4002,3787,4935,6841,6722,1936,1202,9141,1080,9852,8684,7971,153,1313,1343,6060,9575,5408,2402,6922,2859,8063,4467,3859,3221,7327,7285,3307,4793,2616,3412,1948,678,7031,8899,2578]</script><script id="__LOADABLE_REQUIRED_CHUNKS___ext" type="application/json">{"namedChunks":["routes-SuperHub","Header","routes-PageNotFound","Footer","routes-Changelog","List","routes-Landing","core-icons-chevron-up-down-svg","routes-Doc","core-icons-alert-circle-svg","Post","Editor","core-icons-x-circle-svg","core-icons-suggested-edits-svg","routes-Reference","core-icons-more-vertical-svg","core-icons-lock-svg","core-icons-arrow-right-svg","routes-Discuss","Page","CustomPage","core-icons-arrow-up-right-svg","routes-Tutorials","core-icons-chevron-down-svg","core-icons-search-svg","core-icons-custom-pages-svg","routes-SuperHub-Routes","core-icons-star-svg","core-icons-trending-up-svg","core-icons-callout-info-svg","rmdx","routes-CustomPage","core-icons-webhook-svg","core-icons-message-circle-svg","New","core-icons-eye-off-svg","core-graphics-json-svg"]}</script> <script async data-chunk="main" src="https://cdn.readme.io/public/hub/web/main.766cf20fa350c2c18107.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/6859.fc1496da022e612abe33.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/1802.00a1e88cc0d9da2aae1b.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/9772.1912e092b9c8785ff5c3.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/3284.6ecd6ef27e2009d3fdc7.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/7449.dae0332305a8704415a6.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/7372.aa4569536a36087cf4a9.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/9082.f9fa9ec2b80af1ef61bd.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/572.bab1eda8453360a8a761.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/5312.ca2c08ec1b75bb03c21e.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/5548.8fb1bb5d57de6c263c67.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/2395.6288c030d5183baa5a89.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/6522.057d8ea587133ae98687.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/7112.69c3d611e7e54e411b26.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/4608.3b5a227647e78e858c3f.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/8263.a563779273b90f66c0db.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/1282.591f476c316bf3670bbd.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/routes-SuperHub.a3bb3020bf29f8f67ef8.js"></script> <script async data-chunk="Header" src="https://cdn.readme.io/public/hub/web/3880.3892311d81c548cb073c.js"></script> <script async data-chunk="Header" src="https://cdn.readme.io/public/hub/web/7783.48ca7ef3a5c469d97e53.js"></script> <script async data-chunk="Header" src="https://cdn.readme.io/public/hub/web/Header.ad57d9fcd570c04fb712.js"></script> <script async data-chunk="routes-PageNotFound" src="https://cdn.readme.io/public/hub/web/routes-PageNotFound.84a460336ee9c83a7d55.js"></script> <script async data-chunk="Footer" src="https://cdn.readme.io/public/hub/web/Footer.eb98b86c4279989f5a59.js"></script> <script async data-chunk="routes-Changelog" src="https://cdn.readme.io/public/hub/web/routes-Changelog.3f125a62ed05cc53aec4.js"></script> <script async data-chunk="List" src="https://cdn.readme.io/public/hub/web/2637.a5df1d5e240762d7981f.js"></script> <script async data-chunk="List" src="https://cdn.readme.io/public/hub/web/4674.13378da16ce7b5beba66.js"></script> <script async data-chunk="List" src="https://cdn.readme.io/public/hub/web/List.12cee315afa198c8e23e.js"></script> <script async data-chunk="routes-Landing" src="https://cdn.readme.io/public/hub/web/4002.08d1caef58d08eaccd19.js"></script> <script async data-chunk="routes-Landing" src="https://cdn.readme.io/public/hub/web/routes-Landing.f0816876bdfbbc06801a.js"></script> <script async data-chunk="core-icons-chevron-up-down-svg" src="https://cdn.readme.io/public/hub/web/core-icons-chevron-up-down-svg.6aae957df71e6f4c5e24.js"></script> <script async data-chunk="routes-Doc" src="https://cdn.readme.io/public/hub/web/6841.587d285d41ca8bab11b1.js"></script> <script async data-chunk="routes-Doc" src="https://cdn.readme.io/public/hub/web/6722.e485c5aa155bd0f0ccf8.js"></script> <script async data-chunk="routes-Doc" src="https://cdn.readme.io/public/hub/web/routes-Doc.e3a4e0817a9a640436bc.js"></script> <script async data-chunk="core-icons-alert-circle-svg" src="https://cdn.readme.io/public/hub/web/core-icons-alert-circle-svg.4cee8264c97045599b56.js"></script> <script async data-chunk="Post" src="https://cdn.readme.io/public/hub/web/Post.cced33af5051de7f473f.js"></script> <script async data-chunk="Editor" src="https://cdn.readme.io/public/hub/web/Editor.002979730c36f9c65ad3.js"></script> <script async data-chunk="core-icons-x-circle-svg" src="https://cdn.readme.io/public/hub/web/core-icons-x-circle-svg.abc0e0ea5b7f9dff667c.js"></script> <script async data-chunk="core-icons-suggested-edits-svg" src="https://cdn.readme.io/public/hub/web/core-icons-suggested-edits-svg.8d2d8ac2fd22ded9238d.js"></script> <script async data-chunk="routes-Reference" src="https://cdn.readme.io/public/hub/web/7971.db270c2970b791e38435.js"></script> <script async data-chunk="routes-Reference" src="https://cdn.readme.io/public/hub/web/153.e4db5a313c7d51383015.js"></script> <script async data-chunk="routes-Reference" src="https://cdn.readme.io/public/hub/web/routes-Reference.d66a49f09580aafdabb6.js"></script> <script async data-chunk="core-icons-more-vertical-svg" src="https://cdn.readme.io/public/hub/web/core-icons-more-vertical-svg.4822b3f831e11095980d.js"></script> <script async data-chunk="core-icons-lock-svg" src="https://cdn.readme.io/public/hub/web/core-icons-lock-svg.70942d3ee6bad6267696.js"></script> <script async data-chunk="core-icons-arrow-right-svg" src="https://cdn.readme.io/public/hub/web/core-icons-arrow-right-svg.eadb74658f93b4e7d75f.js"></script> <script async data-chunk="routes-Discuss" src="https://cdn.readme.io/public/hub/web/routes-Discuss.6a5b69949f194448cf4f.js"></script> <script async data-chunk="Page" src="https://cdn.readme.io/public/hub/web/Page.65c6f721688901333944.js"></script> <script async data-chunk="CustomPage" src="https://cdn.readme.io/public/hub/web/6922.e8247ef6931a72e55b3e.js"></script> <script async data-chunk="CustomPage" src="https://cdn.readme.io/public/hub/web/2859.94b03b9a9585460aa921.js"></script> <script async data-chunk="core-icons-arrow-up-right-svg" src="https://cdn.readme.io/public/hub/web/core-icons-arrow-up-right-svg.8ec73f7e322d79a2695b.js"></script> <script async data-chunk="routes-Tutorials" src="https://cdn.readme.io/public/hub/web/routes-Tutorials.8adf2bf8562dfeff14b4.js"></script> <script async data-chunk="core-icons-chevron-down-svg" src="https://cdn.readme.io/public/hub/web/core-icons-chevron-down-svg.e20b84e9871bd73d1b8c.js"></script> <script async data-chunk="core-icons-search-svg" src="https://cdn.readme.io/public/hub/web/core-icons-search-svg.ad9cac962958d30983a7.js"></script> <script async data-chunk="core-icons-custom-pages-svg" src="https://cdn.readme.io/public/hub/web/core-icons-custom-pages-svg.444e514638d9afbec182.js"></script> <script async data-chunk="routes-SuperHub-Routes" src="https://cdn.readme.io/public/hub/web/7285.703d773b1bb63ae6e7ee.js"></script> <script async data-chunk="routes-SuperHub-Routes" src="https://cdn.readme.io/public/hub/web/routes-SuperHub-Routes.5ccfbee71da134a1eeba.js"></script> <script async data-chunk="core-icons-star-svg" src="https://cdn.readme.io/public/hub/web/core-icons-star-svg.b834e1612cb2af1e174e.js"></script> <script async data-chunk="core-icons-trending-up-svg" src="https://cdn.readme.io/public/hub/web/core-icons-trending-up-svg.0dd920b0698e57f75afa.js"></script> <script async data-chunk="core-icons-callout-info-svg" src="https://cdn.readme.io/public/hub/web/core-icons-callout-info-svg.79b14e8568c9cecbc827.js"></script> <script async data-chunk="rmdx" src="https://cdn.readme.io/public/hub/web/rmdx.594ae0fac8012b876a80.js"></script> <script async data-chunk="core-icons-webhook-svg" src="https://cdn.readme.io/public/hub/web/core-icons-webhook-svg.fe540ea1c09e1c0e0247.js"></script> <script async data-chunk="core-icons-message-circle-svg" src="https://cdn.readme.io/public/hub/web/core-icons-message-circle-svg.1e24c2d2eb4f9a6ede5d.js"></script> <script async data-chunk="New" src="https://cdn.readme.io/public/hub/web/New.908bc26e77bebc585452.js"></script> <script async data-chunk="core-icons-eye-off-svg" src="https://cdn.readme.io/public/hub/web/core-icons-eye-off-svg.b2b8b241b4b324dfd9c1.js"></script></div><script id="hub-me" type="application/json" data-json="{"loggedIn":false,"search":{"app":"T28YKFATPY","token":"YzY0MThjMDM2YWVjMDI2ODRiZWQ5ODA0NTQ1ODhiMmQzMDE0ZDc4MjRiNGExNjBkMzQ2YmViZmIwZTBkNDRjYXRhZ0ZpbHRlcnM9KHByb2plY3Q6NThiZWM4ZjQ5ZDQzNzIwZjAwNDNmZGIyKSwodmVyc2lvbjpub25lLHZlcnNpb246NThiZWM4ZjQ5ZDQzNzIwZjAwNDNmZGI1KSwoaGlkZGVuOm5vbmUsaGlkZGVuOmZhbHNlKSwoaW5kZXg6Q3VzdG9tUGFnZSxpbmRleDpQYWdlLGluZGV4OkRpc2N1c3MsaW5kZXg6QmxvZyk=","filters":"tagFilters=(project:58bec8f49d43720f0043fdb2),(version:none,version:58bec8f49d43720f0043fdb5),(hidden:none,hidden:false),(index:CustomPage,index:Page,index:Discuss,index:Blog)","metaData":[{"modules":{"docs":true,"landing":true,"suggested_edits":false,"discuss":true,"reference":true,"examples":true,"changelog":true,"custompages":false,"logs":false,"tutorials":false,"graphql":false},"id":"58bec8f49d43720f0043fdb2","name":"Personio Developer Hub","subdomain":"personio","subpath":"","nav_names":{"discuss":"","docs":"Documentation","reference":"API Reference","changelog":"","tutorials":"","recipes":""}}]}}"></script><script id="readme-data-baseUrl" type="application/json" data-json=""/""></script></body></html>

CINXE.COM

Upload Document