> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# CES API

> Read Customer Effort Score responses and manage CES survey settings for your organization, with independent session scores and scoped API access.

CES responses use a **1–5, higher is easier** scale. Configure delivery in [Settings → Surveys](https://docs.open.cx/resources/surveys.md) or through the settings API. Workflows provide Send Request, Generate Link, Get Score and Cancel Request actions.

All reads below require `ces:read` or `ces:write`; updating settings requires `ces:write`. Existing `csat:*` keys do not grant CES access. Scores are scoped to the authenticated organization and survey type. A session can have separate CSAT, NPS and CES responses.

| Operation | Endpoint |
| - | - |
| [List scores](https://docs.open.cx/api-reference/ces/get_all.md) | `GET /ces/scores` |
| [Get a score](https://docs.open.cx/api-reference/ces/get.md) | `GET /ces/scores/{score_id}` |
| [Get a session’s score](https://docs.open.cx/api-reference/ces/get_session.md) | `GET /ces/scores/session/{session_id}` |
| [Check channel eligibility](https://docs.open.cx/api-reference/ces/check_channel.md) | `GET /ces/settings/channel/{channel}` |
| [Check whether sent](https://docs.open.cx/api-reference/ces/check_sent.md) | `GET /ces/sessions/{session_id}/sent` |
| [Read settings](https://docs.open.cx/api-reference/ces/get-settings.md) | `GET /ces/settings` |
| [Update settings](https://docs.open.cx/api-reference/ces/update-settings.md) | `PATCH /ces/settings` |

The sent-status response uses `ces_sent`. Score records include the latest rating and comment, session, contact, and agent/team attribution fixed at first submission. Score reads do not send a survey.

Settings updates are partial. Setting `auto_send_on_close` to `true` selects CES and turns automatic sending off for the other types. Setting it to `false` only disables CES. An omitted property stays unchanged. Template fields clear on null or an empty string; a null template uses the default design. Custom page controls retain the `data-csat-*` and `OpenCX.csat.submit` names.

MCP provides `list_ces_scores`, `get_ces_score`, `get_session_ces`, `get_ces_settings` and `update_ces_settings`. Its settings tool edits templates and the question; use the dashboard or REST settings API for other controls.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.