# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Zoom REST Account API version: 1.0.0 extends: openapi/zoom-account-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-09-24' generator: build-phrasing.py label: Generated by API Evangelist operations: 10 - target: $.paths['/ma/account/billing/update'].post update: x-apievangelist-phrasing: intent: Update a sub account's billing information effect: write questions: - Can a master account change the billing address on one of its sub accounts? - Which billing contact fields can I update for a sub account? instructions: - text: Update the billing phone for sub account {account_id} to {phone_number}. slots: account_id: requestBody.account_id phone_number: requestBody.phone_number - text: Set sub account {account_id}'s billing address to {address}, {city}, {state} {zip}. slots: account_id: requestBody.account_id address: requestBody.address city: requestBody.city state: requestBody.state zip: requestBody.zip method: generated generated: '2026-09-24' - target: $.paths['/ma/account/create'].post update: x-apievangelist-phrasing: intent: Create a sub account under the master account effect: write questions: - How do I create a new sub account under my master account? - What privilege does a master account need before it can create sub accounts? instructions: - text: Create a sub account owned by {first_name} {last_name} at {email} with password {password}. slots: first_name: requestBody.first_name last_name: requestBody.last_name email: requestBody.email password: requestBody.password - text: Open a new sub account for {email} ({first_name} {last_name}), password {password}, capacity {meeting_capacity}. slots: email: requestBody.email first_name: requestBody.first_name last_name: requestBody.last_name password: requestBody.password meeting_capacity: requestBody.meeting_capacity method: generated generated: '2026-09-24' - target: $.paths['/ma/account/delete'].post update: x-apievangelist-phrasing: intent: Delete a sub account effect: destructive questions: - Can I remove a sub account from under my master account? - What identifies the sub account I want to delete? instructions: - text: Delete sub account {account_id}. slots: account_id: requestBody.account_id - text: Remove the sub account {account_id} from the master account. slots: account_id: requestBody.account_id method: generated generated: '2026-09-24' - target: $.paths['/ma/account/get'].post update: x-apievangelist-phrasing: intent: Get a sub account's details effect: read questions: - Who owns a particular sub account under my master account? - Can I look up one sub account by its account ID? instructions: - text: Get the details of sub account {account_id}. slots: account_id: requestBody.account_id - text: Show me the owner of sub account {account_id}. slots: account_id: requestBody.account_id method: generated generated: '2026-09-24' - target: $.paths['/ma/account/list'].post update: x-apievangelist-phrasing: intent: List all sub accounts effect: read questions: - Which sub accounts sit under my master account? - Can I see every sub account the master account manages? instructions: - text: List all sub accounts under the master account. - text: List sub accounts using API key {api_key} and secret {api_secret}. slots: api_key: requestBody.api_key api_secret: requestBody.api_secret method: generated generated: '2026-09-24' - target: $.paths['/ma/account/plan/add'].post update: x-apievangelist-phrasing: intent: Add an additional plan to a sub account effect: write questions: - Can I add an extra plan to a sub account that the master account pays for? - Is adding a base plan allowed, or only additional plans? instructions: - text: Add the additional plan {plan} to sub account {account_id}. slots: plan: requestBody.plan account_id: requestBody.account_id - text: Attach add-on plan {plan} to paid sub account {account_id}. slots: plan: requestBody.plan account_id: requestBody.account_id method: generated generated: '2026-09-24' - target: $.paths['/ma/account/plan/get'].post update: x-apievangelist-phrasing: intent: Get a sub account's plans effect: read questions: - What plans is a sub account currently on? - Can I check a sub account's subscription details? instructions: - text: Get the plan information for sub account {account_id}. slots: account_id: requestBody.account_id - text: Show which plans sub account {account_id} is subscribed to. slots: account_id: requestBody.account_id method: generated generated: '2026-09-24' - target: $.paths['/ma/account/plan/subscribe'].post update: x-apievangelist-phrasing: intent: Subscribe a sub account to plans effect: write questions: - How do I start a paid subscription for a sub account? - Can I bundle webinar, recording and audio plans into a sub account's subscription? instructions: - text: Subscribe sub account {account_id} to base plan {plan_base}, billing {first_name} {last_name} at {phone_number}. slots: account_id: requestBody.account_id plan_base: requestBody.plan_base first_name: requestBody.first_name last_name: requestBody.last_name phone_number: requestBody.phone_number - text: Subscribe {account_id} to {plan_base} with webinar plan {plan_webinar}, billed to {address}, {city}, {state} {zip}, {country}. slots: account_id: requestBody.account_id plan_base: requestBody.plan_base plan_webinar: requestBody.plan_webinar address: requestBody.address city: requestBody.city state: requestBody.state zip: requestBody.zip country: requestBody.country method: generated generated: '2026-09-24' - target: $.paths['/ma/account/plan/update'].post update: x-apievangelist-phrasing: intent: Change a sub account's base or additional plan effect: write questions: - Can I upgrade the base plan on a sub account the master account pays for? - What is the difference between updating a base plan and an additional plan here? instructions: - text: Change sub account {account_id}'s {type} plan to {plan}. slots: account_id: requestBody.account_id type: requestBody.type plan: requestBody.plan - text: Switch the existing plan of type {type} on {account_id} to {plan}. slots: type: requestBody.type account_id: requestBody.account_id plan: requestBody.plan method: generated generated: '2026-09-24' - target: $.paths['/ma/account/update'].post update: x-apievangelist-phrasing: intent: Update a sub account's settings effect: write questions: - Can I change meeting capacity or login enforcement for an existing sub account? - Which options can I toggle on a sub account after it's created? instructions: - text: Set meeting capacity on sub account {account_id} to {meeting_capacity}. slots: account_id: requestBody.account_id meeting_capacity: requestBody.meeting_capacity - text: Restrict sub account {account_id} logins to domains {enforce_login_domains}. slots: account_id: requestBody.account_id enforce_login_domains: requestBody.enforce_login_domains method: generated generated: '2026-09-24'