---
title: "Update Calls Page Settings"
method: PATCH
path: "/developer/calls-page-settings"
tags: ["Developer", "Developer - Settings"]
---

# Update Calls Page Settings

`PATCH /developer/calls-page-settings`

## Request

- Base URL: `https://api.openintake.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openintake.ai/developer/calls-page-settings`
- Auth: none declared

Update the calls page settings for the current customer.

This endpoint is restricted to developer users only.
Updates which columns and metrics are displayed on the calls page.

- **enabled_columns**: List of column identifiers to display (in order)
- **enabled_metrics**: List of metric card identifiers to display

## Request body

- UpdateCallsPageSettingsRequest: Update calls page settings request model
  - `hide_zero_duration_calls` boolean, nullable: Hide finished zero-second calls from dashboard lists and call counts
  - `enabled_columns` CallsPageColumnEnum[], nullable: List of enabled column identifiers in display order
  - `filterable_columns` CallsPageColumnEnum[], nullable: Column identifiers the customer may filter on (enabled columns are always filterable)
  - `absolute_call_times` boolean, nullable: Show real clock times instead of relative ages
  - `time_of_day_filter_enabled` boolean, nullable: Whether the date filter offers a time-of-day range as well as whole days
  - `enabled_metrics` CallsPageMetricEnum[], nullable: List of enabled metric card identifiers

## Response `200`

Successful Response

- CallsPageSettingsResponse: Calls page settings response model
  - `customer_id` string, uuid, required
  - `hide_zero_duration_calls` boolean, required: Hide finished zero-second calls from dashboard lists and call counts
  - `enabled_columns` CallsPageColumnEnum[], required: List of enabled column identifiers in display order
  - `filterable_columns` CallsPageColumnEnum[], required: Column identifiers the customer may filter on. Always includes the enabled columns (their headers carry the filter); extra entries are filters for columns that aren't displayed, which the Calls page reveals while the filter is applied
  - `absolute_call_times` boolean, required: Show real clock times instead of relative ages — a time for today's calls, a date and time for older ones
  - `time_of_day_filter_enabled` boolean, required: Whether the date filter offers a time-of-day range as well as whole days
  - `enabled_metrics` CallsPageMetricEnum[], required: List of enabled metric card identifiers

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-15** `cccd8c55d2fd`: 2 warning, 2 info
  - added the new `line` enum value to the `enabled_columns/items/` response property for the response status `200`
  - added the new `line` enum value to the `filterable_columns/items/` response property for the response status `200`
  - added the new `line` enum value to the request property `enabled_columns/anyOf[subschema #1]/items/`
  - added the new `line` enum value to the request property `filterable_columns/anyOf[subschema #1]/items/`
- **2026-09-14** `2a47b07c930e`: 2 info
  - added the new optional request property `hide_zero_duration_calls`
  - added the required property `hide_zero_duration_calls` to the response with the `200` status
- **2026-09-11** `546117b4e7b4`: 2 warning, 8 info
  - added the new `assigned_team` enum value to the `enabled_columns/items/` response property for the response status `200`
  - added the new `transferred_to` enum value to the `enabled_columns/items/` response property for the response status `200`
  - added the new optional request property `absolute_call_times`
  - added the new optional request property `filterable_columns`
  - …6 more

[Operation history](https://skmtc.dev/openintake/apis/openintake-api/changes/developer/calls-page-settings/patch.md)

---

[API](https://skmtc.dev/openintake/apis/openintake-api.md) - [All operations](https://skmtc.dev/openintake/apis/openintake-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openintake/apis/openintake-api/revisions/de90a8dcbc07?raw)
