curl --request PUT \
--url https://api.gowindmill.com/api/v2/c/{companyId}/employees/{employeeId}/field-sources/{fieldKey} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"source": "manual"
}
'import requests
url = "https://api.gowindmill.com/api/v2/c/{companyId}/employees/{employeeId}/field-sources/{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}/employees/{employeeId}/field-sources/{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}/employees/{employeeId}/field-sources/{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}/employees/{employeeId}/field-sources/{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}/employees/{employeeId}/field-sources/{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}/employees/{employeeId}/field-sources/{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": "manual",
"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 an employee field source override
Sets the source for one employee field, taking precedence over the company default.
- First call GET /c//field-sources/available-sources to choose a source that supports the field. New integration assignments require a connected source; manual is always available.
- This request is idempotent: repeating the saved source returns the unchanged configuration without requesting another refresh, even after disconnection.
- This saves ownership, not a field value. To enter a value yourself, select manual, then use PATCH /c//employees/ for a field accepted by that operation’s request schema. For example, set jobTitle to manual, then PATCH
{"jobTitle":"Senior Engineer"}. Manual ownership does not make every field writable. - Updating the value separately requires permission to manage employee profiles (
org_chart.manage). - 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. The response contains configuration only.
The employee must exist in the company. Requires permission to manage employee field sources (employees.manage_field_mappings).
curl --request PUT \
--url https://api.gowindmill.com/api/v2/c/{companyId}/employees/{employeeId}/field-sources/{fieldKey} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"source": "manual"
}
'import requests
url = "https://api.gowindmill.com/api/v2/c/{companyId}/employees/{employeeId}/field-sources/{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}/employees/{employeeId}/field-sources/{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}/employees/{employeeId}/field-sources/{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}/employees/{employeeId}/field-sources/{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}/employees/{employeeId}/field-sources/{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}/employees/{employeeId}/field-sources/{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": "manual",
"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?