Meetings

Get meeting

Returns a meeting by its ID, including the notes, attendees, and recording details the caller has permission to view.

get/meeting/{meetingId}

Request

  • Base URL: https://circleback.ai/api
  • URL: https://circleback.ai/api/meeting/{meetingId}
  • Auth: one of:
    • HTTP bearer
    • none

Path parameters

meetingIdstring required

The unique identifier of the meeting.

Response

Successful response.

idstring required

Circleback meeting ID. Can be used to generate a link to the meeting (https://circleback.ai/meetings/${id}).

namestring nullable required

Meeting name.

createdAtstring date-time required

Meeting creation date, formatted as an ISO 8601 timestamp.

updatedAtstring date-time required

When the meeting was last updated.

durationnumber nullable required

Meeting duration in seconds.

urlstring nullable required

URL of the virtual meeting (Zoom, Google Meet, or Microsoft Teams).

recordingUrlstring nullable required

URL of the meeting recording file. Only valid for 24 hours, and only available if saving meeting recordings is enabled in settings.

tagsTags required(unresolved $ref)
icalUidstring nullable required

Unique identifier of the calendar event associated with the meeting.

attendeesAttendees required(unresolved $ref)
notesstring nullable required

Circleback meeting notes with Markdown formatting.

privateNotesstring required

The authenticated user's private notes for the meeting.

actionItemsActionItems required(unresolved $ref)
insightsInsights required(unresolved $ref)
linkAccess'Editor' | 'Viewer' | 'LimitedViewer' nullable required

Who can access the meeting through its shareable link.

calendarEventCalendarEvent required(unresolved $ref)
sharedWithSharedWith required(unresolved $ref)

Example response

{
  "id": "WRweb12iCBimU6Vo8cD7z",
  "name": "Event Venue Review",
  "createdAt": "2023-07-25T20:30:57.926Z",
  "updatedAt": "2023-07-25T20:30:57.926Z",
  "duration": 1306.09,
  "url": "https://meet.google.com/abc-defgh-xyz",
  "recordingUrl": "https://storage.googleapis.com/circleback-recordings/WRweb12iCBimU6Vo8cD7z.mp4",
  "tags": [
    {
      "id": 1,
      "name": "Events",
      "description": "Company events and offsites."
    }
  ],
  "icalUid": "event-venue-review@google.com",
  "attendees": [
    {
      "profileId": 1,
      "name": "John Appleseed",
      "title": "Head of Operations",
      "companyName": "Initech",
      "email": "john@initech.com",
      "isCalendarEventOrganizer": true,
      "isCalendarInvitee": true
    },
    {
      "profileId": 2,
      "name": "Samantha Grey",
      "title": "Office Manager",
      "companyName": "Initech",
      "email": "samantha@initech.com",
      "isCalendarEventOrganizer": false,
      "isCalendarInvitee": true
    }
  ],
  "notes": "#### Overview\n* Several options for event venues were reviewed…",
  "privateNotes": "Ask Samantha about the Sunriver deposit before Friday.",
  "actionItems": [
    {
      "id": 252,
      "title": "Contact event venues",
      "description": "Reach out to Sunriver Events and other potential event venues to see if they would be open to hosting the event this summer.",
      "assignee": {
        "profileId": 1,
        "name": "John Appleseed",
        "title": "Head of Operations",
        "companyName": "Initech",
        "email": "john@initech.com"
      },
      "status": "PENDING"
    },
    {
      "id": 253,
      "title": "Review and finalize venue options",
      "description": "Review pricing and availability of venues and pick a venue for the event.",
      "assignee": null,
      "status": "PENDING"
    }
  ],
  "insights": {
    "Customer details": [
      {
        "speaker": "John Appleseed",
        "timestamp": 800,
        "insight": {
          "Company name": "Initech",
          "Number of employees": 120
        }
      }
    ],
    "Questions": [
      {
        "insight": "Is this thing on?",
        "speaker": "Samantha Grey",
        "timestamp": 49.15
      },
      {
        "insight": "When will the webhook integration be ready?",
        "speaker": "John Appleseed",
        "timestamp": 120.12
      }
    ]
  },
  "linkAccess": "Viewer",
  "calendarEvent": {
    "id": 91,
    "icalUid": "event-venue-review@google.com",
    "description": "Quarterly venue review",
    "platform": "GoogleCalendar",
    "platformId": "provider-event-id"
  },
  "sharedWith": [
    {
      "profileId": 1,
      "name": "John Appleseed",
      "access": "Owner",
      "email": "john@initech.com"
    },
    {
      "name": "Operations",
      "access": "Viewer",
      "teamId": 12
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.