v1

latestOpenAPI 3.1.02026-07-26294215839.4 KB
Employee 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).