Skip to content

Set Meeting Sensitivity

PATCH
/inbox/meetings/{meeting_id}/sensitivity

CHANGE WHO MAY READ THE RECORDING OF THIS MEETING.

private HIDES the transcript from everyone except the meeting’s participants. normal EXPOSES it to the organisation again - and a transcript that has been read cannot be un-read, so going back to normal is not a reversible edit in any sense that matters.

Only a PARTICIPANT may change it; anyone else gets a 403. Classified destructive, so it needs inbox:delete rather than riding along with inbox:write - a key that triages the inbox should not also be able to publish a private recording.

sensitivity is REQUIRED here. The app defaults a missing key to normal, which is the exposing direction, so this contract refuses to guess.

Authorizations

Parameters

Path Parameters

meeting_id
required

Meeting id, as returned by GET /inbox/meetings.

string

Meeting id, as returned by GET /inbox/meetings.

Header Parameters

X-Target-Org-Id
Any of:
string

Request Body required

WHO MAY READ THE RECORDING OF THIS MEETING.

private restricts the transcript to the meeting’s participants. normal makes it visible to the organisation again - so moving a meeting from private back to normal EXPOSES a transcript that was restricted, and nobody who reads it in the meantime can be made to un-read it.

The app takes a bare Dict[str, str] here and defaults a MISSING or misspelled key to "normal". That default is the exposing direction, so this contract makes the value REQUIRED and closed: a typo is a 422 naming both options rather than a silent un-restrict.

object
sensitivity
required

private = participants only. normal = visible to the organisation. Required - there is no safe default.

string
Allowed values: normal private

Responses

200

Successful Response

object
data
required

An open envelope for a comment, an assignment or a workspace.

Open because a comment carries attachment refs and mention metadata that grow, and because an assignment result reports per-assignee outcomes.

object
key
additional properties
any
pagination
Any of:
object
has_next
required

Whether there are more pages

boolean
limit
required

Items per page

integer
next_cursor
Any of:
string
notes
Any of:
Array<string>
page
required

Current page number (1-indexed)

integer
total
required

Total number of items

integer
total_available
Any of:
integer
total_is_lower_bound
Any of:
boolean

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string