cancel_campaign
ChatGPTCancels the remaining work of a campaign. Calls already connected and finished dials are not canceled. execution_key is optional; calling again with the same key returns the earlier result. If the outcome cannot be confirmed it returns EXECUTION_RESULT_UNKNOWN.
create_agent_version
ChatGPTSaves the agent's current configuration (agent_data/flow_data) as a new version. Linked manual bodies are not snapshotted and nothing is published to production. Sending the agent's current head_revision as payload.expected_head_revision rejects the call with 409 if the configuration changed meanwhile.
create_knowledge
ChatGPTCreates an empty knowledge base. Ingesting documents and attaching it to agents are separate actions.
create_sheet
ChatGPTCreates a product sheet with phone targets and dynamic-variable rows. It does not run a campaign by itself.
create_voice_model
ChatGPTDownloads a public HTTPS audio clip (wav, mp3, m4a, up to 6 MB) and creates an organization-private voice clone model. Local file upload is not supported. Needs consent_confirmed=true (the speaker's own consent) and consumes the organization's voice-clone quota.
delete_knowledge_document
ChatGPTRemoves exactly one document from a knowledge base. Not the same as deleting the whole knowledge base.
find_customer
ChatGPTLooks up a customer by supported identifier. Returns found=false, data=null if none matches; never creates one.
get_agent
ChatGPTReads an agent's current, production or saved vN configuration by agent_id. Not an immutable snapshot of linked resources such as manuals.
get_agent_template
ChatGPTReads one Single template by template ID. Flow templates are not supported in this public contract.
get_call
ChatGPTReads a call's status, agent version and result by call_id. The transcript is included only when include_transcript=true. The manual text used during the call is not in the response.
get_campaign
ChatGPTReads a campaign's settings, targets and progress by campaign ID. Distinguishes acceptance of the run from final call results.
get_customer
ChatGPTReads a customer's current attributes and identifiers by customer ID.
get_customer_attribute_definition
ChatGPTReads one customer attribute definition by ID.
get_manual
ChatGPTReads the full content and head_revision of an agent-owned manual by agent_id and manual_id.
get_number
ChatGPTReads a phone number's detail and status by kind and that kind's ID. ID schemes differ per kind: general uses organization_telephone_number_id, uan uses uan_telephone_id, presentation uses telephone_presentation_number_id.
get_organization
ChatGPTReads the connected organization's basic settings and the subscription summary the API returns. Only a parent organization has subscription information.
get_schema
ChatGPTReads a product input schema by exact namespace and schema_type. namespace=contract returns pieces of this server's tool input schemas: schema_type is a tool name or <tool>#<section>.
get_sheet
ChatGPTReads a sheet's target rows and dynamic variables by sheet ID.
get_tool
ChatGPTReads a product tool's settings and input definition by tool ID. Secrets such as auth headers are masked in the MCP result and model context. Does not execute the tool.
import_knowledge_documents
ChatGPTRequests ingestion of text or a web page URL through the existing document registration API. File upload is not supported. Failures and partial results are not hidden.
inject_call_context
ChatGPTPuts a text fact into the agent of an ongoing call; the agent uses it as system data in later replies, never as caller speech. payload.response: none (default) only remembers it; when_idle speaks once when the call is quiet (1.5 s grace after the agent stops); interrupt_agent cuts the agent's current speech and answers now (joins the caller's turn if they are speaking; non-interruptible speech or a running tool finishes first). expires_in_seconds (1-180, default 90; when_idle/interrupt_agent only) bounds when that reply may start. 202 accepted means delivered to the call only; the outcome arrives in the call_context webhook by control_id.
instantiate_agent_template
ChatGPTValidates a Single template ID and creates the agent, referenced tools and manuals through existing APIs. Does not publish automatically and does not hide partial results of a failed creation.
launch_campaign
ChatGPTCreates AND launches a campaign (not a draft). execution_key is required; calling again with the same key returns the earlier result instead of creating a new campaign. If the outcome cannot be confirmed it returns EXECUTION_RESULT_UNKNOWN and does not rerun automatically.
list_agent_templates
ChatGPTLists Single starter templates. The API filter type=single_prompt is fixed.
list_agent_versions
ChatGPTLists an agent's saved versions. Does not guarantee past manual bodies of currently linked manuals.
list_agents
ChatGPTLists agents by q (name search), type, sort order and cursor page, returning each agent's exact agent_id. Includes Single and Flow agents.
list_calls
ChatGPTLists and filters organization calls with their actual status, to find targets for improvement or operations.
list_campaigns
ChatGPTLists voice campaigns with their actual status.
list_customer_attribute_definitions
ChatGPTLists customer attribute definitions.
list_customers
ChatGPTSearches customers to get an exact customer ID.
list_knowledge_documents
ChatGPTLists a knowledge base's documents and their ingestion/indexing status. Distinguishes accepted from usable.
list_knowledges
ChatGPTLists knowledge base IDs and names. Does not include per-document processing status.
list_manuals
ChatGPTLists the manuals of one agent with the current head_revision. Not an organization-wide list and not a cursor page.
list_models
ChatGPTLists models one API page at a time with kind=llm or kind=voice. For LLM items model is the routing-group key stored in agent settings and may differ from display_name. featured=true is vox-recommended, a lower display_order ranks first, and deprecated=true is not recommended.
list_numbers
ChatGPTReads one page of owned numbers; kind selects general, uan (main number) or presentation (caller ID) numbers.
list_organization_members
ChatGPTLists the connected organization's members. Does not send invitations, change roles or reveal credentials.
list_organizations
ChatGPTLists the organizations this connection's account belongs to and the current active organization. Each item has organization_id, name, role and whether it is current; switchable says whether this connection can change organization. The starting organization is chosen automatically. Embedded and API-key connections return only their fixed current organization.
list_schemas
ChatGPTLists product input schemas by namespace and category.
list_sheets
ChatGPTLists the organization's product sheets. Does not mean external storage such as Google Sheets.
list_tools
ChatGPTLists tool definitions agents can call. A different resource from the MCP tools/list.
pause_campaign
ChatGPTPauses later dials of a campaign. Does not guarantee ending calls that are already connected. execution_key is optional; calling again with the same key returns the earlier result. If the outcome cannot be confirmed it returns EXECUTION_RESULT_UNKNOWN.
place_call
ChatGPTPlaces a real phone call. Accepted != connected or successful. Needs from_number, to_number and routing (explicit_agent requires agent; phone_default must not send it and follows the number's traffic split or default outbound agent). execution_key is required; calling again with the same key returns the earlier result instead of dialing again. If the outcome cannot be confirmed it returns EXECUTION_RESULT_UNKNOWN and does not redial automatically.
publish_agent_version
ChatGPTMakes an existing agent version the production version. Affects that production path; not an immutable publish of all dependencies. Sending the last-read production version as payload.expected_production_version blocks concurrent publishes with 409.
resolve_customer
ChatGPTFinds a customer by identifiers and creates one if none exists (a write). Follows the existing identifier merge and conflict rules.
resume_campaign
ChatGPTResumes a campaign and continues real dials to the remaining targets. execution_key is required; calling again with the same key returns the earlier result. If the outcome cannot be confirmed it returns EXECUTION_RESULT_UNKNOWN and does not rerun automatically.
save_agent
ChatGPTCreates an agent (mode=create) or updates its current configuration (mode=update; requires agent_id and payload.expected_head_revision). type is single_prompt (default) or flow and is fixed at create. update replaces each config group it sends, and sending flow replaces the whole graph (send expected_flow_revision as well); a stale revision is rejected with 409. Create merges a partial data with server defaults, and a flow without a graph gets a default begin->conversation->endCall graph. Never publishes. The result may carry authoring_checks.
save_customer
ChatGPTStores a customer record's attributes and identifiers with explicit create or update (update requires customer_id). Distinct from customer merge. PATCH: omit = keep; null = clear where allowed.
save_customer_attribute_definition
ChatGPTCreates or updates a customer attribute definition (update requires definition_id). Keeps the impact of real definition changes and the existing API validation.
save_manual
ChatGPTCreates (mode=create) or updates (mode=update; requires manual_id) an agent-owned manual. A manual = name + trigger (the caller situation that loads it) + content. In content, @manual:{manual_id} hands off to another manual, @tool:{name} calls a built-in tool owned by the manual, @tool:{tool_id} calls an org API tool (UUID). payload.expected_head_revision (the agent's head_revision) is required; a stale value is rejected with 409. Do not auto-retry conflicts or unknown results. The result may carry authoring_checks.
save_tool
ChatGPTCreates (mode=create) or updates (mode=update; requires tool_id) a product tool definition. Only stores the definition; never runs the external tool. The tool description is what the call-time LLM uses to decide when to call it. Sending the masked string (********) as a secret is rejected. PATCH: omit = keep; null = clear where allowed.
set_number_agents
ChatGPTUpdates the agent connections of a general number or a presentation (caller ID) number. Main numbers are not targets. kind=general requires organization_telephone_number_id; kind=presentation requires telephone_presentation_number_id. PATCH: omit = keep; null = clear where allowed.
set_organization
ChatGPTSwitches the active organization of this connection by organization_id. Applies to every conversation using this connection and to all later tool calls. Only organizations the account belongs to can be chosen; embedded and API-key connections cannot switch.
update_number
ChatGPTUpdates metadata of a general number, or the forwarding target and memo of a main (uan) number, through the per-kind API. Does not change SIP settings or agent connections of general or presentation numbers. kind=general requires organization_telephone_number_id; kind=uan requires uan_telephone_id. PATCH: omit = keep; null = clear where allowed.
update_organization
ChatGPTUpdates the organization settings the API allows. Does not create or switch organizations or grant arbitrary permissions. PATCH: omit = keep; null = clear where allowed.
validate_flow
ChatGPTValidates a flow graph without saving it (Flow agents only). level=critical (default) returns blocking errors, runtime returns non-blocking advisories, all returns both; use level=all before the first save. valid=true means the graph can be saved. Pass agent_id to check an update to that existing agent.