Skip to main content
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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.mavioapp.com/llms.txt

Use this file to discover all available pages before exploring further.

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.