---
title: "Update an existing session"
method: PUT
path: "/v1/events/{eventId}/sessions/{sessionId}"
tags: ["Sessions"]
---

# Update an existing session

`PUT /v1/events/{eventId}/sessions/{sessionId}`

Use this endpoint to update an existing session for a specific event type in your Zuddl organization.

Required API key scopes: `WRITE`

**This API can only be called with an access key that was generated for Backend usage.**

## Path parameters

- `eventId` string, required
- `sessionId` string, required

## Request body

- OrgEventsAppDomainApiProductEventSessionDtosSessionCreateUpdateRequest
  - `title` string, required — Title of the session
  - `description` string — Description of the session
  - `startDateTime` string, date-time, required — Start date time of the session
  - `endDateTime` string, date-time, required — End date time of the session.
  - `locationId` string, uuid — ID of the in-person location for the session
  - `availableSpots` integer — **Deprecated**: use `totalCapacity` instead. Available Spots for an In-person session.
  - `totalCapacity` integer — Total capacity configured for the session. Applies to in-person and hybrid sessions; ignored for virtual sessions. Takes precedence over the deprecated `availableSpots` if both are provided.
  - `externalRefId` string — A reference ID that you can use to map this session to your external systems or databases
  - `parentSessionId` string — Parent session ID of the session
  - `tags` string[] — Tags for the session

## Response `200`

Session updated successfully

- OrgEventsAppDomainApiProductEventSessionDtosSessionDetails
  - `kind` string
  - `url` string, uri
  - `id` string, uuid — Unique identifier of the session
  - `title` string — Name of the session
  - `description` string — Description of the session
  - `startDateTime` string, date-time — Start date time of the session
  - `endDateTime` string, date-time — End date time of the session
  - `location` OrgEventsAppDomainApiProductEventSessionDtosSessionDetailsLocation[] — Location details of the session
    - `locationId` string, uuid — Unique identifier of the session location
    - `locationName` string — Name of the session location
    - `type` 'STAGE' | 'SESSION' | 'NETWORKING' | 'EXPO' | 'LOBBY' | 'SCHEDULE' | 'ROOMS' | 'IN_PERSON' | 'NONE' | 'STUDIO' — Type of the session venue
    - `link` string — Link of the session location
  - `speakers` OrgEventsAppDomainApiProductEventSessionDtosSessionDetailsSpeaker[] — Speakers of the session
    - `speakerId` string, uuid — Unique identifier of the session speaker
    - `url` string, uri — API URL to retrieve speaker details
  - `sponsors` OrgEventsAppDomainApiProductEventSessionDtosSessionDetailsSponsor[] — Sponsors of the session
    - `sponsorId` string, uuid — Unique identifier of the session sponsor
    - `url` string, uri — API URL to retrieve sponsor details
  - `tags` string[] — Tags of the session
  - `files` OrgEventsAppDomainApiProductEventSessionDtosSessionDetailsFile[] — Files of the session
    - `fileId` string, uuid — Unique identifier of the file
    - `fileName` string — File name
    - `fileUrl` string — Url of the file
  - `availableSpots` integer — **Deprecated**: use `totalCapacity` instead. Number of available spots for the session.
  - `totalCapacity` integer — Total capacity configured for the session. Applies to in-person and hybrid sessions; null for virtual sessions.
  - `remainingCapacity` integer — Number of spots still open for new registrations (totalCapacity minus already-registered users). Applies to in-person and hybrid sessions with a configured capacity; null otherwise.
  - `externalRefId` string — A reference ID that you can use to map this session to your external systems or databases
  - `parentSessionId` string — Parent session ID of the session

## Other responses

- `400` — Invalid session ID or event ID
- `401` — Unauthorized
- `404` — Session not found

---

[API](https://skmtc.net/zuddl/apis/zuddl-webhook-documentation.md) · [All operations](https://skmtc.net/zuddl/apis/zuddl-webhook-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zuddl/zuddl-webhook-documentation/versions/571c1d41e62a/schema)