curl --request PUT \
--url https://api.gowindmill.com/api/v2/c/{companyId}/field-sources/defaults/{fieldKey} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"source": "manual"
}
'import requests
url = "https://api.gowindmill.com/api/v2/c/{companyId}/field-sources/defaults/{fieldKey}"
payload = { "source": "manual" }
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({source: 'manual'})
};
fetch('https://api.gowindmill.com/api/v2/c/{companyId}/field-sources/defaults/{fieldKey}', 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/defaults/{fieldKey}",
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([
'source' => 'manual'
]),
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/defaults/{fieldKey}"
payload := strings.NewReader("{\n \"source\": \"manual\"\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}/field-sources/defaults/{fieldKey}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"source\": \"manual\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gowindmill.com/api/v2/c/{companyId}/field-sources/defaults/{fieldKey}")
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 \"source\": \"manual\"\n}"
response = http.request(request)
puts response.read_body{
"config": {
"id": "field-config-job-title",
"companyId": "company-acme",
"employeeId": "employee-avery",
"fieldKey": "jobTitle",
"source": "bamboo-hr",
"createdAt": "2026-01-15T10:00:00.000Z",
"updatedAt": "2026-01-15T10:00:00.000Z"
}
}{
"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>"
}
}Set a company employee field source
Sets the company default source for the field in the URL. Existing employee overrides take precedence and are retained. A new source must be connected and support this field; manual is always available. Repeating the saved source returns the unchanged configuration, even after disconnection. This changes which source owns the field; it does not set an employee field value. When the selected source supports refresh, Windmill requests updated integration data in the background. A successful response confirms the ownership change, not that employee values have refreshed. Requires permission to manage employee field sources (employees.manage_field_mappings).
curl --request PUT \
--url https://api.gowindmill.com/api/v2/c/{companyId}/field-sources/defaults/{fieldKey} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"source": "manual"
}
'import requests
url = "https://api.gowindmill.com/api/v2/c/{companyId}/field-sources/defaults/{fieldKey}"
payload = { "source": "manual" }
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({source: 'manual'})
};
fetch('https://api.gowindmill.com/api/v2/c/{companyId}/field-sources/defaults/{fieldKey}', 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/defaults/{fieldKey}",
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([
'source' => 'manual'
]),
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/defaults/{fieldKey}"
payload := strings.NewReader("{\n \"source\": \"manual\"\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}/field-sources/defaults/{fieldKey}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"source\": \"manual\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gowindmill.com/api/v2/c/{companyId}/field-sources/defaults/{fieldKey}")
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 \"source\": \"manual\"\n}"
response = http.request(request)
puts response.read_body{
"config": {
"id": "field-config-job-title",
"companyId": "company-acme",
"employeeId": "employee-avery",
"fieldKey": "jobTitle",
"source": "bamboo-hr",
"createdAt": "2026-01-15T10:00:00.000Z",
"updatedAt": "2026-01-15T10:00:00.000Z"
}
}{
"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
Employee 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"
Body
An owning source. New assignments require a connected source supporting the field. Manual is always available; SCIM requires enabled provisioning.
manual, scim, slack, google-workspace, google-workspace-individual, outlook-calendar, adp-workforce-now, bamboo-hr, charthop, darwinbox, dayforce, deel, gusto, hibob, humaans, just-works, oracle-hcm, paylocity, rippling, trinet, ukg-pro, workday "manual"
Was this page helpful?