Owner-facing provisioning and management of your genie’s email inbox
agent-mailboxes-self is the owner-facing surface for managing the email inbox attached to your own genie. Every action is scoped to the caller’s genie — you can only manage mailboxes you own.
To read the current mailbox state you can use either this resource’s get action (documented below) or the genies resource (get or all action), which includes a mailbox field in every full genie response.
Get mailbox
Returns the current mailbox record for a genie you own. Use this to check provisioning status, retrieve the mailbox email address, or detect errors after provisioning.
string
required
Must be "agent-mailboxes-self"
string
required
Must be "get"
object
required
Show properties
string
required
UUID of the genie whose mailbox to retrieve.
boolean
Whether the request succeeded.
object
The mailbox record.
Show properties
string
Mailbox UUID.
string
UUID of the owning genie.
string
The provisioned mailbox email address.
string | null
Internal account reference used by the mail system, or null if provisioning is still in progress.
string | null
Connection grant identifier, or null.
string
Current provisioning status. One of "provisioned", "pending", "failed", "suspended", or "unavailable".
string | null
Error message if provisioning failed, or null.
boolean
Whether the mailbox is currently in test mode.
boolean
Whether the genie’s email replies can carry its own Resources and knowledge-base files as attachments and links. On by default.
string
"auto_send" (default) or "draft_only" (each customer reply waits for approval). Read live from the mail service.
boolean
true when an escalation sends the customer no holding note. Read live from the mail service.
string
"reply" — the genie answers email sent to this address. "listen" — a listen-only forwarding address for a Listener genie: the business forwards its own support inbox here, and each email lands in the Inbox with a suggested reply but is never answered automatically.
string[]
Email addresses seen forwarding to a listen-only mailbox. Empty for reply mailboxes and before the first forwarded email arrives.
object | null
The most recent forwarding confirmation request received by a listen-only mailbox (for example, Gmail’s confirmation code when forwarding is first set up), or null.
Show properties
string
Email provider that sent the confirmation, e.g. "gmail".
string | null
Confirmation code to enter in the provider’s forwarding settings.
string | null
Confirmation link from the provider’s email. It is not followed automatically.
string | null
The inbox that asked to forward to this address.
string
ISO 8601 timestamp of when the confirmation arrived.
string | null
Fallback email address for messages the genie cannot handle, or null if not set.
string
ISO 8601 creation timestamp.
string
ISO 8601 last-updated timestamp.
const mailbox = await ApiService.invoke("agent-mailboxes-self", "get", undefined, { agentId: "550e8400-e29b-41d4-a716-446655440000",});console.log(mailbox.email_address); // e.g. "support-bot@mail.helpgenie.ai"console.log(mailbox.status); // e.g. "provisioned"console.log(mailbox.escalation_address); // e.g. "oncall@example.com" or null
Creates an email inbox for a genie that doesn’t have one yet. If a desiredLocalpart is provided and the genie already has a mailbox, the existing inbox is deprovisioned and a new one is created at the requested address.A Listener genie’s mailbox is created listen-only (mode: "listen"): a forwarding address for the business’s own support inbox that never replies on its own. A listen- prefix (for example listen-acme) is a good choice for desiredLocalpart. Renaming a listen-only mailbox keeps it listen-only.New genies don’t get a mailbox automatically — call this action (or pass provisionMailbox: true when creating or cloning a genie) to set one up.If the genie has no mailbox record here but the mail system still holds a live mailbox for it, that mailbox is restored under its current address instead of creating a new one. desiredLocalpart is ignored in that case — rename the mailbox afterwards with a second provision call.
string
required
Must be "agent-mailboxes-self"
string
required
Must be "provision"
object
required
Show properties
string
required
UUID of the genie to provision a mailbox for.
string
Requested prefix for the mailbox email address (the part before the @). Must be 2–40 characters, using only lowercase letters, digits, and hyphens. Cannot start or end with a hyphen. Omit to let the system choose an address automatically.When provided for a genie that already has a mailbox, the current mailbox is deprovisioned and a new one is created at the requested address.
boolean
Whether the request succeeded.
object
The provisioned mailbox record.
Show properties
string
Mailbox UUID.
string
UUID of the owning genie.
string
The provisioned mailbox email address.
string | null
Internal account reference used by the mail system, or null if provisioning is still in progress.
string | null
Connection grant identifier, or null.
string
Current provisioning status. One of "provisioned", "pending", "failed", or "suspended".
string | null
Error message if provisioning failed, or null.
boolean
Whether the mailbox is currently in test mode.
boolean
Whether the genie’s email replies can carry its own Resources and knowledge-base files as attachments and links. On by default.
string
"reply" — the genie answers email sent to this address. "listen" — a listen-only forwarding address for a Listener genie: the business forwards its own support inbox here, and each email lands in the Inbox with a suggested reply but is never answered automatically.
string[]
Email addresses seen forwarding to a listen-only mailbox. Empty for reply mailboxes and before the first forwarded email arrives.
object | null
The most recent forwarding confirmation request received by a listen-only mailbox (for example, Gmail’s confirmation code when forwarding is first set up), or null.
Show properties
string
Email provider that sent the confirmation, e.g. "gmail".
string | null
Confirmation code to enter in the provider’s forwarding settings.
string | null
Confirmation link from the provider’s email. It is not followed automatically.
string | null
The inbox that asked to forward to this address.
string
ISO 8601 timestamp of when the confirmation arrived.
string | null
Fallback email address for messages the genie cannot handle, or null if not set.
string
ISO 8601 creation timestamp.
string
ISO 8601 last-updated timestamp.
When desiredLocalpart is provided for a genie that already has a mailbox, the existing inbox is permanently deprovisioned before the new one is created. Any emails in the old inbox will be lost. If the mail system refuses to remove the old inbox, the request fails and the existing mailbox is left unchanged.
Returns an INTERNAL_ERROR with the mailbox’s last_error when provisioning ends in status "failed", or when no mailbox record exists after the request.
// Provision with a custom address prefixconst mailbox = await ApiService.invoke("agent-mailboxes-self", "provision", undefined, { agentId: "550e8400-e29b-41d4-a716-446655440000", desiredLocalpart: "support-bot",});// Provision with a system-chosen addressconst mailbox = await ApiService.invoke("agent-mailboxes-self", "provision", undefined, { agentId: "550e8400-e29b-41d4-a716-446655440000",});
Suspends or resumes a genie’s mailbox, updates its escalation address, and/or toggles test mode, attaching resources to replies, approve-before-send or the customer holding note on escalation. At least one of action, escalation_address, test_mode, attach_resources, operating_mode, or skip_forward_ack must be provided.This action never creates a mailbox. If the genie has no mailbox record here but the mail system still holds one, it is restored first; otherwise the request returns NOT_FOUND.
string
required
Must be "agent-mailboxes-self"
string
required
Must be "update"
object
required
Show properties
string
required
UUID of the genie whose mailbox to update.
string
Lifecycle transition. Must be "suspend" or "resume". Omit to leave the current status unchanged.
string | null
Fallback email address for messages the genie cannot handle. Must be a valid email address, or null to clear the current value. Omit this key entirely to leave it unchanged.
boolean
Enable or disable test mode for the mailbox. When true, the mailbox processes emails in a sandboxed mode. Stored locally and synced to the mail service to keep both sides in agreement.
boolean
Whether the genie’s email replies can carry its own Resources and knowledge-base files as attachments and links, when one answers the email. On by default. Stored locally and synced to the mail service.
string
"auto_send" (default) sends each reply the genie writes on its own. "draft_only" holds every customer reply until it is approved, edited or dismissed with decide. An escalation is held the same way instead of being forwarded: its draft is a suggested reply with [square-bracket] placeholders for business facts the genie couldn’t confirm (empty only if drafting failed, so it must be sent with edit), and its decision in conversation-detail carries escalation_note, what the genie couldn’t answer, and gap_note, what to teach it. No holding note is sent in this mode. Has no effect on a listen-only mailbox.
boolean
true stops the short holding note the customer gets when the genie escalates their email. false by default.
boolean
object
Show properties
boolean
true when the update was applied successfully.
// Suspend the mailboxawait ApiService.invoke("agent-mailboxes-self", "update", undefined, { agentId: "550e8400-e29b-41d4-a716-446655440000", action: "suspend",});// Set an escalation addressawait ApiService.invoke("agent-mailboxes-self", "update", undefined, { agentId: "550e8400-e29b-41d4-a716-446655440000", escalation_address: "oncall@example.com",});// Resume and clear escalation at the same timeawait ApiService.invoke("agent-mailboxes-self", "update", undefined, { agentId: "550e8400-e29b-41d4-a716-446655440000", action: "resume", escalation_address: null,});// Enable test modeawait ApiService.invoke("agent-mailboxes-self", "update", undefined, { agentId: "550e8400-e29b-41d4-a716-446655440000", test_mode: true,});// Stop attaching resources to email repliesawait ApiService.invoke("agent-mailboxes-self", "update", undefined, { agentId: "550e8400-e29b-41d4-a716-446655440000", attach_resources: false,});// Hold every reply for approvalawait ApiService.invoke("agent-mailboxes-self", "update", undefined, { agentId: "550e8400-e29b-41d4-a716-446655440000", operating_mode: "draft_only",});
Permanently removes a genie’s email inbox — deletes the local record and fully removes the account from the mail system. After deletion, the genie stays without a mailbox — and receives no email — until a new one is created with provision. If no local record exists, an orphaned mailbox for the genie is still looked up in the mail system and deleted.
string
required
Must be "agent-mailboxes-self"
string
required
Must be "delete"
object
required
Show properties
string
required
UUID of the genie whose mailbox to deprovision.
boolean
object
Show properties
boolean
true when the mailbox was successfully deprovisioned.
This action fully removes the mailbox from the mail system and deletes all associated records. The action is idempotent — a 404 from the mail system is treated as success. If the mail system refuses the delete, the request fails and the mailbox record is restored unchanged. The genie itself is not affected.
Sends a test email into a genie’s mailbox to verify it is provisioned and receiving correctly. A missing mailbox record is restored from the mail system first when the mail system still holds the mailbox (a mailbox is never created here); fails if the mailbox has no mail account yet or has been deprovisioned.
string
required
Must be "agent-mailboxes-self"
string
required
Must be "test"
object
required
Show properties
string
required
UUID of the genie whose mailbox to test.
boolean
object
Result from the mail system’s test endpoint. Shape may vary; a successful response indicates the test email was accepted for delivery.
const result = await ApiService.invoke("agent-mailboxes-self", "test", undefined, { agentId: "550e8400-e29b-41d4-a716-446655440000",});
Lists email conversation threads for a genie’s mailbox, fetched from the mail system. Returns the genie owner’s threads — callers must own the specified genie. A missing mailbox record is restored from the mail system first when the mail system still holds the mailbox (a mailbox is never created here); fails if the mailbox has no mail account yet.
string
required
Must be "agent-mailboxes-self"
string
required
Must be "conversations"
object
required
Show properties
string
required
UUID of the genie whose mailbox threads to list.
string
Filter by conversation state. One of "open", "escalated", or "closed".
string
Filter by the genie’s last decision on a thread (e.g. "replied", "escalated", "ignored").
string
Full-text search across conversation subjects and body snippets.
string
ISO 8601 timestamp — only threads updated after this time.
string
Pagination cursor returned from a previous page.
number
Maximum number of threads to return.
string
Sort order. One of "date_asc", "date_desc", "sender_asc", or "sender_desc".
boolean
object
Conversation threads and pagination cursor. Shape is determined by the mail system response.
Sends a human-written reply on an email conversation thread via the genie’s mailbox. The genie’s automated handling is paused for that thread after a reply is sent, so the human can take over without the genie also responding.
string
required
Must be "agent-mailboxes-self"
string
required
Must be "reply"
object
required
Show properties
string
required
UUID of the genie whose mailbox the reply is sent from.
string
required
Mail system conversation ID (returned in the conversations action result).
string
required
Plain-text body of the reply. Must be non-empty.
boolean
object
Result from the mail system’s reply endpoint. Shape may vary; a successful response indicates the reply was accepted for delivery.
Sending a reply automatically pauses the genie’s handling of that thread. The genie will not respond further unless the thread is manually resumed.
const result = await ApiService.invoke("agent-mailboxes-self", "reply", undefined, { agentId: "550e8400-e29b-41d4-a716-446655440000", conversationId: "mail-conv-abc123", body_text: "Thanks for reaching out — I'll look into this and follow up shortly.",});
curl -X POST https://api.helpgenie.ai/v1 \ -H "Authorization: Bearer hg_live_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "resource": "agent-mailboxes-self", "action": "reply", "data": { "agentId": "550e8400-e29b-41d4-a716-446655440000", "conversationId": "mail-conv-abc123", "body_text": "Thanks for reaching out — I'\''ll look into this and follow up shortly." } }'
Approve or dismiss a waiting reply
When the mailbox’s operating_mode is "draft_only", each reply the genie writes waits for approval. List waiting conversations with conversations and decisionStatus: "proposed", then read the conversation with conversation-detail: the waiting reply is the decision with action: "send" and status: "proposed", and its draft_subject/draft_body are what will be sent. Approving or editing sends a real email to the customer from the genie’s mailbox address.
string
required
Must be "agent-mailboxes-self"
string
required
Must be "decide"
object
required
Show properties
string
required
UUID of the genie whose mailbox holds the reply.
string
required
Mail system conversation ID.
string
required
ID of the waiting send decision from conversation-detail.
string
required
"approve" sends the reply as written, "edit" sends body instead, "dismiss" drops it.
string
Required for "edit": the reply to send. Recorded as the owner’s correction, so later replies learn from it.
string
Optional with "edit": a replacement subject.
boolean
object
Show properties
boolean
true when the reply was sent or dismissed.
boolean
true when the reply was sent.
Returns CONFLICT when the reply was already sent or dismissed, or when the customer wrote again and a newer reply replaced it.
await ApiService.invoke("agent-mailboxes-self", "decide", undefined, { agentId: "550e8400-e29b-41d4-a716-446655440000", conversationId: "mail-conv-abc123", decisionId: "6a1f0c2e-3b4d-4e5f-8a9b-0c1d2e3f4a5b", action: "edit", body: "Hi Sam, yes, we deliver to Taupō on Tuesdays and Fridays.",});
Inbound callback from the mail system to mirror a status, address, or error change into the local mailbox record. Writes locally only — it never calls back out to the mail system. At least one of status, email_address, or last_error must be provided.
string
required
Must be "agent-mailboxes-self"
string
required
Must be "sync"
object
required
Show properties
string
required
UUID of the genie whose local mailbox row to update.
string
Updated mailbox status from the mail system. One of "pending", "provisioned", "suspended", "failed", or "unavailable".
string
Updated provisioned email address, or null to clear.
Verifies that your team’s stored mail service credentials are still valid and active. Use this to diagnose email delivery failures — for example, when the mail service returns authentication errors and you need to confirm whether the credentials have been rotated or revoked.
This action requires admin privileges. Non-admin callers receive a FORBIDDEN error.
string
required
Must be "agent-mailboxes-self"
string
required
Must be "check-tenant-key"
boolean
Whether the request succeeded.
object
Show properties
string
Current credential status as reported by the mail service (e.g. "active"). Returns "unknown" if the service does not provide a status.
string | null
ISO 8601 timestamp of when the credentials were revoked, or null if still active.
string
Your team’s mail tenant identifier.
const result = await ApiService.invoke("agent-mailboxes-self", "check-tenant-key");console.log(result.status); // e.g. "active"console.log(result.revokedAt); // null if still valid
Reissues your team’s mail service credentials, replacing the current key with a fresh one. Use this when check-tenant-key reports that credentials are invalid or revoked.
This action requires admin privileges. Non-admin callers receive a FORBIDDEN error.
Re-provisioning invalidates the current credentials immediately. Any in-flight requests using the old key will fail until they re-authenticate. Only call this when check-tenant-key confirms the existing credentials are no longer valid.
string
required
Must be "agent-mailboxes-self"
string
required
Must be "reprovision-tenant-key"
boolean
Whether the request succeeded.
object
Show properties
string
Your team’s mail tenant identifier (unchanged after re-provisioning).
const result = await ApiService.invoke("agent-mailboxes-self", "reprovision-tenant-key");console.log(result.tenantId);
Genie, mailbox, mail credentials, or waiting reply not found
CONFLICT
409
decide on a reply that was already sent, dismissed, or replaced by a newer one
VALIDATION_ERROR
400
Missing agentId, conversationId, decisionId, or body_text; invalid desiredLocalpart; no update fields provided; invalid escalation_address; invalid test_mode, attach_resources, operating_mode or skip_forward_ack; invalid decide action, missing body for edit, or approve on an empty draft (an escalation whose suggested reply couldn’t be drafted); or mailbox already exists when no rename is requested
INVALID_ACTION
400
Unknown action
INTERNAL_ERROR
500
Mail system error or local sync failure
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Help Genie","description":"API documentation for the Help Genie voice AI platform","colors":{"primary":"#4E9CFF","light":"#7BB8FF","dark":"#2B7FE8"},"logo":{"light":"https://mintcdn.com/helpgenie/a134Jyg1BOpqw0vP/logo/light.png?fit=max\u0026auto=format\u0026n=a134Jyg1BOpqw0vP\u0026q=85\u0026s=f29d097a201254a8a750843d0d692c50","dark":"https://mintcdn.com/helpgenie/a134Jyg1BOpqw0vP/logo/dark.png?fit=max\u0026auto=format\u0026n=a134Jyg1BOpqw0vP\u0026q=85\u0026s=f00cbee677f1f3a3f46d463cb7cbad38","href":"https://helpgenie.ai"},"favicon":"https://mintcdn.com/helpgenie/17V8AwVjtycIuhCm/favicon.svg?fit=max\u0026auto=format\u0026n=17V8AwVjtycIuhCm\u0026q=85\u0026s=8a7865e1c10e3dacc378789f70f5ef6e","navbar":{"links":[{"href":"mailto:support@helpgenie.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://helpgenie.ai/dashboard"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/helpgenie"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Help Genie Voice","icon":"microphone","href":"https://helpgenie.ai"},{"anchor":"Help Genie Mail","icon":"envelope","href":"https://mail.helpgenie.ai"},{"anchor":"Help Genie Outbound","icon":"phone","href":"https://outbound.helpgenie.ai"},{"anchor":"Help Genie Sync","icon":"arrows-rotate","href":"https://sync.helpgenie.ai"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"helpgenie","hasAudioNarration":false,"actualSubdomain":"helpgenie","customDomains":["docs.helpgenie.ai"],"gitSource":{"type":"github","owner":"help-genie-ai","repo":"help-genie-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af6f87607e6a796f0fd81d2","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API reference","count":54},{"language":"default","tag":"Voice","count":37},{"language":"default","tag":"Overview","count":20},{"language":"default","tag":"Expanded Platform","count":16},{"language":"default","tag":"Sync","count":13},{"language":"default","tag":"Mail","count":11},{"language":"default","tag":"Outbound","count":9},{"language":"default","tag":"Knowledge","count":6},{"language":"default","tag":"Working with mail","count":6},{"language":"default","tag":"Configuring a Genie","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/agent-mailboxes-self","slug":"/api-reference/agent-mailboxes-self","pageMetadata":{"title":"Genie mailbox (self)","description":"Owner-facing provisioning and management of your genie's email inbox","href":"/api-reference/agent-mailboxes-self"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Owner-facing provisioning and management of your genie’s email inbox\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Expandable,Heading,Note,ParamField,ResponseField,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.code,{children:`agent-mailboxes-self`}),` is the owner-facing surface for managing the email inbox attached to your own genie. Every action is scoped to the caller’s genie — you can only manage mailboxes you own.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`To read the current mailbox state you can use either this resource’s `,_jsx(_components.code,{children:`get`}),` action (documented below) or the `,_jsx(_components.code,{children:`genies`}),` resource (`,_jsx(_components.code,{children:`get`}),` or `,_jsx(_components.code,{children:`all`}),` action), which includes a `,_jsx(_components.code,{children:`mailbox`}),` field in every full genie response.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`get-mailbox`,children:`Get mailbox`}),`\n`,_jsx(_components.p,{children:`Returns the current mailbox record for a genie you own. Use this to check provisioning status, retrieve the mailbox email address, or detect errors after provisioning.`}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"agent-mailboxes-self\"`})]})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"get\"`})]})}),`\n`,_jsx(ParamField,{body:`data`,type:`object`,required:true,id:`param-data`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`agentId`,type:`string`,required:true,id:`param-agent-id`,children:_jsx(_components.p,{children:`UUID of the genie whose mailbox to retrieve.`})})})}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success`,children:_jsx(_components.p,{children:`Whether the request succeeded.`})}),`\n`,_jsxs(ResponseField,{name:`data`,type:`object`,id:`param-data-1`,children:[_jsx(_components.p,{children:`The mailbox record.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id`,children:`Mailbox UUID.`}),_jsx(ResponseField,{name:`agent_id`,type:`string`,id:`param-agent-id-1`,children:`UUID of the owning genie.`}),_jsx(ResponseField,{name:`email_address`,type:`string`,id:`param-email-address`,children:`The provisioned mailbox email address.`}),_jsxs(ResponseField,{name:`account_id`,type:`string | null`,id:`param-account-id`,children:[`Internal account reference used by the mail system, or `,_jsx(_components.code,{children:`null`}),` if provisioning is still in progress.`]}),_jsxs(ResponseField,{name:`grant_id`,type:`string | null`,id:`param-grant-id`,children:[`Connection grant identifier, or `,_jsx(_components.code,{children:`null`}),`.`]}),_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[`Current provisioning status. One of `,_jsx(_components.code,{children:`\"provisioned\"`}),`, `,_jsx(_components.code,{children:`\"pending\"`}),`, `,_jsx(_components.code,{children:`\"failed\"`}),`, `,_jsx(_components.code,{children:`\"suspended\"`}),`, or `,_jsx(_components.code,{children:`\"unavailable\"`}),`.`]})}),_jsxs(ResponseField,{name:`last_error`,type:`string | null`,id:`param-last-error`,children:[`Error message if provisioning failed, or `,_jsx(_components.code,{children:`null`}),`.`]}),_jsx(ResponseField,{name:`test_mode`,type:`boolean`,id:`param-test-mode`,children:`Whether the mailbox is currently in test mode.`}),_jsx(ResponseField,{name:`attach_resources`,type:`boolean`,id:`param-attach-resources`,children:`Whether the genie’s email replies can carry its own Resources and knowledge-base files as attachments and links. On by default.`}),_jsxs(ResponseField,{name:`operating_mode`,type:`string`,id:`param-operating-mode`,children:[_jsx(_components.code,{children:`\"auto_send\"`}),` (default) or `,_jsx(_components.code,{children:`\"draft_only\"`}),` (each customer reply waits for approval). Read live from the mail service.`]}),_jsxs(ResponseField,{name:`skip_forward_ack`,type:`boolean`,id:`param-skip-forward-ack`,children:[_jsx(_components.code,{children:`true`}),` when an escalation sends the customer no holding note. Read live from the mail service.`]}),_jsx(ResponseField,{name:`mode`,type:`string`,id:`param-mode`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`\"reply\"`}),` — the genie answers email sent to this address. `,_jsx(_components.code,{children:`\"listen\"`}),` — a listen-only forwarding address for a Listener genie: the business forwards its own support inbox here, and each email lands in the Inbox with a suggested reply but is never answered automatically.`]})}),_jsx(ResponseField,{name:`listened_inboxes`,type:`string[]`,id:`param-listened-inboxes`,children:`Email addresses seen forwarding to a listen-only mailbox. Empty for reply mailboxes and before the first forwarded email arrives.`}),_jsxs(ResponseField,{name:`forwarding_verification`,type:`object | null`,id:`param-forwarding-verification`,children:[_jsxs(_components.p,{children:[`The most recent forwarding confirmation request received by a listen-only mailbox (for example, Gmail’s confirmation code when forwarding is first set up), or `,_jsx(_components.code,{children:`null`}),`.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ResponseField,{name:`provider`,type:`string`,id:`param-provider`,children:[`Email provider that sent the confirmation, e.g. `,_jsx(_components.code,{children:`\"gmail\"`}),`.`]}),_jsx(ResponseField,{name:`code`,type:`string | null`,id:`param-code`,children:`Confirmation code to enter in the provider’s forwarding settings.`}),_jsx(ResponseField,{name:`confirmation_url`,type:`string | null`,id:`param-confirmation-url`,children:`Confirmation link from the provider’s email. It is not followed automatically.`}),_jsx(ResponseField,{name:`requested_by`,type:`string | null`,id:`param-requested-by`,children:`The inbox that asked to forward to this address.`}),_jsx(ResponseField,{name:`received_at`,type:`string`,id:`param-received-at`,children:`ISO 8601 timestamp of when the confirmation arrived.`})]})]}),_jsxs(ResponseField,{name:`escalation_address`,type:`string | null`,id:`param-escalation-address`,children:[`Fallback email address for messages the genie cannot handle, or `,_jsx(_components.code,{children:`null`}),` if not set.`]}),_jsx(ResponseField,{name:`created_at`,type:`string`,id:`param-created-at`,children:`ISO 8601 creation timestamp.`}),_jsx(ResponseField,{name:`updated_at`,type:`string`,id:`param-updated-at`,children:`ISO 8601 last-updated timestamp.`})]})]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`ApiService.invoke()`,numberOfLines:`6`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` mailbox`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agent-mailboxes-self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"get\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`undefined`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agentId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"550e8400-e29b-41d4-a716-446655440000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`mailbox`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`email_address`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`); `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// e.g. \"support-bot@mail.helpgenie.ai\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`mailbox`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`status`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`); `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// e.g. \"provisioned\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`mailbox`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`escalation_address`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`); `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// e.g. \"oncall@example.com\" or null`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`10`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.helpgenie.ai/v1`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer hg_live_YOUR_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resource\": \"agent-mailboxes-self\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"get\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"data\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agentId\": \"550e8400-e29b-41d4-a716-446655440000\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Response`,numberOfLines:`20`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`20`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"mbx-uuid-001\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"agent_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"550e8400-e29b-41d4-a716-446655440000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email_address\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"support-bot@mail.helpgenie.ai\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"acct-abc123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"grant_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"provisioned\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"last_error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"test_mode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"attach_resources\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"mode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"reply\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"listened_inboxes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"forwarding_verification\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"escalation_address\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"oncall@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2024-01-15T10:30:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updated_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2024-01-15T10:30:00.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`provision-mailbox`,children:`Provision mailbox`}),`\n`,_jsxs(_components.p,{children:[`Creates an email inbox for a genie that doesn’t have one yet. If a `,_jsx(_components.code,{children:`desiredLocalpart`}),` is provided and the genie already has a mailbox, the existing inbox is deprovisioned and a new one is created at the requested address.`]}),`\n`,_jsxs(_components.p,{children:[`A Listener genie’s mailbox is created listen-only (`,_jsx(_components.code,{children:`mode: \"listen\"`}),`): a forwarding address for the business’s own support inbox that never replies on its own. A `,_jsx(_components.code,{children:`listen-`}),` prefix (for example `,_jsx(_components.code,{children:`listen-acme`}),`) is a good choice for `,_jsx(_components.code,{children:`desiredLocalpart`}),`. Renaming a listen-only mailbox keeps it listen-only.`]}),`\n`,_jsxs(_components.p,{children:[`New genies don’t get a mailbox automatically — call this action (or pass `,_jsx(_components.code,{children:`provisionMailbox: true`}),` when `,_jsx(_components.a,{href:`/api-reference/genies`,children:`creating`}),` or cloning a genie) to set one up.`]}),`\n`,_jsxs(_components.p,{children:[`If the genie has no mailbox record here but the mail system still holds a live mailbox for it, that mailbox is restored under its current address instead of creating a new one. `,_jsx(_components.code,{children:`desiredLocalpart`}),` is ignored in that case — rename the mailbox afterwards with a second `,_jsx(_components.code,{children:`provision`}),` call.`]}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource-1`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"agent-mailboxes-self\"`})]})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action-1`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"provision\"`})]})}),`\n`,_jsx(ParamField,{body:`data`,type:`object`,required:true,id:`param-data-2`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`agentId`,type:`string`,required:true,id:`param-agent-id-2`,children:_jsx(_components.p,{children:`UUID of the genie to provision a mailbox for.`})}),_jsxs(ParamField,{body:`desiredLocalpart`,type:`string`,id:`param-desired-localpart`,children:[_jsxs(_components.p,{children:[`Requested prefix for the mailbox email address (the part before the `,_jsx(_components.code,{children:`@`}),`). Must be 2–40 characters, using only lowercase letters, digits, and hyphens. Cannot start or end with a hyphen. Omit to let the system choose an address automatically.`]}),_jsx(_components.p,{children:`When provided for a genie that already has a mailbox, the current mailbox is deprovisioned and a new one is created at the requested address.`})]})]})}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success-1`,children:_jsx(_components.p,{children:`Whether the request succeeded.`})}),`\n`,_jsxs(ResponseField,{name:`data`,type:`object`,id:`param-data-3`,children:[_jsx(_components.p,{children:`The provisioned mailbox record.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id-1`,children:`Mailbox UUID.`}),_jsx(ResponseField,{name:`agent_id`,type:`string`,id:`param-agent-id-3`,children:`UUID of the owning genie.`}),_jsx(ResponseField,{name:`email_address`,type:`string`,id:`param-email-address-1`,children:`The provisioned mailbox email address.`}),_jsxs(ResponseField,{name:`account_id`,type:`string | null`,id:`param-account-id-1`,children:[`Internal account reference used by the mail system, or `,_jsx(_components.code,{children:`null`}),` if provisioning is still in progress.`]}),_jsxs(ResponseField,{name:`grant_id`,type:`string | null`,id:`param-grant-id-1`,children:[`Connection grant identifier, or `,_jsx(_components.code,{children:`null`}),`.`]}),_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status-1`,children:_jsxs(_components.p,{children:[`Current provisioning status. One of `,_jsx(_components.code,{children:`\"provisioned\"`}),`, `,_jsx(_components.code,{children:`\"pending\"`}),`, `,_jsx(_components.code,{children:`\"failed\"`}),`, or `,_jsx(_components.code,{children:`\"suspended\"`}),`.`]})}),_jsxs(ResponseField,{name:`last_error`,type:`string | null`,id:`param-last-error-1`,children:[`Error message if provisioning failed, or `,_jsx(_components.code,{children:`null`}),`.`]}),_jsx(ResponseField,{name:`test_mode`,type:`boolean`,id:`param-test-mode-1`,children:`Whether the mailbox is currently in test mode.`}),_jsx(ResponseField,{name:`attach_resources`,type:`boolean`,id:`param-attach-resources-1`,children:`Whether the genie’s email replies can carry its own Resources and knowledge-base files as attachments and links. On by default.`}),_jsx(ResponseField,{name:`mode`,type:`string`,id:`param-mode-1`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`\"reply\"`}),` — the genie answers email sent to this address. `,_jsx(_components.code,{children:`\"listen\"`}),` — a listen-only forwarding address for a Listener genie: the business forwards its own support inbox here, and each email lands in the Inbox with a suggested reply but is never answered automatically.`]})}),_jsx(ResponseField,{name:`listened_inboxes`,type:`string[]`,id:`param-listened-inboxes-1`,children:`Email addresses seen forwarding to a listen-only mailbox. Empty for reply mailboxes and before the first forwarded email arrives.`}),_jsxs(ResponseField,{name:`forwarding_verification`,type:`object | null`,id:`param-forwarding-verification-1`,children:[_jsxs(_components.p,{children:[`The most recent forwarding confirmation request received by a listen-only mailbox (for example, Gmail’s confirmation code when forwarding is first set up), or `,_jsx(_components.code,{children:`null`}),`.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ResponseField,{name:`provider`,type:`string`,id:`param-provider-1`,children:[`Email provider that sent the confirmation, e.g. `,_jsx(_components.code,{children:`\"gmail\"`}),`.`]}),_jsx(ResponseField,{name:`code`,type:`string | null`,id:`param-code-1`,children:`Confirmation code to enter in the provider’s forwarding settings.`}),_jsx(ResponseField,{name:`confirmation_url`,type:`string | null`,id:`param-confirmation-url-1`,children:`Confirmation link from the provider’s email. It is not followed automatically.`}),_jsx(ResponseField,{name:`requested_by`,type:`string | null`,id:`param-requested-by-1`,children:`The inbox that asked to forward to this address.`}),_jsx(ResponseField,{name:`received_at`,type:`string`,id:`param-received-at-1`,children:`ISO 8601 timestamp of when the confirmation arrived.`})]})]}),_jsxs(ResponseField,{name:`escalation_address`,type:`string | null`,id:`param-escalation-address-1`,children:[`Fallback email address for messages the genie cannot handle, or `,_jsx(_components.code,{children:`null`}),` if not set.`]}),_jsx(ResponseField,{name:`created_at`,type:`string`,id:`param-created-at-1`,children:`ISO 8601 creation timestamp.`}),_jsx(ResponseField,{name:`updated_at`,type:`string`,id:`param-updated-at-1`,children:`ISO 8601 last-updated timestamp.`})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`When `,_jsx(_components.code,{children:`desiredLocalpart`}),` is provided for a genie that already has a mailbox, the existing inbox is permanently deprovisioned before the new one is created. Any emails in the old inbox will be lost. If the mail system refuses to remove the old inbox, the request fails and the existing mailbox is left unchanged.`]})}),`\n`,_jsxs(_components.p,{children:[`Returns an `,_jsx(_components.code,{children:`INTERNAL_ERROR`}),` with the mailbox’s `,_jsx(_components.code,{children:`last_error`}),` when provisioning ends in status `,_jsx(_components.code,{children:`\"failed\"`}),`, or when no mailbox record exists after the request.`]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`ApiService.invoke()`,numberOfLines:`10`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Provision with a custom address prefix`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` mailbox`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agent-mailboxes-self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"provision\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`undefined`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agentId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"550e8400-e29b-41d4-a716-446655440000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` desiredLocalpart:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"support-bot\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Provision with a system-chosen address`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` mailbox`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agent-mailboxes-self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"provision\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`undefined`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agentId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"550e8400-e29b-41d4-a716-446655440000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`11`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.helpgenie.ai/v1`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer hg_live_YOUR_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resource\": \"agent-mailboxes-self\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"provision\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"data\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agentId\": \"550e8400-e29b-41d4-a716-446655440000\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"desiredLocalpart\": \"support-bot\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Response`,numberOfLines:`20`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`20`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"mbx-uuid-001\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"agent_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"550e8400-e29b-41d4-a716-446655440000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email_address\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"support-bot@mail.helpgenie.ai\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"acct-abc123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"grant_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"provisioned\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"last_error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"test_mode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"attach_resources\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"mode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"reply\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"listened_inboxes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"forwarding_verification\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"escalation_address\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2024-01-15T10:30:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updated_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2024-01-15T10:30:00.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`update-mailbox`,children:`Update mailbox`}),`\n`,_jsxs(_components.p,{children:[`Suspends or resumes a genie’s mailbox, updates its escalation address, and/or toggles test mode, attaching resources to replies, approve-before-send or the customer holding note on escalation. At least one of `,_jsx(_components.code,{children:`action`}),`, `,_jsx(_components.code,{children:`escalation_address`}),`, `,_jsx(_components.code,{children:`test_mode`}),`, `,_jsx(_components.code,{children:`attach_resources`}),`, `,_jsx(_components.code,{children:`operating_mode`}),`, or `,_jsx(_components.code,{children:`skip_forward_ack`}),` must be provided.`]}),`\n`,_jsxs(_components.p,{children:[`This action never creates a mailbox. If the genie has no mailbox record here but the mail system still holds one, it is restored first; otherwise the request returns `,_jsx(_components.code,{children:`NOT_FOUND`}),`.`]}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource-2`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"agent-mailboxes-self\"`})]})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action-2`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"update\"`})]})}),`\n`,_jsx(ParamField,{body:`data`,type:`object`,required:true,id:`param-data-4`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`agentId`,type:`string`,required:true,id:`param-agent-id-4`,children:_jsx(_components.p,{children:`UUID of the genie whose mailbox to update.`})}),_jsx(ParamField,{body:`action`,type:`string`,id:`param-action-3`,children:_jsxs(_components.p,{children:[`Lifecycle transition. Must be `,_jsx(_components.code,{children:`\"suspend\"`}),` or `,_jsx(_components.code,{children:`\"resume\"`}),`. Omit to leave the current status unchanged.`]})}),_jsx(ParamField,{body:`escalation_address`,type:`string | null`,id:`param-escalation-address-2`,children:_jsxs(_components.p,{children:[`Fallback email address for messages the genie cannot handle. Must be a valid email address, or `,_jsx(_components.code,{children:`null`}),` to clear the current value. Omit this key entirely to leave it unchanged.`]})}),_jsx(ParamField,{body:`test_mode`,type:`boolean`,id:`param-test-mode-2`,children:_jsxs(_components.p,{children:[`Enable or disable test mode for the mailbox. When `,_jsx(_components.code,{children:`true`}),`, the mailbox processes emails in a sandboxed mode. Stored locally and synced to the mail service to keep both sides in agreement.`]})}),_jsx(ParamField,{body:`attach_resources`,type:`boolean`,id:`param-attach-resources-2`,children:_jsx(_components.p,{children:`Whether the genie’s email replies can carry its own Resources and knowledge-base files as attachments and links, when one answers the email. On by default. Stored locally and synced to the mail service.`})}),_jsx(ParamField,{body:`operating_mode`,type:`string`,id:`param-operating-mode-1`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`\"auto_send\"`}),` (default) sends each reply the genie writes on its own. `,_jsx(_components.code,{children:`\"draft_only\"`}),` holds every customer reply until it is approved, edited or dismissed with `,_jsx(_components.a,{href:`#approve-or-dismiss-a-waiting-reply`,children:_jsx(_components.code,{children:`decide`})}),`. An escalation is held the same way instead of being forwarded: its draft is a suggested reply with `,_jsx(_components.code,{children:`[square-bracket]`}),` placeholders for business facts the genie couldn’t confirm (empty only if drafting failed, so it must be sent with `,_jsx(_components.code,{children:`edit`}),`), and its decision in conversation-detail carries `,_jsx(_components.code,{children:`escalation_note`}),`, what the genie couldn’t answer, and `,_jsx(_components.code,{children:`gap_note`}),`, what to teach it. No holding note is sent in this mode. Has no effect on a listen-only mailbox.`]})}),_jsx(ParamField,{body:`skip_forward_ack`,type:`boolean`,id:`param-skip-forward-ack-1`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` stops the short holding note the customer gets when the genie escalates their email. `,_jsx(_components.code,{children:`false`}),` by default.`]})})]})}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success-2`}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,id:`param-data-5`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ResponseField,{name:`ok`,type:`boolean`,id:`param-ok`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` when the update was applied successfully.`]})})})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`ApiService.invoke()`,numberOfLines:`36`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`36`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Suspend the mailbox`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agent-mailboxes-self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"update\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`undefined`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agentId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"550e8400-e29b-41d4-a716-446655440000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` action:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"suspend\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Set an escalation address`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agent-mailboxes-self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"update\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`undefined`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agentId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"550e8400-e29b-41d4-a716-446655440000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` escalation_address:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"oncall@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Resume and clear escalation at the same time`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agent-mailboxes-self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"update\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`undefined`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agentId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"550e8400-e29b-41d4-a716-446655440000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` action:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resume\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` escalation_address:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Enable test mode`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agent-mailboxes-self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"update\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`undefined`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agentId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"550e8400-e29b-41d4-a716-446655440000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` test_mode:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Stop attaching resources to email replies`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agent-mailboxes-self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"update\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`undefined`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agentId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"550e8400-e29b-41d4-a716-446655440000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` attach_resources:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Hold every reply for approval`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agent-mailboxes-self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"update\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`undefined`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agentId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"550e8400-e29b-41d4-a716-446655440000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` operating_mode:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"draft_only\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`11`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.helpgenie.ai/v1`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer hg_live_YOUR_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resource\": \"agent-mailboxes-self\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"update\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"data\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agentId\": \"550e8400-e29b-41d4-a716-446655440000\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"suspend\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Response`,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"ok\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`delete-mailbox`,children:`Delete mailbox`}),`\n`,_jsxs(_components.p,{children:[`Permanently removes a genie’s email inbox — deletes the local record and fully removes the account from the mail system. After deletion, the genie stays without a mailbox — and receives no email — until a new one is created with `,_jsx(_components.a,{href:`#provision-mailbox`,children:_jsx(_components.code,{children:`provision`})}),`. If no local record exists, an orphaned mailbox for the genie is still looked up in the mail system and deleted.`]}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource-3`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"agent-mailboxes-self\"`})]})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action-4`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"delete\"`})]})}),`\n`,_jsx(ParamField,{body:`data`,type:`object`,required:true,id:`param-data-6`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`agentId`,type:`string`,required:true,id:`param-agent-id-5`,children:_jsx(_components.p,{children:`UUID of the genie whose mailbox to deprovision.`})})})}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success-3`}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,id:`param-data-7`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ResponseField,{name:`ok`,type:`boolean`,id:`param-ok-1`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` when the mailbox was successfully deprovisioned.`]})})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`This action fully removes the mailbox from the mail system and deletes all associated records. The action is idempotent — a `,_jsx(_components.code,{children:`404`}),` from the mail system is treated as success. If the mail system refuses the delete, the request fails and the mailbox record is restored unchanged. The genie itself is not affected.`]})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`ApiService.invoke()`,numberOfLines:`3`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agent-mailboxes-self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"delete\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`undefined`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agentId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"550e8400-e29b-41d4-a716-446655440000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`10`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.helpgenie.ai/v1`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer hg_live_YOUR_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resource\": \"agent-mailboxes-self\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"delete\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"data\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agentId\": \"550e8400-e29b-41d4-a716-446655440000\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Response`,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"ok\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`send-test-email`,children:`Send test email`}),`\n`,_jsx(_components.p,{children:`Sends a test email into a genie’s mailbox to verify it is provisioned and receiving correctly. A missing mailbox record is restored from the mail system first when the mail system still holds the mailbox (a mailbox is never created here); fails if the mailbox has no mail account yet or has been deprovisioned.`}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource-4`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"agent-mailboxes-self\"`})]})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action-5`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"test\"`})]})}),`\n`,_jsx(ParamField,{body:`data`,type:`object`,required:true,id:`param-data-8`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`agentId`,type:`string`,required:true,id:`param-agent-id-6`,children:_jsx(_components.p,{children:`UUID of the genie whose mailbox to test.`})})})}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success-4`}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,id:`param-data-9`,children:_jsx(_components.p,{children:`Result from the mail system’s test endpoint. Shape may vary; a successful response indicates the test email was accepted for delivery.`})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`ApiService.invoke()`,numberOfLines:`3`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` result`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agent-mailboxes-self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"test\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`undefined`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agentId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"550e8400-e29b-41d4-a716-446655440000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`10`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.helpgenie.ai/v1`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer hg_live_YOUR_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resource\": \"agent-mailboxes-self\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"test\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"data\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agentId\": \"550e8400-e29b-41d4-a716-446655440000\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Response`,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"queued\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`list-email-conversations`,children:`List email conversations`}),`\n`,_jsx(_components.p,{children:`Lists email conversation threads for a genie’s mailbox, fetched from the mail system. Returns the genie owner’s threads — callers must own the specified genie. A missing mailbox record is restored from the mail system first when the mail system still holds the mailbox (a mailbox is never created here); fails if the mailbox has no mail account yet.`}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource-5`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"agent-mailboxes-self\"`})]})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action-6`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"conversations\"`})]})}),`\n`,_jsx(ParamField,{body:`data`,type:`object`,required:true,id:`param-data-10`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`agentId`,type:`string`,required:true,id:`param-agent-id-7`,children:_jsx(_components.p,{children:`UUID of the genie whose mailbox threads to list.`})}),_jsx(ParamField,{body:`state`,type:`string`,id:`param-state`,children:_jsxs(_components.p,{children:[`Filter by conversation state. One of `,_jsx(_components.code,{children:`\"open\"`}),`, `,_jsx(_components.code,{children:`\"escalated\"`}),`, or `,_jsx(_components.code,{children:`\"closed\"`}),`.`]})}),_jsx(ParamField,{body:`decisionStatus`,type:`string`,id:`param-decision-status`,children:_jsxs(_components.p,{children:[`Filter by the genie’s last decision on a thread (e.g. `,_jsx(_components.code,{children:`\"replied\"`}),`, `,_jsx(_components.code,{children:`\"escalated\"`}),`, `,_jsx(_components.code,{children:`\"ignored\"`}),`).`]})}),_jsx(ParamField,{body:`search`,type:`string`,id:`param-search`,children:_jsx(_components.p,{children:`Full-text search across conversation subjects and body snippets.`})}),_jsx(ParamField,{body:`since`,type:`string`,id:`param-since`,children:_jsx(_components.p,{children:`ISO 8601 timestamp — only threads updated after this time.`})}),_jsx(ParamField,{body:`cursor`,type:`string`,id:`param-cursor`,children:_jsx(_components.p,{children:`Pagination cursor returned from a previous page.`})}),_jsx(ParamField,{body:`limit`,type:`number`,id:`param-limit`,children:_jsx(_components.p,{children:`Maximum number of threads to return.`})}),_jsx(ParamField,{body:`sort`,type:`string`,id:`param-sort`,children:_jsxs(_components.p,{children:[`Sort order. One of `,_jsx(_components.code,{children:`\"date_asc\"`}),`, `,_jsx(_components.code,{children:`\"date_desc\"`}),`, `,_jsx(_components.code,{children:`\"sender_asc\"`}),`, or `,_jsx(_components.code,{children:`\"sender_desc\"`}),`.`]})})]})}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success-5`}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,id:`param-data-11`,children:_jsx(_components.p,{children:`Conversation threads and pagination cursor. Shape is determined by the mail system response.`})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`ApiService.invoke()`,numberOfLines:`5`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agent-mailboxes-self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"conversations\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`undefined`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agentId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"550e8400-e29b-41d4-a716-446655440000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` state:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"open\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` limit:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 20`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`12`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`12`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.helpgenie.ai/v1`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer hg_live_YOUR_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resource\": \"agent-mailboxes-self\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"conversations\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"data\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agentId\": \"550e8400-e29b-41d4-a716-446655440000\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"state\": \"open\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"limit\": 20`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`get-email-conversation-detail`,children:`Get email conversation detail`}),`\n`,_jsx(_components.p,{children:`Returns the full message and decision history for a single email conversation thread from the mail system.`}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource-6`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"agent-mailboxes-self\"`})]})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action-7`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"conversation-detail\"`})]})}),`\n`,_jsx(ParamField,{body:`data`,type:`object`,required:true,id:`param-data-12`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`agentId`,type:`string`,required:true,id:`param-agent-id-8`,children:_jsx(_components.p,{children:`UUID of the genie the thread belongs to.`})}),_jsx(ParamField,{body:`conversationId`,type:`string`,required:true,id:`param-conversation-id`,children:_jsxs(_components.p,{children:[`Mail system conversation ID (returned in the `,_jsx(_components.code,{children:`conversations`}),` action result).`]})})]})}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success-6`}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,id:`param-data-13`,children:_jsx(_components.p,{children:`Full conversation thread with messages and decision history.`})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`ApiService.invoke()`,numberOfLines:`4`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agent-mailboxes-self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"conversation-detail\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`undefined`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agentId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"550e8400-e29b-41d4-a716-446655440000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` conversationId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"mail-conv-abc123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`11`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.helpgenie.ai/v1`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer hg_live_YOUR_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resource\": \"agent-mailboxes-self\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"conversation-detail\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"data\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agentId\": \"550e8400-e29b-41d4-a716-446655440000\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"conversationId\": \"mail-conv-abc123\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`reply-to-a-conversation`,children:`Reply to a conversation`}),`\n`,_jsx(_components.p,{children:`Sends a human-written reply on an email conversation thread via the genie’s mailbox. The genie’s automated handling is paused for that thread after a reply is sent, so the human can take over without the genie also responding.`}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource-7`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"agent-mailboxes-self\"`})]})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action-8`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"reply\"`})]})}),`\n`,_jsx(ParamField,{body:`data`,type:`object`,required:true,id:`param-data-14`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`agentId`,type:`string`,required:true,id:`param-agent-id-9`,children:_jsx(_components.p,{children:`UUID of the genie whose mailbox the reply is sent from.`})}),_jsx(ParamField,{body:`conversationId`,type:`string`,required:true,id:`param-conversation-id-1`,children:_jsxs(_components.p,{children:[`Mail system conversation ID (returned in the `,_jsx(_components.code,{children:`conversations`}),` action result).`]})}),_jsx(ParamField,{body:`body_text`,type:`string`,required:true,id:`param-body-text`,children:_jsx(_components.p,{children:`Plain-text body of the reply. Must be non-empty.`})})]})}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success-7`}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,id:`param-data-15`,children:_jsx(_components.p,{children:`Result from the mail system’s reply endpoint. Shape may vary; a successful response indicates the reply was accepted for delivery.`})}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Sending a reply automatically pauses the genie’s handling of that thread. The genie will not respond further unless the thread is manually resumed.`})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`ApiService.invoke()`,numberOfLines:`5`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` result`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agent-mailboxes-self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"reply\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`undefined`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agentId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"550e8400-e29b-41d4-a716-446655440000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` conversationId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"mail-conv-abc123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body_text:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Thanks for reaching out — I'll look into this and follow up shortly.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`12`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`12`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.helpgenie.ai/v1`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer hg_live_YOUR_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resource\": \"agent-mailboxes-self\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"reply\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"data\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agentId\": \"550e8400-e29b-41d4-a716-446655440000\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"conversationId\": \"mail-conv-abc123\",`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"body_text\": \"Thanks for reaching out — I'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\'`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'ll look into this and follow up shortly.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`approve-or-dismiss-a-waiting-reply`,children:`Approve or dismiss a waiting reply`}),`\n`,_jsxs(_components.p,{children:[`When the mailbox’s `,_jsx(_components.code,{children:`operating_mode`}),` is `,_jsx(_components.code,{children:`\"draft_only\"`}),`, each reply the genie writes waits for approval. List waiting conversations with `,_jsx(_components.a,{href:`#list-email-conversations`,children:_jsx(_components.code,{children:`conversations`})}),` and `,_jsx(_components.code,{children:`decisionStatus: \"proposed\"`}),`, then read the conversation with `,_jsx(_components.a,{href:`#get-email-conversation-detail`,children:_jsx(_components.code,{children:`conversation-detail`})}),`: the waiting reply is the decision with `,_jsx(_components.code,{children:`action: \"send\"`}),` and `,_jsx(_components.code,{children:`status: \"proposed\"`}),`, and its `,_jsx(_components.code,{children:`draft_subject`}),`/`,_jsx(_components.code,{children:`draft_body`}),` are what will be sent. Approving or editing sends a real email to the customer from the genie’s mailbox address.`]}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource-8`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"agent-mailboxes-self\"`})]})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action-9`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"decide\"`})]})}),`\n`,_jsx(ParamField,{body:`data`,type:`object`,required:true,id:`param-data-16`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`agentId`,type:`string`,required:true,id:`param-agent-id-10`,children:_jsx(_components.p,{children:`UUID of the genie whose mailbox holds the reply.`})}),_jsx(ParamField,{body:`conversationId`,type:`string`,required:true,id:`param-conversation-id-2`,children:_jsx(_components.p,{children:`Mail system conversation ID.`})}),_jsx(ParamField,{body:`decisionId`,type:`string`,required:true,id:`param-decision-id`,children:_jsxs(_components.p,{children:[`ID of the waiting `,_jsx(_components.code,{children:`send`}),` decision from `,_jsx(_components.code,{children:`conversation-detail`}),`.`]})}),_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action-10`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`\"approve\"`}),` sends the reply as written, `,_jsx(_components.code,{children:`\"edit\"`}),` sends `,_jsx(_components.code,{children:`body`}),` instead, `,_jsx(_components.code,{children:`\"dismiss\"`}),` drops it.`]})}),_jsx(ParamField,{body:`body`,type:`string`,id:`param-body`,children:_jsxs(_components.p,{children:[`Required for `,_jsx(_components.code,{children:`\"edit\"`}),`: the reply to send. Recorded as the owner’s correction, so later replies learn from it.`]})}),_jsx(ParamField,{body:`subject`,type:`string`,id:`param-subject`,children:_jsxs(_components.p,{children:[`Optional with `,_jsx(_components.code,{children:`\"edit\"`}),`: a replacement subject.`]})})]})}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success-8`}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,id:`param-data-17`,children:_jsxs(Expandable,{title:`properties`,children:[_jsxs(ResponseField,{name:`ok`,type:`boolean`,id:`param-ok-2`,children:[_jsx(_components.code,{children:`true`}),` when the reply was sent or dismissed.`]}),_jsxs(ResponseField,{name:`executed`,type:`boolean`,id:`param-executed`,children:[_jsx(_components.code,{children:`true`}),` when the reply was sent.`]})]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Returns `,_jsx(_components.code,{children:`CONFLICT`}),` when the reply was already sent or dismissed, or when the customer wrote again and a newer reply replaced it.`]})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`ApiService.invoke()`,numberOfLines:`7`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agent-mailboxes-self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"decide\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`undefined`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agentId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"550e8400-e29b-41d4-a716-446655440000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` conversationId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"mail-conv-abc123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` decisionId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"6a1f0c2e-3b4d-4e5f-8a9b-0c1d2e3f4a5b\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` action:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"edit\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Hi Sam, yes, we deliver to Taupō on Tuesdays and Fridays.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`13`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.helpgenie.ai/v1`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer hg_live_YOUR_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resource\": \"agent-mailboxes-self\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"decide\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"data\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agentId\": \"550e8400-e29b-41d4-a716-446655440000\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"conversationId\": \"mail-conv-abc123\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"decisionId\": \"6a1f0c2e-3b4d-4e5f-8a9b-0c1d2e3f4a5b\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"approve\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Response`,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"ok\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"executed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`sync-mailbox-status`,children:`Sync mailbox status`}),`\n`,_jsxs(_components.p,{children:[`Inbound callback from the mail system to mirror a status, address, or error change into the local mailbox record. Writes locally only — it never calls back out to the mail system. At least one of `,_jsx(_components.code,{children:`status`}),`, `,_jsx(_components.code,{children:`email_address`}),`, or `,_jsx(_components.code,{children:`last_error`}),` must be provided.`]}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource-9`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"agent-mailboxes-self\"`})]})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action-11`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"sync\"`})]})}),`\n`,_jsx(ParamField,{body:`data`,type:`object`,required:true,id:`param-data-18`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`agentId`,type:`string`,required:true,id:`param-agent-id-11`,children:_jsx(_components.p,{children:`UUID of the genie whose local mailbox row to update.`})}),_jsx(ParamField,{body:`status`,type:`string`,id:`param-status-2`,children:_jsxs(_components.p,{children:[`Updated mailbox status from the mail system. One of `,_jsx(_components.code,{children:`\"pending\"`}),`, `,_jsx(_components.code,{children:`\"provisioned\"`}),`, `,_jsx(_components.code,{children:`\"suspended\"`}),`, `,_jsx(_components.code,{children:`\"failed\"`}),`, or `,_jsx(_components.code,{children:`\"unavailable\"`}),`.`]})}),_jsx(ParamField,{body:`email_address`,type:`string`,id:`param-email-address-2`,children:_jsxs(_components.p,{children:[`Updated provisioned email address, or `,_jsx(_components.code,{children:`null`}),` to clear.`]})}),_jsx(ParamField,{body:`last_error`,type:`string`,id:`param-last-error-2`,children:_jsxs(_components.p,{children:[`Error text to record, or `,_jsx(_components.code,{children:`null`}),` to clear.`]})})]})}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success-9`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`ApiService.invoke()`,numberOfLines:`6`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agent-mailboxes-self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"sync\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`undefined`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agentId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"550e8400-e29b-41d4-a716-446655440000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` status:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"provisioned\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` email_address:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"support-bot@mail.helpgenie.ai\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` last_error:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`13`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.helpgenie.ai/v1`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer hg_live_YOUR_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resource\": \"agent-mailboxes-self\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"sync\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"data\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agentId\": \"550e8400-e29b-41d4-a716-446655440000\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"status\": \"provisioned\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"email_address\": \"support-bot@mail.helpgenie.ai\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"last_error\": null`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`check-mail-credentials-admin-only`,children:`Check mail credentials (admin only)`}),`\n`,_jsx(_components.p,{children:`Verifies that your team’s stored mail service credentials are still valid and active. Use this to diagnose email delivery failures — for example, when the mail service returns authentication errors and you need to confirm whether the credentials have been rotated or revoked.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`This action requires admin privileges. Non-admin callers receive a `,_jsx(_components.code,{children:`FORBIDDEN`}),` error.`]})}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource-10`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"agent-mailboxes-self\"`})]})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action-12`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"check-tenant-key\"`})]})}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success-10`,children:_jsx(_components.p,{children:`Whether the request succeeded.`})}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,id:`param-data-19`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status-3`,children:_jsxs(_components.p,{children:[`Current credential status as reported by the mail service (e.g. `,_jsx(_components.code,{children:`\"active\"`}),`). Returns `,_jsx(_components.code,{children:`\"unknown\"`}),` if the service does not provide a status.`]})}),_jsx(ResponseField,{name:`revokedAt`,type:`string | null`,id:`param-revoked-at`,children:_jsxs(_components.p,{children:[`ISO 8601 timestamp of when the credentials were revoked, or `,_jsx(_components.code,{children:`null`}),` if still active.`]})}),_jsx(ResponseField,{name:`tenantId`,type:`string`,id:`param-tenant-id`,children:_jsx(_components.p,{children:`Your team’s mail tenant identifier.`})})]})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`ApiService.invoke()`,numberOfLines:`3`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` result`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agent-mailboxes-self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"check-tenant-key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`result`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`status`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`); `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// e.g. \"active\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`result`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`revokedAt`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`); `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// null if still valid`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.helpgenie.ai/v1`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer hg_live_YOUR_ADMIN_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resource\": \"agent-mailboxes-self\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"check-tenant-key\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Response`,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"active\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"revokedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"tenantId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"tenant-abc123\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`re-provision-mail-credentials-admin-only`,children:`Re-provision mail credentials (admin only)`}),`\n`,_jsxs(_components.p,{children:[`Reissues your team’s mail service credentials, replacing the current key with a fresh one. Use this when `,_jsx(_components.code,{children:`check-tenant-key`}),` reports that credentials are invalid or revoked.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`This action requires admin privileges. Non-admin callers receive a `,_jsx(_components.code,{children:`FORBIDDEN`}),` error.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Re-provisioning invalidates the current credentials immediately. Any in-flight requests using the old key will fail until they re-authenticate. Only call this when `,_jsx(_components.code,{children:`check-tenant-key`}),` confirms the existing credentials are no longer valid.`]})}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource-11`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"agent-mailboxes-self\"`})]})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action-13`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"reprovision-tenant-key\"`})]})}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success-11`,children:_jsx(_components.p,{children:`Whether the request succeeded.`})}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,id:`param-data-20`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ResponseField,{name:`tenantId`,type:`string`,id:`param-tenant-id-1`,children:_jsx(_components.p,{children:`Your team’s mail tenant identifier (unchanged after re-provisioning).`})})})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`ApiService.invoke()`,numberOfLines:`2`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` result`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agent-mailboxes-self\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"reprovision-tenant-key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`result`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`tenantId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.helpgenie.ai/v1`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer hg_live_YOUR_ADMIN_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resource\": \"agent-mailboxes-self\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"reprovision-tenant-key\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Response`,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"tenantId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"tenant-abc123\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`error-codes`,children:`Error codes`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`UNAUTHORIZED`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:`Caller does not own the specified genie`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`FORBIDDEN`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:`Admin-only action called by a non-admin`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOT_FOUND`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:`Genie, mailbox, mail credentials, or waiting reply not found`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`CONFLICT`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`decide`}),` on a reply that was already sent, dismissed, or replaced by a newer one`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`VALIDATION_ERROR`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[`Missing `,_jsx(_components.code,{children:`agentId`}),`, `,_jsx(_components.code,{children:`conversationId`}),`, `,_jsx(_components.code,{children:`decisionId`}),`, or `,_jsx(_components.code,{children:`body_text`}),`; invalid `,_jsx(_components.code,{children:`desiredLocalpart`}),`; no update fields provided; invalid `,_jsx(_components.code,{children:`escalation_address`}),`; invalid `,_jsx(_components.code,{children:`test_mode`}),`, `,_jsx(_components.code,{children:`attach_resources`}),`, `,_jsx(_components.code,{children:`operating_mode`}),` or `,_jsx(_components.code,{children:`skip_forward_ack`}),`; invalid `,_jsx(_components.code,{children:`decide`}),` action, missing `,_jsx(_components.code,{children:`body`}),` for `,_jsx(_components.code,{children:`edit`}),`, or `,_jsx(_components.code,{children:`approve`}),` on an empty draft (an escalation whose suggested reply couldn’t be drafted); or mailbox already exists when no rename is requested`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_ACTION`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:`Unknown action`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INTERNAL_ERROR`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsx(_components.td,{children:`Mail system error or local sync failure`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Genie mailbox (self)","description":"Owner-facing provisioning and management of your genie's email inbox","href":"/api-reference/agent-mailboxes-self"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Get mailbox","slug":"get-mailbox","depth":2,"children":[]},{"title":"Provision mailbox","slug":"provision-mailbox","depth":2,"children":[]},{"title":"Update mailbox","slug":"update-mailbox","depth":2,"children":[]},{"title":"Delete mailbox","slug":"delete-mailbox","depth":2,"children":[]},{"title":"Send test email","slug":"send-test-email","depth":2,"children":[]},{"title":"List email conversations","slug":"list-email-conversations","depth":2,"children":[]},{"title":"Get email conversation detail","slug":"get-email-conversation-detail","depth":2,"children":[]},{"title":"Reply to a conversation","slug":"reply-to-a-conversation","depth":2,"children":[]},{"title":"Approve or dismiss a waiting reply","slug":"approve-or-dismiss-a-waiting-reply","depth":2,"children":[]},{"title":"Sync mailbox status","slug":"sync-mailbox-status","depth":2,"children":[]},{"title":"Check mail credentials (admin only)","slug":"check-mail-credentials-admin-only","depth":2,"children":[]},{"title":"Re-provision mail credentials (admin only)","slug":"re-provision-mail-credentials-admin-only","depth":2,"children":[]},{"title":"Error codes","slug":"error-codes","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"helpgenie","siteName":"Help Genie","title":"Genie mailbox (self) - Help Genie","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T11:46:01.829Z","originalFileLocation":"api-reference/agent-mailboxes-self.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Owner-facing provisioning and management of your genie\u0026#x27;s email inbox\">\u003cmeta data-mint-head name=\"application-name\" content=\"Help Genie\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Genie mailbox (self) - Help Genie\">\u003cmeta data-mint-head property=\"og:description\" content=\"Owner-facing provisioning and management of your genie\u0026#x27;s email inbox\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Help Genie\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.helpgenie.ai/api-reference/agent-mailboxes-self\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://helpgenie.mintlify.site/_mintlify/api/og/v2?division=Expanded+Platform\u0026amp;title=Genie+mailbox+%28self%29\u0026amp;description=Owner-facing+provisioning+and+management+of+your+genie%27s+email+inbox\u0026amp;theme=fc0888b7de96c166e1873963\u0026amp;signature=6229221db24ed0b868aff2fbc0300f4d3af42feded37ac3e55b95b6c99809ac7\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Genie mailbox (self) - Help Genie\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Owner-facing provisioning and management of your genie\u0026#x27;s email inbox\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://helpgenie.mintlify.site/_mintlify/api/og/v2?division=Expanded+Platform\u0026amp;title=Genie+mailbox+%28self%29\u0026amp;description=Owner-facing+provisioning+and+management+of+your+genie%27s+email+inbox\u0026amp;theme=fc0888b7de96c166e1873963\u0026amp;signature=6229221db24ed0b868aff2fbc0300f4d3af42feded37ac3e55b95b6c99809ac7\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Help Genie\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4E9CFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.helpgenie.ai/api-reference/agent-mailboxes-self\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/agent-mailboxes-self.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.helpgenie.ai/#organization\",\"name\":\"Help Genie\",\"url\":\"https://docs.helpgenie.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/helpgenie/a134Jyg1BOpqw0vP/logo/light.png?fit=max\u0026auto=format\u0026n=a134Jyg1BOpqw0vP\u0026q=85\u0026s=f29d097a201254a8a750843d0d692c50\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.helpgenie.ai#website\",\"name\":\"Help Genie\",\"url\":\"https://docs.helpgenie.ai\",\"publisher\":{\"@id\":\"https://docs.helpgenie.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.helpgenie.ai/api-reference/agent-mailboxes-self#webpage\",\"url\":\"https://docs.helpgenie.ai/api-reference/agent-mailboxes-self\",\"name\":\"Genie mailbox (self)\",\"description\":\"Owner-facing provisioning and management of your genie's email inbox\",\"dateModified\":\"2026-11-13T11:46:01.829Z\",\"isPartOf\":{\"@id\":\"https://docs.helpgenie.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.helpgenie.ai/api-reference/agent-mailboxes-self#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.helpgenie.ai/api-reference/agent-mailboxes-self#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Expanded Platform\",\"item\":\"https://docs.helpgenie.ai/api-reference/analytics\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Genie mailbox (self)\",\"item\":\"https://docs.helpgenie.ai/api-reference/agent-mailboxes-self\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.helpgenie.ai/api-reference/agent-mailboxes-self#article\",\"headline\":\"Genie mailbox (self)\",\"name\":\"Genie mailbox (self)\",\"description\":\"Owner-facing provisioning and management of your genie's email inbox\",\"url\":\"https://docs.helpgenie.ai/api-reference/agent-mailboxes-self\",\"mainEntityOfPage\":{\"@id\":\"https://docs.helpgenie.ai/api-reference/agent-mailboxes-self#webpage\"},\"dateModified\":\"2026-11-13T11:46:01.829Z\",\"publisher\":{\"@id\":\"https://docs.helpgenie.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.helpgenie.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Help Genie\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Help Genie\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/agent-mailboxes-self.md","siteName":"Help Genie","nav":{"global":{"anchors":[{"anchor":"Help Genie Voice","icon":"microphone","href":"https://helpgenie.ai"},{"anchor":"Help Genie Mail","icon":"envelope","href":"https://mail.helpgenie.ai"},{"anchor":"Help Genie Outbound","icon":"phone","href":"https://outbound.helpgenie.ai"},{"anchor":"Help Genie Sync","icon":"arrows-rotate","href":"https://sync.helpgenie.ai"}]},"tabs":[{"tab":"Getting started","icon":"compass","pages":[{"title":"Getting started","href":""}]},{"tab":"API reference","icon":"code","groups":[{"group":"Overview","pages":[{"title":"API reference","href":"/api-reference/introduction"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Making requests","href":"/api-reference/making-requests"},{"title":"Error handling","href":"/api-reference/errors"}]},{"group":"Public (unauthenticated)","pages":[{"title":"Public Genies","href":"/api-reference/public-genies"},{"title":"Public Help Hub","href":"/api-reference/public-help-hub"},{"title":"Activation (Public)","href":"/api-reference/activation"},{"title":"Help Hub","href":"/api-reference/help-hub"}]},{"group":"Agents","pages":[{"title":"Genies","href":"/api-reference/genies"},{"title":"Genie groups","href":"/api-reference/genie-groups"},{"title":"Conversations","href":"/api-reference/conversations"},{"title":"Genie Meetings","href":"/api-reference/genie-meetings"}]},{"group":"Knowledge","pages":[{"title":"Knowledge base","href":"/api-reference/knowledge-base"},{"title":"Knowledge Recommendations","href":"/api-reference/knowledge-recommendations"},{"title":"Document folders","href":"/api-reference/document-folders"},{"title":"Genie Documents","href":"/api-reference/genie-documents"}]},{"group":"CRM","pages":[{"title":"Leads","href":"/api-reference/leads"}]},{"group":"Marketplace","pages":[{"title":"Marketplace","href":"/api-reference/marketplace"}]},{"group":"Platform","pages":[{"title":"Profiles","href":"/api-reference/profiles"},{"title":"Teams","href":"/api-reference/teams"},{"title":"Activities","href":"/api-reference/activities"},{"title":"Goals","href":"/api-reference/goals"},{"title":"API keys","href":"/api-reference/api-keys"}]},{"group":"Telephony","pages":[{"title":"Phone numbers","href":"/api-reference/phone-numbers"},{"title":"QR codes","href":"/api-reference/qr-code"}]},{"group":"Worker genies","pages":[{"title":"Worker genies","href":"/api-reference/worker-genies"}]},{"group":"Quality \u0026 Compliance","pages":[{"title":"Brand Integrity","href":"/api-reference/brand-integrity"}]},{"group":"Access Control","pages":[{"title":"Genie Access","href":"/api-reference/genie-access"}]},{"group":"Intelligence","pages":[{"title":"Insights","href":"/api-reference/insights"}]},{"group":"Education","pages":[{"title":"Learn","href":"/api-reference/learn"}]},{"group":"Voice","pages":[{"title":"Voices","href":"/api-reference/voices"},{"title":"Voice collections","href":"/api-reference/voice-collections"},{"title":"Preselected voices","href":"/api-reference/preselected-voices"},{"title":"Pronunciation Vaults","href":"/api-reference/pronunciation-vaults"}]},{"group":"Integrations","pages":[{"title":"Context Sources","href":"/api-reference/context-sources"},{"title":"Escalation Webhooks","href":"/api-reference/escalation-webhooks"},{"title":"Chat channels","href":"/api-reference/chat-channels"},{"title":"MCP connections","href":"/api-reference/mcp-connections"}]},{"group":"Expanded Platform","pages":[{"title":"Analytics","href":"/api-reference/analytics"},{"title":"Billing","href":"/api-reference/billing"},{"title":"Branding","href":"/api-reference/branding"},{"title":"Portals","href":"/api-reference/portals"},{"title":"Activation Packs","href":"/api-reference/activation-packs"},{"title":"Print Orders","href":"/api-reference/print-orders"},{"title":"Playbooks","href":"/api-reference/playbooks"},{"title":"Demo Genies","href":"/api-reference/demo-genies"},{"title":"Email Templates","href":"/api-reference/email-templates"},{"title":"Email Logs","href":"/api-reference/email-logs"},{"title":"System Emails","href":"/api-reference/system-emails"},{"title":"Generate Logo","href":"/api-reference/generate-logo"},{"title":"Capabilities","href":"/api-reference/capabilities"},{"title":"Agent mailboxes","description":"Admin management of genie email inbox provisioning state","href":"/api-reference/agent-mailboxes"},{"title":"Genie mailbox (self)","href":"/api-reference/agent-mailboxes-self"},{"title":"Mail tenant credentials","description":"Admin-only callback endpoint for the mail system to register or rotate tenant credentials for a Voice team","href":"/api-reference/mail-tenant-credentials"}]}]},{"tab":"Voice","icon":"microphone","pages":[{"title":"Voice","href":"/voice-guide/my-genies-list"}]},{"tab":"Mail","icon":"envelope","pages":[{"title":"Mail","href":"/mail-guide/introduction"}]},{"tab":"Outbound","icon":"phone","pages":[{"title":"Outbound","href":"/outbound-guide/introduction"}]},{"tab":"Sync","icon":"arrows-rotate","pages":[{"title":"Sync","href":"/sync-guide/introduction"}]}]},"basePath":"","title":"Genie mailbox (self) - Help Genie","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}