Meetings API

Schedule and manage governance meetings.

Endpoints Overview

Method	Endpoint	Description
GET	/meetings	List meetings
POST	/meetings	Create meeting
GET	/meetings/{id}	Get meeting details
PATCH	/meetings/{id}	Update meeting
DELETE	/meetings/{id}	Delete meeting

---

List Meetings

GET /meetings

Query Parameters

Parameter	Type	Description
space_id	uuid	Filter by space
status	string	scheduled, completed, cancelled
from_date	date	Start of date range
to_date	date	End of date range
page	integer	Page number
size	integer	Items per page

Response

{
  "items": [
    {
      "id": "...",
      "title": "Weekly Data Governance Review",
      "status": "scheduled",
      "start_time": "2026-01-20T10:00:00Z",
      "end_time": "2026-01-20T11:00:00Z",
      "attendees": [
        {"id": "...", "name": "Alice Johnson"},
        {"id": "...", "name": "Bob Smith"}
      ],
      "action_items_count": 3,
      "created_at": "2026-01-10T08:00:00Z"
    }
  ],
  "total": 5,
  "page": 1,
  "size": 20
}

---

Create Meeting

POST /meetings

Request Body

{
  "title": "Q1 Data Quality Review",
  "description": "Quarterly review of data quality metrics and priorities",
  "space_id": "space-uuid",
  "start_time": "2026-01-20T10:00:00Z",
  "end_time": "2026-01-20T11:00:00Z",
  "attendee_ids": ["user-uuid-1", "user-uuid-2"]
}

Required Fields

Field	Type	Description
title	string	Meeting title
space_id	uuid	Space for the meeting
start_time	datetime	Start time (ISO 8601)

Optional Fields

Field	Type	Description
description	string	Meeting description
end_time	datetime	End time
attendee_ids	array	User UUIDs to invite

---

Update Meeting

PATCH /meetings/{id}

Reschedule

{
  "start_time": "2026-01-21T14:00:00Z",
  "end_time": "2026-01-21T15:00:00Z"
}

Add Notes

{
  "notes": "## Discussion Points\n\n1. Quality score improvements\n2. New data sources"
}

Change Status

{
  "status": "completed"
}

---

Meeting Attendees

Add Attendee

POST /meetings/{id}/attendees

{
  "user_id": "user-uuid"
}

Remove Attendee

DELETE /meetings/{id}/attendees/{user_id}

---

Action Items

List Action Items

GET /meetings/{id}/action-items

{
  "items": [
    {
      "id": "...",
      "title": "Review freshness check thresholds",
      "status": "pending",
      "assignee": {"id": "...", "name": "Jane Developer"},
      "due_date": "2026-01-25",
      "created_at": "2026-01-20T10:30:00Z"
    }
  ]
}

Create Action Item

POST /meetings/{id}/action-items

{
  "title": "Update documentation for new data product",
  "assignee_id": "user-uuid",
  "due_date": "2026-01-30"
}

Update Action Item

PATCH /meetings/{id}/action-items/{action_id}

{
  "status": "completed"
}

---

Meeting Attachments

Upload Attachment

POST /meetings/{id}/attachments
Content-Type: multipart/form-data

List Attachments

GET /meetings/{id}/attachments

Download Attachment

GET /meetings/{id}/attachments/{attachment_id}/download