---
title: "/:channel"
method: PUT
path: "/sessions/{channel}"
tags: ["sessions"]
---

# /:channel

`PUT /sessions/{channel}`

## Request

- Base URL: `https://api.streamelements.com/kappa/v2`
- URL: `https://api.streamelements.com/kappa/v2/sessions/{channel}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://api.streamelements.com/oauth2/authorize`
    - Token URL: `https://api.streamelements.com/oauth2/token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/streamelements/apis/se-api-docs/docs/sessions/:channel/put.ts> (a function with typed inputs; its response is checked against the schema)

Update session data

## Path parameters

- `channel` string, required

## Request body

- object

## Response `200`

- ChannelData
  - `data` SessionData, required
    - `follower-latest` FollowerLatest, required
      - `name` string, required
    - `follower-session` Count, required
      - `count` integer, required
    - `follower-week` Count, required
      - `count` integer, required
    - `follower-month` Count, required
      - `count` integer, required
    - `follower-goal` Amount, required
      - `amount` integer, required
    - `follower-total` Count, required
      - `count` integer, required
    - `subscriber-latest` SubscriberLatest, required
      - `name` string, required
      - `amount` integer, required
      - `tier` string, required
      - `message` string, required
      - `sender` string, nullable, required
      - `gifted` string, nullable, required
    - `subscriber-new-latest` SubscriberNewLatest, required
      - `name` string, required
      - `amount` integer, required
      - `message` string, required
    - `subscriber-resub-latest` SubscriberResubLatest, required
      - `name` string, required
      - `amount` integer, required
      - `message` string, required
    - `subscriber-gifted-latest` SubscriberGiftedLatest, required
      - `name` string, required
      - `amount` integer, required
      - `message` string, required
    - `subscriber-session` Count, required
      - `count` integer, required
    - `subscriber-new-session` Count, required
      - `count` integer, required
    - `subscriber-resub-session` Count, required
      - `count` integer, required
    - `subscriber-gifted-session` Count, required
      - `count` integer, required
    - `subscriber-week` Count, required
      - `count` integer, required
    - `subscriber-month` Count, required
      - `count` integer, required
    - `subscriber-goal` Amount, required
      - `amount` integer, required
    - `subscriber-total` Count, required
      - `count` integer, required
    - `subscriber-points` Amount, required
      - `amount` integer, required
    - `subscriber-alltime-gifter` TopUserAmount, required
      - `name` string, required
      - `amount` integer, required
      - `message` string
    - `host-latest` AmountRecent, required
      - `name` string, required
      - `amount` integer, required
      - `createdAt` string
    - `raid-latest` AmountRecent, required
      - `name` string, required
      - `amount` integer, required
      - `createdAt` string
    - `cheer-session` Amount, required
      - `amount` integer, required
    - `cheer-week` Amount, required
      - `amount` integer, required
    - `cheer-month` Amount, required
      - `amount` integer, required
    - `cheer-total` Amount, required
      - `amount` integer, required
    - `cheer-count` Count, required
      - `count` integer, required
    - `cheer-goal` Amount, required
      - `amount` integer, required
    - `cheer-latest` CheerLatest, required
      - `name` string, required
      - `amount` integer, required
      - `message` string, required
    - `cheer-session-top-donation` TopUserAmount, required
      - `name` string, required
      - `amount` integer, required
      - `message` string
    - `cheer-weekly-top-donation` TopUserAmount, required
      - `name` string, required
      - `amount` integer, required
      - `message` string
    - `cheer-monthly-top-donation` TopUserAmount, required
      - `name` string, required
      - `amount` integer, required
      - `message` string
    - `cheer-alltime-top-donation` TopUserAmount, required
      - `name` string, required
      - `amount` integer, required
      - `message` string
    - `cheer-session-top-donator` TopUserAmount, required
      - `name` string, required
      - `amount` integer, required
      - `message` string
    - `cheer-weekly-top-donator` TopUserAmount, required
      - `name` string, required
      - `amount` integer, required
      - `message` string
    - `cheer-monthly-top-donator` TopUserAmount, required
      - `name` string, required
      - `amount` integer, required
      - `message` string
    - `cheer-alltime-top-donator` TopUserAmount, required
      - `name` string, required
      - `amount` integer, required
      - `message` string
    - `tip-latest` TipLatest, required
      - `name` string, required
      - `amount` integer, required
      - `message` string, required
    - `tip-session-top-donation` TopUserAmount, required
      - `name` string, required
      - `amount` integer, required
      - `message` string
    - `tip-weekly-top-donation` TopUserAmount, required
      - `name` string, required
      - `amount` integer, required
      - `message` string
    - `tip-monthly-top-donation` TopUserAmount, required
      - `name` string, required
      - `amount` integer, required
      - `message` string
    - `tip-alltime-top-donation` TopUserAmount, required
      - `name` string, required
      - `amount` integer, required
      - `message` string
    - `tip-session-top-donator` TopUserAmount, required
      - `name` string, required
      - `amount` integer, required
      - `message` string
    - `tip-weekly-top-donator` TopUserAmount, required
      - `name` string, required
      - `amount` integer, required
      - `message` string
    - `tip-monthly-top-donator` TopUserAmount, required
      - `name` string, required
      - `amount` integer, required
      - `message` string
    - `tip-alltime-top-donator` TopUserAmount, required
      - `name` string, required
      - `amount` integer, required
      - `message` string
    - `tip-session` Amount, required
      - `amount` integer, required
    - `tip-week` Amount, required
      - `amount` integer, required
    - `tip-month` Amount, required
      - `amount` integer, required
    - `tip-total` Amount, required
      - `amount` integer, required
    - `tip-count` Count, required
      - `count` integer, required
    - `tip-goal` Amount, required
      - `amount` integer, required
    - `merch-goal-orders` Amount, required
      - `amount` integer, required
    - `merch-goal-items` Amount, required
      - `amount` integer, required
    - `merch-goal-total` Amount, required
      - `amount` integer, required
    - `follower-recent` FollowerRecent[], required
      - `name` string, required
      - `createdAt` string, required
    - `subscriber-recent` SubscriberRecent[], required
      - `name` string, required
      - `tier` string, required
      - `amount` integer, required
      - `createdAt` string, required
    - `host-recent` AmountRecent[], required
      - `name` string, required
      - `amount` integer, required
      - `createdAt` string
    - `raid-recent` AmountRecent[], required
      - `name` string, required
      - `amount` integer, required
      - `createdAt` string
    - `cheer-recent` AmountRecent[], required
      - `name` string, required
      - `amount` integer, required
      - `createdAt` string
    - `tip-recent` AmountRecent[], required
      - `name` string, required
      - `amount` integer, required
      - `createdAt` string
    - `merch-recent` AmountRecent[], required
      - `name` string, required
      - `amount` integer, required
      - `createdAt` string
  - `settings` SessionSettings, required
    - `autoReset` boolean, required
    - `calendar` boolean, required
  - `provider` string, required
  - `lastReset` string, required
  - `_id` string, required
  - `channel` string, required
  - `createdAt` string, required
  - `updatedAt` string, required
  - `__v` integer, required

## Changes

- **2021-02-22** `51e3df32da57`: 9 info
  - added the required property `__v` to the response with the `200` status
  - added the required property `_id` to the response with the `200` status
  - added the required property `channel` to the response with the `200` status
  - added the required property `createdAt` to the response with the `200` status
  - …5 more
- **2021-02-07** `8c745ed2e9e4`: 11 warning
  - the optional response header `Access-Control-Allow-Credentials` removed for the status `200`
  - the optional response header `Access-Control-Expose-Headers` removed for the status `200`
  - the optional response header `ETag` removed for the status `200`
  - the optional response header `Server` removed for the status `200`
  - …7 more

[Operation history](https://skmtc.dev/streamelements/apis/se-api-docs/changes/sessions/:channel/put.md)

---

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