Skip to main content
PUT
Upload custom employee stat values

Authorizations

Authorization
string
header
required

Use an API key or OAuth access token. Enter only the token in the authorization dialog; requests send it as Authorization: Bearer <TOKEN>.

Create an API key in your workspace's Settings → API keys. Keys start with wm_api_ and only work in the workspace where they were created. Read-only keys can read data; creating, updating, or deleting data requires a read-write key.

OAuth access tokens are issued for connected Windmill applications.

Both token types use the authenticated user's workspace permissions. Each endpoint's permission requirements and the sharing settings of the requested items still apply.

Path Parameters

companyId
string
required

Company ID. A URL slug is also accepted. The caller must have access to this company.

Required string length: 1 - 128
Example:

"company-acme"

Body

application/json
statMetadataId
string<uuid>
required

ID of an enabled, non-archived custom definition owned by this workspace. Windmill-managed definitions and their identifiers cannot be written through this route.

Example:

"11111111-1111-4111-8111-111111111111"

values
Employee stat values · object[]
required

1 to 1000 values for this definition. Each employee/date/dimension key must be unique within the request after emails resolve to employees. All values are validated and written together.

Required array length: 1 - 1000 elements

Response

Number of values written

updated
integer
required

Number of submitted values successfully created or replaced.

Required range: x >= 0
Example:

1