# Timeless API

- [Introduction](https://docs.timeless.day/api-reference/introduction.md): Learn how to authenticate, handle errors, and paginate through the Timeless API.
- [MCP server](https://docs.timeless.day/api-reference/mcp.md): Connect AI assistants to your Timeless data using the Model Context Protocol.
- [List meetings](https://docs.timeless.day/api-reference/meetings/list-meetings.md): Returns a paginated list of meetings accessible to the authenticated user. Supports filtering by status, date range, participants, company, room, and more.
- [List upcoming meetings](https://docs.timeless.day/api-reference/meetings/list-upcoming-meetings.md): Returns a paginated list of upcoming meetings from the authenticated user's connected calendar, ordered by start time. These are scheduled calendar events that have not yet started — distinct from the recorded meetings returned by `GET /meetings`.
- [Get recording](https://docs.timeless.day/api-reference/meetings/get-recording.md): Returns a temporary URL to download the recording for a meeting. The URL is short-lived and should be used promptly.
- [Get transcript](https://docs.timeless.day/api-reference/meetings/get-transcript.md): Returns the transcript for a meeting, including speaker identification and time-stamped segments.
- [List meeting permissions](https://docs.timeless.day/api-reference/meetings/list-permissions.md): List public, teammate, and team permissions for a meeting you own. Includes the share URL.
- [Set meeting permission](https://docs.timeless.day/api-reference/meetings/set-permission.md): Grant or update access to a meeting you own for a teammate, your team, or anyone with the link. Public access is read-only.
- [Revoke meeting permission](https://docs.timeless.day/api-reference/meetings/revoke-permission.md): Revoke a permission from a meeting you own. Other access remains unchanged, and repeating the request returns `204`.
- [Schedule bot](https://docs.timeless.day/api-reference/meetings/schedule-bot.md): Schedules the AI note-taker bot to join a specific upcoming event. The request is accepted and processed asynchronously — a `202` means the bot has been queued to join, not that it has joined yet. To send the bot to a link with no calendar event, use [Send bot to link](/api-reference/meetings/send-b…
- [Send bot to link](https://docs.timeless.day/api-reference/meetings/send-bot-to-link.md): Sends the AI note-taker bot to a video-conference link right now. The meeting doesn't need a calendar event. For a meeting on your calendar, use [Schedule bot](/api-reference/meetings/schedule-bot) instead.
- [Cancel bot](https://docs.timeless.day/api-reference/meetings/cancel-bot.md): Cancels a previously scheduled AI note-taker bot for an event. The request is accepted and processed asynchronously — a `202` means the cancellation has been queued.
- [Get note-taker automation](https://docs.timeless.day/api-reference/settings/get-notetaker-automation.md): Returns the current AI note-taker automation mode for your account.
- [Set note-taker automation](https://docs.timeless.day/api-reference/settings/set-notetaker-automation.md): Updates the AI note-taker automation mode. Changing the mode immediately schedules or cancels bots for your upcoming events to match the new setting.
- [List rooms](https://docs.timeless.day/api-reference/rooms/list-rooms.md): Returns a paginated list of rooms accessible to the authenticated user. Rooms group related meetings together.
- [Create room](https://docs.timeless.day/api-reference/rooms/create-room.md): Create an empty room you own. Add meetings to it with **Add meeting to room** and share it with **Set room permission**.
- [Get room](https://docs.timeless.day/api-reference/rooms/get-room.md): Returns one room you own or that is shared with you.
- [Rename room](https://docs.timeless.day/api-reference/rooms/rename-room.md): Rename a room you own or have edit access to.
- [Delete room](https://docs.timeless.day/api-reference/rooms/delete-room.md): Delete a room you own, along with the documents filed only in this room. The meetings in the room are kept. Deletion is asynchronous, so the room can still be listed for a few seconds after the `202`.
- [Add meeting to room](https://docs.timeless.day/api-reference/rooms/add-meeting.md): Add a meeting you can access to a room you own or have edit access to. Only meetings that have started can be added, and repeating the request returns `204`. Teammates the room is shared with can read the meetings in it.
- [Remove meeting from room](https://docs.timeless.day/api-reference/rooms/remove-meeting.md): Remove a meeting from a room you own or have edit access to, whoever added it. The meeting itself is kept.
- [List room permissions](https://docs.timeless.day/api-reference/rooms/list-permissions.md): List public, teammate, and team permissions for a room you own. Includes the share URL.
- [Set room permission](https://docs.timeless.day/api-reference/rooms/set-permission.md): Grant or update access to a room you own for a teammate, your team, or anyone with the link. Public access is read-only. Teammates and your team can read the meetings in the room. Find teammate IDs and your team ID with **List team members**.
- [Revoke room permission](https://docs.timeless.day/api-reference/rooms/revoke-permission.md): Revoke a permission from a room you own. Other access remains unchanged, and repeating the request returns `204`.
- [List team members](https://docs.timeless.day/api-reference/team/list-team-members.md): Returns your active teammates, excluding you, plus your team ID. Use them as recipients when you share meetings and rooms.
- [Get document](https://docs.timeless.day/api-reference/documents/get-document.md): Returns a document by ID. Documents are AI-generated artifacts from meetings, such as summaries, action items, or notes. You can request the content in multiple formats.
- [Upload media](https://docs.timeless.day/api-reference/upload/upload-media.md): Upload an audio or video file for processing. The request body should be the raw binary file content — not multipart form data. Metadata is passed as query parameters.
- [Create webhook](https://docs.timeless.day/api-reference/webhooks/create-webhook.md): Creates a new webhook subscription. The response includes a `secret` that you should store securely — it is used to verify webhook signatures and is only returned once at creation time.
- [List webhooks](https://docs.timeless.day/api-reference/webhooks/list-webhooks.md): Returns all webhook subscriptions owned by the authenticated user. The `secret` is not included in list responses — it is only returned when a webhook is created.
- [Update webhook](https://docs.timeless.day/api-reference/webhooks/update-webhook.md): Updates an existing webhook. Only include the fields you want to change — omitted fields remain unchanged. Fields cannot be set to `null`.
- [Delete webhook](https://docs.timeless.day/api-reference/webhooks/delete-webhook.md): Permanently deletes a webhook. No further events will be delivered to its URL.
- [Verify signatures](https://docs.timeless.day/api-reference/webhooks/verify-signatures.md): How to verify webhook delivery signatures to ensure authenticity.
- [Install](https://docs.timeless.day/cli/install.md): Install the Timeless desktop app and wire its bundled CLI to your coding agent.
- [Commands](https://docs.timeless.day/cli/commands.md): The timeless command surface: meetings, bot, events, playbooks, and the desktop app.
- [Playbooks](https://docs.timeless.day/cli/playbooks.md): How the CLI turns meetings into artifacts — a named prompt plus an inline trigger, run by your agent harness.
- [Configuration](https://docs.timeless.day/cli/config.md): The timeless config file: where it lives, what it holds, and what you can change.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)
- [openapi](/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.