---
title: "Dispatch Template To Meeting"
method: POST
path: "/v1/templates/{template_id}/dispatch-meeting"
tags: ["templates"]
---

# Dispatch Template To Meeting

`POST /v1/templates/{template_id}/dispatch-meeting`

Send the Roxels agent into an external meeting (Google Meet / Zoom /
Teams) running this template, in the chosen behavior mode. Server-side
equivalent of scripts/recall_session.py. Delegates to the shared
`dispatch_meeting_for_template` action so the live ("join now") path and
the calendar-invite scheduler create sessions identically. Returns the
ids + bot status so the UI can link to the session afterward.

## Path parameters

- `template_id` string, required

## Request body

- DispatchMeetingRequest
  - `meeting_url` string, required
  - `mode` string
  - `overseers` string[]
  - `person_name` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/roxels/apis/interviewer.md) · [All operations](https://skmtc.dev/roxels/apis/interviewer/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/roxels/interviewer/revisions/4ef48ed226e1/schema)