curl --request PATCH \
--url https://api.getoneprofile.ai/tables/{table_id}/columns/{column_id}/ui-prefs/ \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"hidden": true,
"pinned": true,
"width": 392
}
'import requests
url = "https://api.getoneprofile.ai/tables/{table_id}/columns/{column_id}/ui-prefs/"
payload = {
"hidden": True,
"pinned": True,
"width": 392
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({hidden: true, pinned: true, width: 392})
};
fetch('https://api.getoneprofile.ai/tables/{table_id}/columns/{column_id}/ui-prefs/', 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.getoneprofile.ai/tables/{table_id}/columns/{column_id}/ui-prefs/",
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([
'hidden' => true,
'pinned' => true,
'width' => 392
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$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.getoneprofile.ai/tables/{table_id}/columns/{column_id}/ui-prefs/"
payload := strings.NewReader("{\n \"hidden\": true,\n \"pinned\": true,\n \"width\": 392\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("X-API-Key", "<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.getoneprofile.ai/tables/{table_id}/columns/{column_id}/ui-prefs/")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"hidden\": true,\n \"pinned\": true,\n \"width\": 392\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getoneprofile.ai/tables/{table_id}/columns/{column_id}/ui-prefs/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"hidden\": true,\n \"pinned\": true,\n \"width\": 392\n}"
response = http.request(request)
puts response.read_body{
"color": "gray",
"hidden": true,
"pinned": true,
"width": 123
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>",
"issues": [
{
"input": "<string>",
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Update a column's display preferences
Partially update how one column is displayed: hidden, pinned, width, colour tint (omitted fields are left untouched). Hidden, pinned and width are the CALLING USER’s own: they change this person’s Default view and nobody else’s, over the team’s layout. The colour tint is shared by everyone in the organisation. A caller with no person behind it (an API key) sets the team’s layout. Cosmetic only: this never touches the column definition, never bumps the columns change watermark, and never requests a recompute run. A request that sets nothing is a no-op and leaves the preferences watermark unmoved. Answers with the column’s preferences as the caller now sees them.
curl --request PATCH \
--url https://api.getoneprofile.ai/tables/{table_id}/columns/{column_id}/ui-prefs/ \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"hidden": true,
"pinned": true,
"width": 392
}
'import requests
url = "https://api.getoneprofile.ai/tables/{table_id}/columns/{column_id}/ui-prefs/"
payload = {
"hidden": True,
"pinned": True,
"width": 392
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({hidden: true, pinned: true, width: 392})
};
fetch('https://api.getoneprofile.ai/tables/{table_id}/columns/{column_id}/ui-prefs/', 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.getoneprofile.ai/tables/{table_id}/columns/{column_id}/ui-prefs/",
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([
'hidden' => true,
'pinned' => true,
'width' => 392
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$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.getoneprofile.ai/tables/{table_id}/columns/{column_id}/ui-prefs/"
payload := strings.NewReader("{\n \"hidden\": true,\n \"pinned\": true,\n \"width\": 392\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("X-API-Key", "<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.getoneprofile.ai/tables/{table_id}/columns/{column_id}/ui-prefs/")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"hidden\": true,\n \"pinned\": true,\n \"width\": 392\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getoneprofile.ai/tables/{table_id}/columns/{column_id}/ui-prefs/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"hidden\": true,\n \"pinned\": true,\n \"width\": 392\n}"
response = http.request(request)
puts response.read_body{
"color": "gray",
"hidden": true,
"pinned": true,
"width": 123
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>",
"issues": [
{
"input": "<string>",
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Body
Request body for updating a column's display preferences (tri-state PATCH).
Semantic tint token, shared by a column and by a column GROUP.
Stored as a token rather than a hex value because the grid renders in both a light and a dark theme, and a single stored colour is only legible in one of them. The client maps each token to a per-mode value.
Deliberately excludes teal: the brand primary is used for range selection and the anchor outline, so a teal column would read as permanently selected.
Lives HERE rather than in table_column_prefs, where it started, because
two domains now need it and the layering only allows one direction. A
column's tint is stored in table_column_prefs (org-shared appearance,
keyed by column) while a group's is a field on the group row itself in
table_column, and table_column_prefs sits ABOVE table_column in
the domain layers, so the token had to move DOWN to be reachable from both.
table_column_prefs.types re-exports it, which is why that move touched
no existing import.
One enum for both on purpose: a colour token is a shared vocabulary (a team
agreeing that amber means "needs review" is agreeing about it across
columns and groups alike) and the organisation's renaming of the palette
(table_column_color_labels) is keyed by this token, so a second enum
would give groups colours the rename dialog could not name.
gray, red, orange, amber, green, blue, purple, pink Response
Successful Response
How one column is displayed to the caller.
Hidden, pinned and width are the caller's own where they set one, laid over the team's; the colour tint is the team's. An API key sees the team's alone. Always present on a column, whether or not anything has been customised: a column nobody has touched reports the defaults rather than null.
Was this page helpful?