Rename Meeting

Learn how to update meeting name and other metadata using the REST API.

Overview
Use the PATCH /meetings/{platform}/{native_meeting_id} endpoint to update meeting metadata including name, notes, participants, and languages.

You can update:

  • name - Meeting title/name
  • notes - Meeting notes
  • participants - List of participant names
  • languages - List of language codes

All fields are optional - only provided fields will be updated.

Implementation
Update meeting name and other metadata
JavaScript/TypeScript Example
// Rename a meeting
async function renameMeeting(platform, nativeMeetingId, newName) {
  const response = await fetch(
    `https://your-api-url/meetings/${platform}/${nativeMeetingId}`,
    {
      method: 'PATCH',
      headers: {
        'X-API-Key': 'your-api-key',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        data: {
          name: newName
        }
      })
    }
  );
  
  if (!response.ok) {
    throw new Error(`Failed to rename meeting: ${response.statusText}`);
  }
  
  const updatedMeeting = await response.json();
  console.log(`Meeting renamed to: ${updatedMeeting.data.name}`);
  
  return updatedMeeting;
}

// Usage
await renameMeeting('google_meet', 'abc-defg-hij', 'Team Standup - Q1 Planning');

// Update multiple fields at once
async function updateMeetingMetadata(platform, nativeMeetingId, updates) {
  const response = await fetch(
    `https://your-api-url/meetings/${platform}/${nativeMeetingId}`,
    {
      method: 'PATCH',
      headers: {
        'X-API-Key': 'your-api-key',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        data: {
          name: updates.name,
          notes: updates.notes,
          participants: updates.participants,
          languages: updates.languages
        }
      })
    }
  );
  
  return await response.json();
}

// Usage
await updateMeetingMetadata('google_meet', 'abc-defg-hij', {
  name: 'Weekly Team Sync',
  notes: 'Discussion about Q1 goals',
  participants: ['Alice', 'Bob', 'Charlie'],
  languages: ['en']
});
Important Notes
  • Partial updates: Only fields you provide in the data object will be updated. Other fields remain unchanged.
  • Meeting identification: Use platform and native_meeting_id to identify the meeting, not the internal database ID.
  • Arrays: When updating participants or languages, provide the complete array - it will replace the existing array.
  • Empty values: To clear a field, set it to null or an empty string (for strings) or empty array (for arrays).