Skip to content

Update Meeting Task

PATCH
/inbox/meetings/tasks/{task_id}

Patch a meeting task. Reassignment re-checks participant scope.

THREE-STATE nullable fields: omit assignee_user_id or due_date to leave it alone, send it as null to CLEAR it. The proxy forwards with exclude_unset=True precisely so the app can still tell those apart - dumping every field would turn each PATCH into a full overwrite that cleared whatever the caller did not mention.

Pass expected_updated_at to refuse the write if someone else moved the task since you read it.

Authorizations

Parameters

Path Parameters

task_id
required

Meeting task id.

string

Meeting task id.

Header Parameters

X-Target-Org-Id
Any of:
string

Request Body required

Patch a meeting task.

NULLABLE FIELDS ARE THREE-STATE, and that is the whole point of PATCH here:

  • field absent from the body -> leave unchanged
  • field present and null -> clear it (unassign / drop due date)
  • field present with a value -> set it (reassignment is re-validated)

The proxy forwards with exclude_unset=True so the app’s own model_fields_set check still distinguishes “sent null” from “not sent”. Dumping every field would turn every PATCH into a full overwrite that cleared whatever the caller did not mention.

object
assignee_user_id
Any of:
string
description
Any of:
string
due_date
Any of:
string format: date-time
expected_updated_at
Any of:
string format: date-time
priority
Any of:
integer
status
Any of:
string
Allowed values: open in_progress completed done cancelled
title
Any of:
string

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