Meetings

Update a meeting

Changed on

Updates 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}.

patch/api/v1/meetings/{meetingId}

Request

  • Base URL
    https://api.recruitwithatlas.com
  • Auth
    HTTP bearer

Path parameters

meetingIdstring uuid required

ID of the meeting to retrieve

Example:550e8400-e29b-41d4-a716-446655440000

Request body

namestring

Meeting title

descriptionstring nullable

Meeting description, also used as the calendar event body. null clears it.

startAtstring date-time

Start time, ISO 8601 with Z or an explicit offset

endAtstring date-time

End time, ISO 8601 with Z or an explicit offset. Must not be before the start time. Moving it into the past marks the meeting completed.

timeZonestring

IANA time zone the meeting is held in, used for the calendar event

communicationMethod'video_call' | 'phone_call' | 'in_person'

How the meeting is held

locationstring nullable

Meeting location. null clears it.

projectIdstring uuid nullable

Project the meeting relates to. Must belong to your agency. null unlinks it.

isPrivateboolean

Mark the meeting private

hideAttendeesboolean

Hide the attendee list on the calendar event

inviteAINotetakerboolean

Invite or remove the AI notetaker. Only applies to a meeting with a calendar event.

peopleNotesstring nullable

Plain-text notes about the meeting (the manual note). null clears it.

status'canceled'

Only canceled is accepted, to cancel the meeting. This marks it canceled in Atlas and withdraws the separate candidate invite, if there is one, the same as cancelling it in the Atlas app. It does not cancel the organizer’s calendar event or remove the AI notetaker.

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

status'ok' required

Changes