---
title: "Send bot to link"
method: POST
path: "/meetings/bot"
tags: ["meetings"]
---

# Send bot to link

`POST /meetings/bot`

## Request

- Base URL: `https://api.timeless.day/v1`
- URL: `https://api.timeless.day/v1/meetings/bot`
- Auth: HTTP bearer

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.

The request is processed asynchronously. A `202` means the request was accepted, not that the bot has joined. The response includes the `meeting_id` that the recording and transcript will appear under, which is also the ID that `meeting.transcript_ready` webhooks carry. If the bot can't be created, that meeting never appears.

If your note-taker is already scheduled for, joining, or in the same call (including one booked for a calendar event), that bot is kept and no second bot is sent. In that case the returned `meeting_id` won't resolve. Find the meeting with [List meetings](/api-reference/meetings/list-meetings) instead. Limited to 10 requests per minute and 60 per hour per user.

## Request body

- MeetingBotRequest
  - `meeting_url` string, required: A Zoom, Google Meet, Microsoft Teams, or Webex join link. Max 1024 characters.

## Response `202`

The bot has been queued to join the call.

- MeetingBotResponse: Acknowledgement that the bot was queued to join the call.
  - `meeting_id` string, required: The meeting the recording and transcript will appear under.
  - `status` 'scheduling' | 'cancelling', required: Whether the bot is being scheduled or cancelled for the event.

## Other responses

- `400`: The link is missing, longer than 1024 characters, malformed, or not a supported video-conference link, or your account has no connected calendar.
- `401`: Authentication required.
- `403`: Usage limit exceeded. Upgrade your plan to send the bot.
- `429`: Rate limit exceeded: more than 10 requests per minute or 60 per hour for your account.

## Changes

- **2026-11-03** `10a43448b654`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/timeless/apis/timeless-public-api/changes/meetings/bot/post.md)

---

[API](https://skmtc.dev/timeless/apis/timeless-public-api.md) - [All operations](https://skmtc.dev/timeless/apis/timeless-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/timeless/apis/timeless-public-api/revisions/10a43448b654?raw)