PATCH
/
v1
/
action-items
/
{id}
curl -X PATCH https://api.mavioapp.com/v1/action-items/act_p6q7r8 \
  -H "Authorization: Bearer mvo_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "completed"
  }'

{
  "id": "act_p6q7r8",
  "title": "Complete Stripe payment integration testing",
  "description": "Test the full payment flow in Stripe sandbox including successful charges, declined cards, and refund processing.",
  "status": "completed",
  "priority": "high",
  "assignee": {
    "id": "prt_g7h8i9",
    "name": "Priya Patel",
    "email": "priya@example.com"
  },
  "due_date": "2026-04-11",
  "meeting_id": "mtg_8f3k2j1m4n5p",
  "meeting_title": "Weekly Product Sync",
  "source_segment_id": "seg_003",
  "completed_at": "2026-04-11T16:32:08Z",
  "created_at": "2026-04-10T14:51:44Z",
  "updated_at": "2026-04-11T16:32:08Z"
}
Update one or more fields on an action item. Only the fields you include in the request body will be modified; all other fields remain unchanged.
​
id
string
required
The unique action item identifier (e.g., act_p6q7r8).

​
Request body

All fields are optional. Include only the fields you want to change.
​
status
string
New status. One of pending, in_progress, or completed. Setting to completed automatically sets completed_at to the current timestamp.
​
assignee
string | null
New assignee. Accepts a participant ID (e.g., prt_a1b2c3), an email address, or a name. Set to null to unassign.
​
due_date
string | null
New due date in ISO 8601 date format (e.g., 2026-04-20). Set to null to remove the due date.
​
priority
string
New priority level. One of high, medium, or low.
​
title
string
Updated title for the action item.
​
description
string | null
Updated description. Set to null to clear.

​
Response

Returns the full updated action item object.
​
id
string
Unique action item identifier.
​
title
string
Action item title.
​
description
string | null
Action item description.
​
status
string
Current status.
​
priority
string
Priority level.
​
assignee
object | null
The assigned person.
​
due_date
string | null
Due date.
​
meeting_id
string
The associated meeting ID.
​
meeting_title
string
The associated meeting title.
​
source_segment_id
string
The transcript segment where this was identified.
​
completed_at
string | null
Timestamp when marked as completed.
​
created_at
string
When the action item was created.
​
updated_at
string
When the action item was last updated.
curl -X PATCH https://api.mavioapp.com/v1/action-items/act_p6q7r8 \
  -H "Authorization: Bearer mvo_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "completed"
  }'

{
  "id": "act_p6q7r8",
  "title": "Complete Stripe payment integration testing",
  "description": "Test the full payment flow in Stripe sandbox including successful charges, declined cards, and refund processing.",
  "status": "completed",
  "priority": "high",
  "assignee": {
    "id": "prt_g7h8i9",
    "name": "Priya Patel",
    "email": "priya@example.com"
  },
  "due_date": "2026-04-11",
  "meeting_id": "mtg_8f3k2j1m4n5p",
  "meeting_title": "Weekly Product Sync",
  "source_segment_id": "seg_003",
  "completed_at": "2026-04-11T16:32:08Z",
  "created_at": "2026-04-10T14:51:44Z",
  "updated_at": "2026-04-11T16:32:08Z"
}
When an action item is marked as completed, the action_item.completed webhook event is fired if you have a webhook subscription for it.