curl --request PATCH \
--url https://api.attention.tech/v2/field-configurations/{id} \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Renamed Discovery Questions",
"teamsUUID": [
"fe515723-fe2e-4959-a5fa-c4d3937fe7e4"
]
}
'import requests
url = "https://api.attention.tech/v2/field-configurations/{id}"
payload = {
"name": "Renamed Discovery Questions",
"teamsUUID": ["fe515723-fe2e-4959-a5fa-c4d3937fe7e4"]
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Renamed Discovery Questions',
teamsUUID: ['fe515723-fe2e-4959-a5fa-c4d3937fe7e4']
})
};
fetch('https://api.attention.tech/v2/field-configurations/{id}', 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.attention.tech/v2/field-configurations/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Renamed Discovery Questions',
'teamsUUID' => [
'fe515723-fe2e-4959-a5fa-c4d3937fe7e4'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"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.attention.tech/v2/field-configurations/{id}"
payload := strings.NewReader("{\n \"name\": \"Renamed Discovery Questions\",\n \"teamsUUID\": [\n \"fe515723-fe2e-4959-a5fa-c4d3937fe7e4\"\n ]\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "<api-key>")
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.patch("https://api.attention.tech/v2/field-configurations/{id}")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Renamed Discovery Questions\",\n \"teamsUUID\": [\n \"fe515723-fe2e-4959-a5fa-c4d3937fe7e4\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.attention.tech/v2/field-configurations/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Renamed Discovery Questions\",\n \"teamsUUID\": [\n \"fe515723-fe2e-4959-a5fa-c4d3937fe7e4\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"uuid": "b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11",
"name": "Enterprise Discovery Questions",
"organizationUUID": "16b78cec-82ef-46d2-8213-5d3bb7d2571c",
"teamsUUID": [
"fe515723-fe2e-4959-a5fa-c4d3937fe7e4"
],
"allTeams": false,
"isDefaultTemplate": false
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}Update Field Configuration
Partially updates a field configuration. Only properties present on the body are modified (PATCH semantics). Field configurations belonging to other organizations return 404.
curl --request PATCH \
--url https://api.attention.tech/v2/field-configurations/{id} \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Renamed Discovery Questions",
"teamsUUID": [
"fe515723-fe2e-4959-a5fa-c4d3937fe7e4"
]
}
'import requests
url = "https://api.attention.tech/v2/field-configurations/{id}"
payload = {
"name": "Renamed Discovery Questions",
"teamsUUID": ["fe515723-fe2e-4959-a5fa-c4d3937fe7e4"]
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Renamed Discovery Questions',
teamsUUID: ['fe515723-fe2e-4959-a5fa-c4d3937fe7e4']
})
};
fetch('https://api.attention.tech/v2/field-configurations/{id}', 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.attention.tech/v2/field-configurations/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Renamed Discovery Questions',
'teamsUUID' => [
'fe515723-fe2e-4959-a5fa-c4d3937fe7e4'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"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.attention.tech/v2/field-configurations/{id}"
payload := strings.NewReader("{\n \"name\": \"Renamed Discovery Questions\",\n \"teamsUUID\": [\n \"fe515723-fe2e-4959-a5fa-c4d3937fe7e4\"\n ]\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "<api-key>")
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.patch("https://api.attention.tech/v2/field-configurations/{id}")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Renamed Discovery Questions\",\n \"teamsUUID\": [\n \"fe515723-fe2e-4959-a5fa-c4d3937fe7e4\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.attention.tech/v2/field-configurations/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Renamed Discovery Questions\",\n \"teamsUUID\": [\n \"fe515723-fe2e-4959-a5fa-c4d3937fe7e4\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"uuid": "b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11",
"name": "Enterprise Discovery Questions",
"organizationUUID": "16b78cec-82ef-46d2-8213-5d3bb7d2571c",
"teamsUUID": [
"fe515723-fe2e-4959-a5fa-c4d3937fe7e4"
],
"allTeams": false,
"isDefaultTemplate": false
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}Authorizations
Path Parameters
UUID of the field configuration.
Body
Fields to update on the configuration.
Request payload for updating a field configuration. Uses PATCH semantics - only fields present in the body are updated; omitted fields are left unchanged.
New human-readable name. When present, trimmed; 1-128 characters.
"Renamed Discovery Questions"
Replacement list of team UUIDs this configuration is assigned to. When omitted, existing assignments are preserved.
["fe515723-fe2e-4959-a5fa-c4d3937fe7e4"]
When present, sets whether the configuration applies to every team in the organization.
false
Criteria expression that controls when this field configuration applies. Conditions are combined using the specified boolean operator.
Show child attributes
Show child attributes
{
"conditions": [
{
"field": "account.industry",
"value": "technology"
}
],
"operator": "AND"
}
Response
Field configuration successfully updated.
Envelope containing a single field configuration.
A Field Configuration (internally IntelligenceItemCollection) groups a set of intelligence items that are surfaced together for the teams it is assigned to. Field Configurations are scoped to a single organization.
Show child attributes
Show child attributes
{
"uuid": "b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11",
"name": "Enterprise Discovery Questions",
"organizationUUID": "16b78cec-82ef-46d2-8213-5d3bb7d2571c",
"teamsUUID": ["fe515723-fe2e-4959-a5fa-c4d3937fe7e4"],
"allTeams": false,
"isDefaultTemplate": false,
"criteria": {
"conditions": [
{
"field": "account.industry",
"value": "technology"
}
],
"operator": "AND"
},
"createdAt": "2026-03-01T12:00:00Z"
}
Was this page helpful?