List meetings

Meetings in your library with title, date, duration, your role and folder, newest first.

GET https://cotlet.dev/api/v1/tldv/meetings

read

Lists meetings in your tl;dv library, newest first. Filter by a text query, a date range or a folder. Each item shows your role on the meeting (admin, editor or viewer), which decides what you can change. Pages hold up to 50 meetings; pass next_cursor back as cursor for the next page. A meeting still being processed shows status processing.

Parameters

Parameters: list_meetings
NameTypeDescription
query string string Text to find in meeting titles.
from date date Only meetings on or after this date.
to date date Only meetings on or before this date.
folder_id string string Only meetings in this folder, from list_folders.
limit integer integer 1 to 50. Default: 20.
cursor string string Next page cursor from the previous call.

Request

cURL
curl https://cotlet.dev/api/v1/tldv/meetings \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("tldv", "list_meetings")
Node.js
const result = await cotlet.call('tldv', 'list_meetings');
CLI
cotlet call tldv list_meetings

Example response

JSON

{
  "meetings": [
    {
      "meeting_id": "mt_4f21a9",
      "title": "Acme discovery call",
      "started_at": "2026-10-15T14:00:00Z",
      "duration_minutes": 42,
      "organizer": "You",
      "role": "admin",
      "participants": 3,
      "folder": null,
      "status": "ready"
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjUwfQ"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.