---
title: "Session ratings"
description: "Create and update session ratings with complete curl request examples."
lastModified: "2026-08-25"
---

**Collection path:** `events/{event_id}/session-ratings`

| Input | Type | POST | PATCH | Notes |
| :---- | :---- | ----: | ----: | :---- |
| `simple_rateable_id` | Scalar ID | Required for a successful create | Rejected if supplied | Session must belong to the event. |
| `registrant_id` | Scalar ID | Required for a successful create | Rejected if supplied | Registrant must belong to the event and have a Brella user. |
| `score` | Integer | Required by the model | Optional | `0` represents skipped; accepted range is `0` to `50`. |
| `comment` | Scalar string or `null` | Optional | Optional | Rating comment. |

## POST a session rating

POST is an upsert for the session and registrant pair.

```shell
curl --request POST \
  --url "${BRELLA_API_BASE_URL}/api/core/organizations/${BRELLA_ORGANIZATION_ID}/events/${BRELLA_EVENT_ID}/session-ratings" \
  --header "Accept: application/vnd.brella.v4+json" \
  --header "Brella-API-Access-Token: ${BRELLA_API_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "simple_rateable_id": 5501,
    "registrant_id": 1201,
    "score": 4,
    "comment": "Good session"
  }'
```

The response type is `session-rating`. Useful write-response fields include `simple_rateable_id` (returned as `session-id`), `registrant_id`, `score`, `comment`, and `skipped`.

## PATCH a session rating

```shell
curl --request PATCH \
  --url "${BRELLA_API_BASE_URL}/api/core/organizations/${BRELLA_ORGANIZATION_ID}/events/${BRELLA_EVENT_ID}/session-ratings/9301" \
  --header "Accept: application/vnd.brella.v4+json" \
  --header "Brella-API-Access-Token: ${BRELLA_API_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "score": 5,
    "comment": "Excellent after the final discussion"
  }'
```

Do not send `simple_rateable_id` or `registrant_id` on PATCH; the mutation explicitly rejects changing the session or rater identity.
