curl --request PUT \
--url https://api.gowindmill.com/api/v2/c/{companyId}/stats/views/{id}/access \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"expectedVersion": 1,
"employeeAccess": [
{
"employeeId": "employee-avery",
"access": "read"
}
]
}
'import requests
url = "https://api.gowindmill.com/api/v2/c/{companyId}/stats/views/{id}/access"
payload = {
"expectedVersion": 1,
"employeeAccess": [
{
"employeeId": "employee-avery",
"access": "read"
}
]
}
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({
expectedVersion: 1,
employeeAccess: [{employeeId: 'employee-avery', access: 'read'}]
})
};
fetch('https://api.gowindmill.com/api/v2/c/{companyId}/stats/views/{id}/access', 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/views/{id}/access",
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([
'expectedVersion' => 1,
'employeeAccess' => [
[
'employeeId' => 'employee-avery',
'access' => 'read'
]
]
]),
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/views/{id}/access"
payload := strings.NewReader("{\n \"expectedVersion\": 1,\n \"employeeAccess\": [\n {\n \"employeeId\": \"employee-avery\",\n \"access\": \"read\"\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/views/{id}/access")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"expectedVersion\": 1,\n \"employeeAccess\": [\n {\n \"employeeId\": \"employee-avery\",\n \"access\": \"read\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gowindmill.com/api/v2/c/{companyId}/stats/views/{id}/access")
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 \"expectedVersion\": 1,\n \"employeeAccess\": [\n {\n \"employeeId\": \"employee-avery\",\n \"access\": \"read\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"view": {
"id": "22222222-2222-4222-8222-222222222222",
"version": 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>"
}
}Set stat view access
Replaces all recipient grants on a saved view owned by the caller. Omitted audiences reset to no access, so include grants that should remain. Recipient access is read-only; the owner’s write access is preserved. Employees and readable groups must belong to the workspace. A team grant may target only the owner’s reporting team, and the owner must have a direct report. Changing workspace-wide or all-manager access, including removing it, requires permission to share analytics views workspace-wide. Supply expectedVersion for changes; a stale version returns 409. An identical sharing configuration returns the current version without incrementing it. Sharing with automations or by capability is unsupported. Requires access to Analytics in the workspace. Sharing a view shares its saved selections; each viewer can still read only the employee stats their own permissions allow.
curl --request PUT \
--url https://api.gowindmill.com/api/v2/c/{companyId}/stats/views/{id}/access \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"expectedVersion": 1,
"employeeAccess": [
{
"employeeId": "employee-avery",
"access": "read"
}
]
}
'import requests
url = "https://api.gowindmill.com/api/v2/c/{companyId}/stats/views/{id}/access"
payload = {
"expectedVersion": 1,
"employeeAccess": [
{
"employeeId": "employee-avery",
"access": "read"
}
]
}
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({
expectedVersion: 1,
employeeAccess: [{employeeId: 'employee-avery', access: 'read'}]
})
};
fetch('https://api.gowindmill.com/api/v2/c/{companyId}/stats/views/{id}/access', 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/views/{id}/access",
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([
'expectedVersion' => 1,
'employeeAccess' => [
[
'employeeId' => 'employee-avery',
'access' => 'read'
]
]
]),
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/views/{id}/access"
payload := strings.NewReader("{\n \"expectedVersion\": 1,\n \"employeeAccess\": [\n {\n \"employeeId\": \"employee-avery\",\n \"access\": \"read\"\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/views/{id}/access")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"expectedVersion\": 1,\n \"employeeAccess\": [\n {\n \"employeeId\": \"employee-avery\",\n \"access\": \"read\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gowindmill.com/api/v2/c/{companyId}/stats/views/{id}/access")
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 \"expectedVersion\": 1,\n \"employeeAccess\": [\n {\n \"employeeId\": \"employee-avery\",\n \"access\": \"read\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"view": {
"id": "22222222-2222-4222-8222-222222222222",
"version": 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
Complete replacement of recipient grants, up to 32 KiB of JSON. Omitted audiences reset to no access. The owner's write access is always preserved.
Was this page helpful?