opensesh docs

Cancel a session

POST
/events/{eventId}/sessions/{submissionId}/cancel

Cancels the session with a recorded cause (organizer or speaker). The acceptance stays on record and the schedule is kept as history; the session leaves the agenda and public pages, its open tasks are waived, and — when notifySpeakers is on — speakers get a cancellation email carrying a calendar cancellation if invites went out.

Authorization

bearerAuth
AuthorizationBearer <token>

An organization API key (osk_…)

In: header

Path Parameters

eventId*string
submissionId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/events/string/sessions/string/cancel" \  -H "Content-Type: application/json" \  -d '{    "cause": "organizer"  }'
{  "id": "string",  "cancelledAt": "string",  "cancelledBy": "organizer",  "createdEmails": 0,  "waivedTasks": 0}

Create a session directly POST

Creates an accepted session without a CFP submission — the manual-add path. Speakers must already be event contacts. Manual sessions have no submission to decline; delete them if added by mistake, or cancel them to notify speakers.

Reinstate a cancelled session POST

Clears the cancellation and reopens tasks that were waived by it. With notifySpeakers on, speakers get a reinstatement email — carrying a fresh calendar invite when the session is scheduled and invites had gone out; otherwise the schedule is flagged so a fresh invite can be sent later.