curl --request POST \
--url https://api.gowindmill.com/api/v2/c/{companyId}/field-sources/resolve \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"employeeIds": [
"employee-avery"
],
"fieldKeys": [
"jobTitle"
]
}
'import requests
url = "https://api.gowindmill.com/api/v2/c/{companyId}/field-sources/resolve"
payload = {
"employeeIds": ["employee-avery"],
"fieldKeys": ["jobTitle"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({employeeIds: ['employee-avery'], fieldKeys: ['jobTitle']})
};
fetch('https://api.gowindmill.com/api/v2/c/{companyId}/field-sources/resolve', 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}/field-sources/resolve",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'employeeIds' => [
'employee-avery'
],
'fieldKeys' => [
'jobTitle'
]
]),
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}/field-sources/resolve"
payload := strings.NewReader("{\n \"employeeIds\": [\n \"employee-avery\"\n ],\n \"fieldKeys\": [\n \"jobTitle\"\n ]\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.gowindmill.com/api/v2/c/{companyId}/field-sources/resolve")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"employeeIds\": [\n \"employee-avery\"\n ],\n \"fieldKeys\": [\n \"jobTitle\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gowindmill.com/api/v2/c/{companyId}/field-sources/resolve")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"employeeIds\": [\n \"employee-avery\"\n ],\n \"fieldKeys\": [\n \"jobTitle\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"resolutions": [
{
"employeeId": "employee-avery",
"fieldKey": "jobTitle",
"source": "bamboo-hr",
"isSyncing": false
}
]
}{
"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": "RATE_LIMITED",
"message": "<string>",
"requestId": "<string>"
}
}Resolve effective employee field sources
Returns the source that owns each requested employee field. An employee override takes precedence over the company default; fields with neither are omitted. Accepts up to 1000 employee IDs and 100 field keys. Repeated inputs are processed once in first-seen order. Every employee ID must belong to the company or the whole request returns 404. Omit fieldKeys to resolve all supported fields; an empty array for either input returns no results. isSyncing is true when Windmill can refresh the connected source and the latest saved field value has not been confirmed by that source. It does not indicate whether a sync job is running. This read does not start a sync or return employee field values. Requires permission to manage employee field sources (employees.manage_field_mappings).
curl --request POST \
--url https://api.gowindmill.com/api/v2/c/{companyId}/field-sources/resolve \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"employeeIds": [
"employee-avery"
],
"fieldKeys": [
"jobTitle"
]
}
'import requests
url = "https://api.gowindmill.com/api/v2/c/{companyId}/field-sources/resolve"
payload = {
"employeeIds": ["employee-avery"],
"fieldKeys": ["jobTitle"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({employeeIds: ['employee-avery'], fieldKeys: ['jobTitle']})
};
fetch('https://api.gowindmill.com/api/v2/c/{companyId}/field-sources/resolve', 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}/field-sources/resolve",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'employeeIds' => [
'employee-avery'
],
'fieldKeys' => [
'jobTitle'
]
]),
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}/field-sources/resolve"
payload := strings.NewReader("{\n \"employeeIds\": [\n \"employee-avery\"\n ],\n \"fieldKeys\": [\n \"jobTitle\"\n ]\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.gowindmill.com/api/v2/c/{companyId}/field-sources/resolve")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"employeeIds\": [\n \"employee-avery\"\n ],\n \"fieldKeys\": [\n \"jobTitle\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gowindmill.com/api/v2/c/{companyId}/field-sources/resolve")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"employeeIds\": [\n \"employee-avery\"\n ],\n \"fieldKeys\": [\n \"jobTitle\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"resolutions": [
{
"employeeId": "employee-avery",
"fieldKey": "jobTitle",
"source": "bamboo-hr",
"isSyncing": false
}
]
}{
"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": "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
Up to 100 field keys. Repeated keys are resolved once in first-seen order. Omit to inspect all supported field keys; an empty array resolves no fields.
100Employee profile field whose owning source is configured or resolved.
avatarUrl, dateOfBirth, departments, displayFullName, employmentStatus, employmentType, ethnicity, firstName, preferredName, gender, jobLevel, jobTitle, lastName, managerId, maritalStatus, phoneNumber, primaryEmail, pronouns, startDate, terminationDate, workLocation, country ["jobTitle"]
Was this page helpful?