Update Recap | Calendly | Developer Documentation

const url = 'https://api.calendly.com/meeting_recaps/BBBBBBBBBBBBBBBB';
const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"summary_md":"Updated summary after review.","action_items_md":"- Create Jira epic\n- Notify stakeholders","discussion_md":"Create Jira epic. Notify stakeholders."}'
};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

{
  "resource": {
    "uri": "https://api.calendly.com/meeting_recaps/BBBBBBBBBBBBBBBB",
    "app_url": "https://calendly.com/app/tracked_meetings/BBBBBBBBBBBBBBBB",
    "status": "Available",
    "event": "https://api.calendly.com/scheduled_events/AAAAAAAAAAAAAAAA",
    "name": "Weekly Sync",
    "location": {
      "location": "https://zoom.us/j/123456789",
      "type": "custom"
    },
    "start_time": "2025-11-08T20:28:00.561000Z",
    "end_time": "2025-11-08T21:28:00.561000Z",
    "created_at": "2025-11-08T19:00:00.000000Z",
    "updated_at": "2025-11-08T22:00:00.000000Z",
    "attendees": [
      {
        "host": true,
        "user_email": "john@example.com",
        "user_name": "John Smith"
      },
      {
        "host": false,
        "user_email": "steve@example2.com",
        "user_name": "Steve Johnson"
      }
    ],
    "summary_md": "Updated summary after review.",
    "action_items_md": "- Create Jira epic\n- Notify stakeholders",
    "discussion_md": "Create Jira epic. Notify stakeholders.",
    "transcript": "https://api.calendly.com/meeting_recaps/BBBBBBBBBBBBBBBB/transcript",
    "share_link": "https://calendly.com/s/meetings/BBBBBBBBBBBBBBBB"
  }
}

Update an existing Recap. You may send any combination of the optional body fields; omitted fields are left unchanged. Unknown top-level properties are rejected.

Note: Requires paid plan

Required scopes

meeting_recaps:write

Authentication

AuthorizationBearer

OAuth 2.0

AuthorizationBearer

Personal Access Token

Path parameters

uuidstringRequired

Request

Optional markdown fields to update.

summary_mdstring or nullOptional

Summary in Markdown.

action_items_mdstring or nullOptional

Action items in Markdown.

discussion_mdstring or nullOptional

Discussion notes in Markdown.

Response

resourceobject

A meeting recap generated for a Calendly scheduled event or an external event.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error