curl --request PUT \
--url https://api.gowindmill.com/api/v2/c/{companyId}/stats/values \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"statMetadataId": "11111111-1111-4111-8111-111111111111",
"values": [
{
"employeeId": "employee-avery",
"date": "2026-01-05",
"value": 5
},
{
"email": "morgan@example.test",
"date": "2026-01-05",
"value": 3
}
]
}
'import requests
url = "https://api.gowindmill.com/api/v2/c/{companyId}/stats/values"
payload = {
"statMetadataId": "11111111-1111-4111-8111-111111111111",
"values": [
{
"employeeId": "employee-avery",
"date": "2026-01-05",
"value": 5
},
{
"email": "morgan@example.test",
"date": "2026-01-05",
"value": 3
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
statMetadataId: '11111111-1111-4111-8111-111111111111',
values: [
{employeeId: 'employee-avery', date: '2026-01-05', value: 5},
{email: 'morgan@example.test', date: '2026-01-05', value: 3}
]
})
};
fetch('https://api.gowindmill.com/api/v2/c/{companyId}/stats/values', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gowindmill.com/api/v2/c/{companyId}/stats/values",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'statMetadataId' => '11111111-1111-4111-8111-111111111111',
'values' => [
[
'employeeId' => 'employee-avery',
'date' => '2026-01-05',
'value' => 5
],
[
'email' => 'morgan@example.test',
'date' => '2026-01-05',
'value' => 3
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.gowindmill.com/api/v2/c/{companyId}/stats/values"
payload := strings.NewReader("{\n \"statMetadataId\": \"11111111-1111-4111-8111-111111111111\",\n \"values\": [\n {\n \"employeeId\": \"employee-avery\",\n \"date\": \"2026-01-05\",\n \"value\": 5\n },\n {\n \"email\": \"morgan@example.test\",\n \"date\": \"2026-01-05\",\n \"value\": 3\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.gowindmill.com/api/v2/c/{companyId}/stats/values")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"statMetadataId\": \"11111111-1111-4111-8111-111111111111\",\n \"values\": [\n {\n \"employeeId\": \"employee-avery\",\n \"date\": \"2026-01-05\",\n \"value\": 5\n },\n {\n \"email\": \"morgan@example.test\",\n \"date\": \"2026-01-05\",\n \"value\": 3\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gowindmill.com/api/v2/c/{companyId}/stats/values")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"statMetadataId\": \"11111111-1111-4111-8111-111111111111\",\n \"values\": [\n {\n \"employeeId\": \"employee-avery\",\n \"date\": \"2026-01-05\",\n \"value\": 5\n },\n {\n \"email\": \"morgan@example.test\",\n \"date\": \"2026-01-05\",\n \"value\": 3\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"updated": 1
}{
"error": {
"code": "BAD_REQUEST",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "CONFLICT",
"message": "<string>",
"requestId": "<string>",
"details": [
{
"path": [
"<string>"
],
"message": "<string>",
"resourceId": "<string>"
}
]
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "<string>",
"requestId": "<string>"
}
}Upload custom employee stat values
Creates or replaces up to 1000 dated employee values for one workspace custom stat definition. Create the definition first, then send its ID and employee values. Identify each employee by employeeId or by email; an email matches the employee’s primary or secondary emails. The definition’s aggregation type determines how values are interpreted. Repeating the same employee, date, and optional dimension replaces that value, so retries never add to totals. Omitted values are preserved. Different dimensions contribute separately to the combined daily value. The entire request succeeds or fails together. Disabled or archived definitions cannot receive values. Missing or out-of-workspace definitions, employee IDs, and emails return 404; identifiers reserved for Windmill-managed stats return 409. Read uploaded values through stat series, employee totals, or CSV export using the caller’s analytics access.
curl --request PUT \
--url https://api.gowindmill.com/api/v2/c/{companyId}/stats/values \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"statMetadataId": "11111111-1111-4111-8111-111111111111",
"values": [
{
"employeeId": "employee-avery",
"date": "2026-01-05",
"value": 5
},
{
"email": "morgan@example.test",
"date": "2026-01-05",
"value": 3
}
]
}
'import requests
url = "https://api.gowindmill.com/api/v2/c/{companyId}/stats/values"
payload = {
"statMetadataId": "11111111-1111-4111-8111-111111111111",
"values": [
{
"employeeId": "employee-avery",
"date": "2026-01-05",
"value": 5
},
{
"email": "morgan@example.test",
"date": "2026-01-05",
"value": 3
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
statMetadataId: '11111111-1111-4111-8111-111111111111',
values: [
{employeeId: 'employee-avery', date: '2026-01-05', value: 5},
{email: 'morgan@example.test', date: '2026-01-05', value: 3}
]
})
};
fetch('https://api.gowindmill.com/api/v2/c/{companyId}/stats/values', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gowindmill.com/api/v2/c/{companyId}/stats/values",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'statMetadataId' => '11111111-1111-4111-8111-111111111111',
'values' => [
[
'employeeId' => 'employee-avery',
'date' => '2026-01-05',
'value' => 5
],
[
'email' => 'morgan@example.test',
'date' => '2026-01-05',
'value' => 3
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.gowindmill.com/api/v2/c/{companyId}/stats/values"
payload := strings.NewReader("{\n \"statMetadataId\": \"11111111-1111-4111-8111-111111111111\",\n \"values\": [\n {\n \"employeeId\": \"employee-avery\",\n \"date\": \"2026-01-05\",\n \"value\": 5\n },\n {\n \"email\": \"morgan@example.test\",\n \"date\": \"2026-01-05\",\n \"value\": 3\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.gowindmill.com/api/v2/c/{companyId}/stats/values")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"statMetadataId\": \"11111111-1111-4111-8111-111111111111\",\n \"values\": [\n {\n \"employeeId\": \"employee-avery\",\n \"date\": \"2026-01-05\",\n \"value\": 5\n },\n {\n \"email\": \"morgan@example.test\",\n \"date\": \"2026-01-05\",\n \"value\": 3\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gowindmill.com/api/v2/c/{companyId}/stats/values")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"statMetadataId\": \"11111111-1111-4111-8111-111111111111\",\n \"values\": [\n {\n \"employeeId\": \"employee-avery\",\n \"date\": \"2026-01-05\",\n \"value\": 5\n },\n {\n \"email\": \"morgan@example.test\",\n \"date\": \"2026-01-05\",\n \"value\": 3\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"updated": 1
}{
"error": {
"code": "BAD_REQUEST",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "CONFLICT",
"message": "<string>",
"requestId": "<string>",
"details": [
{
"path": [
"<string>"
],
"message": "<string>",
"resourceId": "<string>"
}
]
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "<string>",
"requestId": "<string>"
}
}Authorizations
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.
Authorization: Bearer wm_api_example
OAuth access tokens are issued for connected Windmill applications.
Authorization: Bearer <OAUTH_ACCESS_TOKEN>
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
Body
Was this page helpful?