# Send the notetaker into a meeting

> Dispatches a bot to a live meeting link. Three things are worth knowing before you call it: only **one bot per account** can be live at a time, so a second call returns 409 and retrying will not help; it **counts against the monthly recording allowance**, and at the cap returns 409 with the reason; and the link must be on a supported platform. Send an `Idempotency-Key` so a retry after a timeout cannot start a second bot.

`POST https://api-notetaker.nabrah.ai/ext/v1/bots`

Requires an API key in the `Authorization` header.

Dispatches a bot to a live meeting link. Three things are worth knowing before you call it: only **one bot per account** can be live at a time, so a second call returns 409 and retrying will not help; it **counts against the monthly recording allowance**, and at the cap returns 409 with the reason; and the link must be on a supported platform. Send an `Idempotency-Key` so a retry after a timeout cannot start a second bot.

## Body

- `joinUrl` (string · uri, required)
- `title` (string)

## Example request body

```json
{
  "joinUrl": "string",
  "title": "string"
}
```

## Responses

- `201` — The bot was dispatched.
- `401` — No key, an unknown key, or one that has been revoked or has expired.
- `403` — The key is read only, or lacks the reach for this route.
- `404` — No such record — or one that belongs to another account.
- `409` — Either a bot is already live for this account, or the monthly allowance is spent. The message says which.
- `422` — The body or query failed validation; `details` names the field.
- `429` — Too many requests. `Retry-After` says how long to wait.

### 201 example

```json
{
  "data": {}
}
```

### 401 example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}
```

### 403 example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}
```

### 404 example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}
```

### 409 example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}
```

### 422 example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}
```

### 429 example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}
```