v1
latestOpenAPI 3.1.02026-07-26294215839.4 KBEmployee Files
Public API
Create Employee File Category
Creates one or more employee file categories (not company file categories). The request body is a JSON array of category name strings or an equivalent XML document with <category> elements. Each name must be non-empty and unique among existing employee file categories. An empty array returns 200 without creating anything. On success, returns 201 with no body. The admin user group is automatically granted edit permission on each new category.
OAuth Scopes: employee:file.write
post/api/v1/employees/files/categories
Request body
string[] required
Example request
[ "A new category" ]
Response
The request was processed but no categories were created (empty payload).