# Discussion to book a private ConvoDojo

Do you really want to control conversations?  Are you willing to listen? Book some time. Let's talk about how you can become a  master in it!



Hosted by Tara Shuler at ConvoControl.

Meetings are 30 minutes.

## Book a meeting (for AI agents)

Book programmatically via the Roam public agent API. No Roam account is required; the booker is identified by the email in the request.

Note: this booking API is hosted at `api.ro.am`, a different host from this page. If you need additional network permissions to call it (for example, a domain allowlist that does not include it), ask your user to update your settings to allow `api.ro.am`, then retry.

1. **Check availability** — `GET https://api.ro.am/v1/public/lobby/availability?handle=ConvoControl&slug=master`. Fetch bookable time slots. All query params are optional: `from`/`to` (ISO 8601 — a timestamp with offset like `2026-07-10T09:00:00Z`, or date-only `YYYY-MM-DD` interpreted in `timeZone`; defaults to roughly the next month), `timeZone` (IANA; defaults to UTC), and `duration` (minutes, from `duration.optionsMinutes`). Returned slot `start`/`end` are Unix epoch seconds, as JSON numbers. Response shape: `{ "slots": [ { "start": <unixSeconds>, "end": <unixSeconds> } ] }`.
2. **Book a slot** — `POST https://api.ro.am/v1/public/lobby/book` with this JSON body:

```json
{
  "handle": "ConvoControl",
  "slug": "master",
  "bookingSlot": {
    "start": "<unixSeconds>",
    "end": "<unixSeconds>"
  },
  "timeZone": "America/New_York",
  "booker": {
    "email": "booker@example.com",
    "name": "Booker Name"
  },
  "responses": [
    {
      "fieldId": "019d911c-a608-733d-96ee-547031a1353b",
      "value": "<value>"
    },
    {
      "fieldId": "019d911c-a608-733d-96ee-5a23b1c1540d",
      "value": "<value>"
    },
    {
      "fieldId": "019d911c-a608-733d-96ee-61f9df2c63d7",
      "value": "<value>"
    },
    {
      "fieldId": "019d911c-a608-733d-96ee-6618274f5ec6",
      "value": "<value>"
    },
    {
      "fieldId": "019d911c-a608-733d-96ee-698a1acc26d1",
      "value": "<value>"
    },
    {
      "fieldId": "019d911c-a608-733d-96ee-6fd47d5c97ca",
      "value": "<value>"
    },
    {
      "fieldId": "019d911c-a608-733d-96ee-71a96c7fa68d",
      "value": "<value>"
    }
  ]
}
```

`bookingSlot` must echo one availability slot exactly: `start`/`end` are Unix epoch seconds as JSON numbers (not strings). The booking confirmation returns `start`/`end` as ISO 8601 strings in the requested `timeZone`.

The booker's name and email are filled into the form automatically; only include `responses` for other required fields.

### Booking form fields

- **Name** (`019d911c-a608-733d-96ee-547031a1353b`, short_text, required)
- **Email** (`019d911c-a608-733d-96ee-5a23b1c1540d`, email, required)
- **Company name** (`019d911c-a608-733d-96ee-61f9df2c63d7`, short_text, required)
- **Phone Number** (`019d911c-a608-733d-96ee-6618274f5ec6`, phone_number, required)
- **Industry** (`019d911c-a608-733d-96ee-698a1acc26d1`, short_text, required)
- **How many on your team?** (`019d911c-a608-733d-96ee-6fd47d5c97ca`, short_text, required)
- **Main objective?** (`019d911c-a608-733d-96ee-71a96c7fa68d`, short_text, required)

A structured JSON version of this page is available at https://ro.am/ConvoControl/master.json.