Update a meeting
Changed onUpdates a general meeting’s details and notes, through the same service the Atlas app uses. Every field is optional, but at least one is required; omitted fields are left unchanged. attendees replaces the whole attendee list, null clears location, description or peopleNotes, and projectId: null unlinks the project. status only accepts canceled, which marks the meeting canceled in Atlas and withdraws the candidate invite but leaves the organizer’s calendar event and the AI notetaker in place.
When this edit moves endAt into the past, the meeting is marked completed. If the meeting has a calendar event, it is updated too; if that fails, nothing is saved and a 400 is returned.
Who can update it follows the agency’s “Who can edit a meeting note?” setting: by default the meeting’s creator or an agency admin, and the agency can extend this to the creator’s teammates or to everyone. Candidate interviews cannot be updated here. Returns the meeting in the same shape as GET /api/v1/meetings/{meetingId}.
Request
- Base URLhttps://api.recruitwithatlas.com
- AuthHTTP bearer
Path parameters
ID of the meeting to retrieve
Request body
Example request
{
"name": "Intro call with Jane Doe",
"startAt": "2026-06-01T09:00:00Z",
"endAt": "2026-06-01T09:30:00Z",
"timeZone": "Europe/London",
"communicationMethod": "video_call",
"location": "1 Main Street, London",
"attendees": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"email": "jane.doe@client.com"
}
],
"projectId": "550e8400-e29b-41d4-a716-446655440000",
"hideAttendees": true,
"peopleNotes": "Discussed the senior engineer role; follow up next week.",
"candidateEvent": {
"enabled": true,
"eventTitle": "Interview with Acme",
"inviteeEmail": "jane.doe@candidate.com",
"inviteeName": "Jane Doe"
},
"status": "canceled"
}Response
Meeting updated
Changes
- info
endpoint added
- info