account_overview
ChatGPTSummarize a workspace: wallet balance, usage totals with up to 10 line items, and for agents, numbers, number requests, calls and SMS conversations the total count plus up to 5 newest items with identifying fields only. Each section reports total, returned, has_more, items too large to preview (omitted), and list_tool, the tool on this connection that returns complete records (null when there is none; it requires its own scope). SMS message content is never included. The result is at most 25,000 characters.
add_contacts
ChatGPTAppend rows to an existing contact list (at most 10,000 per call). Duplicates within the list are skipped.
add_do_not_call
ChatGPTAdd numbers to the workspace do-not-call register. Every outbound path refuses them from then on.
attach_sip_connection_number
ChatGPTBring your own SIP trunk: create, read or change a carrier SIP connection and its numbers through the same service as /v1/sip-connections. Passwords are write-only and never returned. Attaching a number for incoming calls, and check_sip_connection_number_ownership, place one Skysay verification call to that number (rate limited per number and per workspace); outbound with the number is refused until its ownership is confirmed. start_sip_connection_test_call places one billed call (calls:write) from the number to the given phone; check_sip_connection_reachability sends one SIP OPTIONS to the carrier server. No carrier settings change.
authorize_outbound
ChatGPTPreflight a call/SMS against the pre-dial gates (allowed|blocked|needs_review) before placing it. For a voice call it asks both questions create_outbound_call meets, in order: the workspace capabilities (destination country -- per-org allowlist plus an always-on high-risk-country hard block -- channel, profile, caps), then the per-call policy (purpose, user_authorization with authorized_by AND reason, caller-number readiness). With from_number_id it first asks that number's own Number rules (caller ID allowed, allowed_countries covers the destination; stage outbound_number_rules). stage names the gate that answered. Not a full admission: the number's allowed_agents, concurrency and the wallet reserve are not checked. Read-only; no reserve, charge, or review row is written.
cancel_campaign
ChatGPTCancel a campaign: queued calls are cancelled, remaining contacts are skipped.
cancel_simulation_run
ChatGPTCancel a queued or running simulation run. Attempts already finished keep their results; nothing further is queued or charged.
check_agent_deletion
ChatGPTRead the current dependencies preventing deletion. This check does not reserve deletion; delete_agent checks again atomically.
check_number_requirements
ChatGPTReturn country and number-type onboarding requirements in plain terms.
check_sip_connection_number_ownership
ChatGPTBring your own SIP trunk: create, read or change a carrier SIP connection and its numbers through the same service as /v1/sip-connections. Passwords are write-only and never returned. Attaching a number for incoming calls, and check_sip_connection_number_ownership, place one Skysay verification call to that number (rate limited per number and per workspace); outbound with the number is refused until its ownership is confirmed. start_sip_connection_test_call places one billed call (calls:write) from the number to the given phone; check_sip_connection_reachability sends one SIP OPTIONS to the carrier server. No carrier settings change.
check_sip_connection_reachability
ChatGPTBring your own SIP trunk: create, read or change a carrier SIP connection and its numbers through the same service as /v1/sip-connections. Passwords are write-only and never returned. Attaching a number for incoming calls, and check_sip_connection_number_ownership, place one Skysay verification call to that number (rate limited per number and per workspace); outbound with the number is refused until its ownership is confirmed. start_sip_connection_test_call places one billed call (calls:write) from the number to the given phone; check_sip_connection_reachability sends one SIP OPTIONS to the carrier server. No carrier settings change.
connect_external_agent
ChatGPTShortcut for creating an external_audio agent with webhook and audio stream URLs.
create_agent
ChatGPTCreate a first-class Skysay agent in external_audio, external_text, or hosted mode. Hosted agents can choose a shared stack and selected languages; locale overrides remain draft data until the explicit voice-stack publish command. An engine whose agent-catalog row says has_language_axis false (a voice-to-voice engine) refuses languages, language_profiles and follow_caller with a 400 naming the field and the engine.
create_campaign
ChatGPTCreate a draft outbound campaign: agent, caller-id numbers, contact list, purpose, consent_basis (existing_customer | explicit_consent), calling windows, retry policy (or a preset: sales, collections, single_attempt), concurrency and optional schedule. It starts only when launched with launch_campaign.
create_contact_list
ChatGPTCreate a contact list in the workspace, optionally with rows (phone_e164, name, first_name, language, time_zone, external_reference, variables). Returns a per-row import report; invalid rows are reported, never fail the list.
create_outbound_call
ChatGPTCreate a policy-gated outbound call request. purpose is required and free-form (see the purpose property description for the advisory catalog); recipient_type is optional and recorded, never enforced; destination country is authorized against the org's workspace capabilities.
create_pbx_key
ChatGPTCreate an independently revocable named PBX key. Returns its password once; store it securely.
create_phone_server
ChatGPTCreate a customer phone server for self-hosted media/calling. test_phone_server dry-run verifies it.
create_simulation_suite
ChatGPTCreate a simulation suite on an AI agent, optionally with its whole scenario list in one call -- this is how a scenario pack becomes a suite. Each scenario names its own runner: deterministic and adaptive_chat run offline, adaptive_voice runs the full spoken scenario and is admitted only where the voice runtime is on. An adaptive_voice scenario may pin caller_environment as synthetic caller-input noise with noise_level; it is not the agent's outgoing ambience/volume setting.
create_trial_call
ChatGPTCreate an offline synthetic trial call fixture (synthetic_only must be true). It places no phone call; live shared-number PIN trials are retired.
delete_agent
ChatGPTPermanently remove one unused AI agent from active configuration. Refuses numbers, routes or unfinished work. Retains historical calls, transcripts and billing; does not cancel numbers or modify sibling AI agents. Ask the user to confirm before calling.
delete_campaign
ChatGPTDelete a draft, held, blocked, completed or cancelled campaign: it leaves the campaign listings; its calls, recordings, transcripts and billing records are kept. A launching, scheduled, running or paused campaign must be cancelled first (409 campaign_active); a repeat answers 404. Ask the user to confirm before calling.
delete_simulation_suite
ChatGPTPermanently delete a simulation suite that has never had a run. Requires its current revision. Suites with run history must be archived through the suite API instead.
duplicate_agent
ChatGPTCreate an independent stopped copy of the latest saved authoring configuration, without publication or execution history. Reuse request_key and name after an uncertain result. Connection secrets are available only through the workspace or authenticated REST response, never this tool.
enroll_campaign_contacts
ChatGPTAdd contacts to a scheduled, running or paused campaign (at most 10,000 per call): they join the campaign's own contact list and its queue in one step and are called inside their calling hours. Idempotent: a contact already in the queue is not added again. Refused when the campaign is a draft, completed or cancelled, or when the audience with these contacts would need review (for example a new destination country).
evaluate_outbound_policy
ChatGPTEvaluate outbound voice/SMS policy before creating a call. purpose is required and free-form -- never refused for being novel, only for being empty. recipient_type is optional/recorded. Destination country is governed by the org's workspace capabilities, not by this evaluation.
get_agent
ChatGPTGet one authenticated-workspace agent using the same safe REST agent projection.
get_agent_catalog
ChatGPTList selectable STT/LLM/TTS voice-stack providers with cost, latency, languages, streaming, and runnability, plus conversation_engines (cascade default, gpt_live, gemini_live), each row carrying has_language_axis: false for a voice-to-voice engine that has no language set, per-language overrides or Follow the caller. Requires agents:read or coverage:read. Filter by component, language (e.g. language=et surfaces the single Estonian TTS; language=si surfaces the single Sinhala STT/TTS pair), and metered_only.
get_agent_public_link
ChatGPTRead an AI agent's public link settings and optionally check a proposed URL address.
get_agent_variables
ChatGPTRead an AI agent's call variables config (declared variables, SMS templates, SMS mode, caller lookup), with the revision a write must name and the schema_hash a call admitted now carries. The same answer as GET /v1/agents/{agent_id}/variables.
get_agent_voice_stack
ChatGPTGet one authenticated-workspace agent's selected stack and sparse language profiles using the REST voice-stack projection.
get_call
ChatGPTGet call status, recording state, and where its conversation workflow ended (outcome, interrupts taken, settled).
get_call_recording
ChatGPTGet recording metadata and disclosure state.
get_call_summary
ChatGPTGet the AI summary of a call, read with the transcript's scope: a 1-3 sentence summary, whether a follow-up is needed, whether the agent's goal was met (judged against its call goal, else its instructions) and the other party's sentiment. Every field is an AI estimate. status is ready, pending, failed, skipped (reason no_conversation or insufficient_transcript) or not_available.
get_call_transcript
ChatGPTGet call transcript turns. events lists, with no text, each moment the other party spoke on a voice-to-voice call and the engine answered but gave no caption for it; an empty events never means the other party was silent.
get_call_translations
ChatGPTRead cached machine translations for a call. No paid work is created.
get_campaign
ChatGPTRead one campaign with its latest run and contact counters.
get_capabilities
ChatGPTReturn the workspace's capabilities record, the available use-case profiles, and live usage vs caps.
get_contact_list
ChatGPTRead one contact list of the workspace by id (the REST contact-list record, with row_count). Use list_contacts to read its rows.
get_coverage
ChatGPTList supported countries with voice, SMS, registration, and onboarding speed.
get_highlevel_call_outcome
ChatGPTUse a specific administrator-approved HighLevel contact and its original installation. Never invent or replace approval, location or contact IDs. Starting places one ordinary billed Skysay call after current opt-out and admission checks; retries return that same call. Outcome returns only its callId/state/status.
get_message_translations
ChatGPTRead cached machine translations for an SMS. No paid work is created.
get_number_catalog
ChatGPTList available number offerings with customer setup/monthly prices, capabilities, and onboarding terms.
get_number_rules
ChatGPTGet customer-facing Number rules for one phone number.
get_simulation_run
ChatGPTOne run's status and its attempts: per-scenario verdicts, assertion results, recognition facts, transcripts and evidence references. Paginated over attempts. Read-only; needs agents:read. Transcript, recording references and conversation evidence are included only with recordings:read.
get_simulation_run_results
ChatGPTThe same run as a redacted, versioned pass/fail projection for a build server: per-case status, error codes, failed assertions and which evidence kind exists -- no transcript, no recording reference, no rubric rationale. Needs only simulation_suites:read, so a CI job can gate a deploy on a run without holding a key that reads every AI agent's configuration. Read-only.
get_simulation_suite
ChatGPTOne simulation suite: its authored scenarios and their runners, its policy, its run history, and run_setup -- which reports supported_runners, the runners THIS deployment admits; starting a run with any other runner is refused with a 422. Read-only.
get_sip_connection
ChatGPTBring your own SIP trunk: create, read or change a carrier SIP connection and its numbers through the same service as /v1/sip-connections. Passwords are write-only and never returned. Attaching a number for incoming calls, and check_sip_connection_number_ownership, place one Skysay verification call to that number (rate limited per number and per workspace); outbound with the number is refused until its ownership is confirmed. start_sip_connection_test_call places one billed call (calls:write) from the number to the given phone; check_sip_connection_reachability sends one SIP OPTIONS to the carrier server. No carrier settings change.
hangup_call
ChatGPTAsk a call that is already live to hang up. Returns immediately with hangup_requested_at and never reports the call as ended: the media worker holding the call tears it down, and the call reaches its terminal event through the ordinary path. Repeating the request is idempotent and returns the original timestamp. A call still queued for origination is refused.
launch_campaign
ChatGPTAuthorize and start a draft campaign. Existing-customer / consented lists on active workspace capabilities start immediately; the result carries the authorization decision.
list_agent_public_link_recording_candidates
ChatGPTList one newest-first page of an AI agent's calls that could be shared as recorded conversations on its public link, with who was on each call, its length, its first transcript line, and why it cannot be shared yet when it cannot. next_cursor continues the listing while has_more is true.
list_agents
ChatGPTList one bounded, newest-first page of the authenticated workspace's agents. The result uses the same safe agent item DTO as REST and returns pagination metadata; next_cursor continues the listing and is meaningful only while has_more is true. A page holds at most limit agents and at most 25,000 characters, so it can hold fewer; an agent too large for any page is named in pagination.omitted with the tool that reads it.
list_audio_environments
ChatGPTList the immutable, provider-independent audio-environment catalogue. It contains an explicit Off option and version-pinned ambience presets; no provider is contacted and no selection is changed. Agent output uses volume; Simulation Lab caller input uses the separate noise_level field.
list_calls
ChatGPTList one bounded, newest-first page of the workspace's calls. Each item is the REST call record without runtime_config (the agent configuration the call ran with); get_call returns the full record. A page holds at most limit calls and at most 25,000 characters, so it can hold fewer; pagination.next_cursor continues the listing and is meaningful only while pagination.has_more is true. A call too large for any page is named in pagination.omitted.
list_campaign_contact_attempts
ChatGPTRead one contact's timeline in a campaign: every attempt in order with its kind (first_contact, retry, callback, reopened), result, call id and what the campaign decided next (retry, callback, deferred or finished, and when). Bounded page; contact_id is the id of a campaign contact row. Values the campaign did not record are null.
list_campaigns
ChatGPTList campaigns in the workspace with their latest run and counters (bounded page).
list_close_contacts
ChatGPTUse an existing administrator-connected Close CRM organization. Never invent contact, lead or phone IDs. List contacts (25 per page, newest first) before selecting an exact phone. start_close_call places one billed Skysay AI call only with the user's explicit authorization; reuse request_key after uncertain results. Finished calls are logged to Close with their true status, AI summary and authenticated Skysay recording/transcript link. log_close_call exports an existing finished inbound or outbound call whose phone matches the selected contact. This sends call information to Close. An unconfirmed delivery may already exist remotely and is never automatically replayed. No SMS synchronization or Close dialer replacement.
list_contact_lists
ChatGPTList one bounded, newest-first page of the workspace's contact lists (id, name, project, source, row_count, timestamps), using the REST contact-list record. A page holds at most limit lists and at most 25,000 characters; pagination.next_cursor continues the listing and is meaningful only while pagination.has_more is true.
list_contacts
ChatGPTList one bounded page of a contact list's contacts in import order (phone_e164, name, first_name, language, time_zone, country, variables, external_reference, consent_basis), using the REST contact record. A page holds at most limit contacts and at most 25,000 characters, so it can hold fewer; pagination.next_cursor continues the listing while pagination.has_more is true. A contact too large for any page is named in pagination.omitted.
list_conversations
ChatGPTList SMS conversations.
list_numbers
ChatGPTList one bounded, newest-first page of the workspace's phone numbers with registration status, using the REST number record. A page holds at most limit numbers and at most 25,000 characters, so it can hold fewer; pagination.next_cursor continues the listing and is meaningful only while pagination.has_more is true. A number too large for any page is named in pagination.omitted.
list_pbx_keys
ChatGPTList a workspace AI agent's named PBX keys, never passwords; bounded by limit/offset with has_more.
list_phone_servers
ChatGPTList customer phone servers for self-hosted media/calling.
list_simulation_suites
ChatGPTList an AI agent's simulation suites with the health of each one's latest run. Read-only.
list_sip_connections
ChatGPTBring your own SIP trunk: create, read or change a carrier SIP connection and its numbers through the same service as /v1/sip-connections. Passwords are write-only and never returned. Attaching a number for incoming calls, and check_sip_connection_number_ownership, place one Skysay verification call to that number (rate limited per number and per workspace); outbound with the number is refused until its ownership is confirmed. start_sip_connection_test_call places one billed call (calls:write) from the number to the given phone; check_sip_connection_reachability sends one SIP OPTIONS to the carrier server. No carrier settings change.
log_close_call
ChatGPTUse an existing administrator-connected Close CRM organization. Never invent contact, lead or phone IDs. List contacts (25 per page, newest first) before selecting an exact phone. start_close_call places one billed Skysay AI call only with the user's explicit authorization; reuse request_key after uncertain results. Finished calls are logged to Close with their true status, AI summary and authenticated Skysay recording/transcript link. log_close_call exports an existing finished inbound or outbound call whose phone matches the selected contact. This sends call information to Close. An unconfirmed delivery may already exist remotely and is never automatically replayed. No SMS synchronization or Close dialer replacement.
pause_campaign
ChatGPTPause a running campaign; no new attempts are placed until it is resumed.
preview_simulation_run
ChatGPTWhat starting a run would cost and whether this deployment can run it: attempt counts, the estimated spend, the model-call ceiling, and supported_runners. Covers the WHOLE suite, so it is an upper bound -- a run confined with scenario_ids costs no more than this, and often much less. Read-only; no run is created, nothing is queued, and no budget is reserved.
preview_voice
ChatGPTRender one bounded, rate-limited provider-backed TTS preview for the authenticated workspace. This may contact a managed provider or validate BYOK and can write preview-rate and exact voice-availability state; it is not a read-only or free preview. Caller text is at most 200 characters and returned audio is bounded in-memory WAV data.
request_call_translation
ChatGPTExplicitly request paid stored-text translation for an eligible new call, even with automatic translation off. $0.02 per 1,000 original words needing translation per target, minimum $0.01. Existing ready results and matching-language text cost zero.
request_capabilities
ChatGPTSelect capabilities profiles/channels/destinations and accept the outbound policy. A destination choice is REQUIRED: either all_countries: true (every destination except the sanctioned set) or countries naming at least one ISO 3166-1 alpha-2 code; a missing choice, an empty list or an unrecognized code is refused and nothing is stored. Auto-approves within default caps once KYB is approved, else routes to review.
request_message_translation
ChatGPTExplicitly request paid stored-text translation for an eligible new SMS. $0.02 per 1,000 original words needing translation per target, minimum $0.01. Cached reads never charge.
request_number
ChatGPTCreate a managed phone-number request; live provider ordering and assignment still require operator approval.
resume_campaign
ChatGPTResume a paused campaign.
revoke_pbx_key
ChatGPTRevoke all passwords for one logical PBX key. Other independently named keys are unaffected.
rotate_pbx_key
ChatGPTRotate a named PBX key without changing its logical id. Returns the new password once. Previous passwords keep their original grace deadlines, up to 24 hours; grace_seconds zero immediately invalidates all previous passwords.
send_agent_template_message
ChatGPTSend one of an AI agent's published SMS templates, filled with the variables and slots you give, from a number in the agent's own project, with no call behind it. The same send, policy and charge as POST /v1/agents/{agent_id}/messages; a template, agent or project it cannot find is one not-found. Returned body, metadata, error and idempotency_key require sms:read, including on replays.
send_sms
ChatGPTSend a policy-gated outbound SMS from one of the workspace's numbers, charged to the workspace balance. purpose is required and free-form (see the purpose property description for the advisory catalog); recipient_type is optional and recorded, never enforced. Returned body, metadata, error and idempotency_key require sms:read, including on replays.
set_agent_public_link
ChatGPTPublish, disable, or rename a hosted AI agent's public link. Confirm the user's intent before publishing or changing a public address. Publishing allows anonymous visitors to start browser calls billed to this workspace. Renaming releases the old address. Disabling keeps the address reserved. A first publish requires slug and enabled=true. Omit any field you want to preserve.
set_agent_variables
ChatGPTReplace an AI agent's whole call variables config, as PUT /v1/agents/{agent_id}/variables does. It is checked and republished at once, so the next call uses it; nothing is stored on a refusal. Send base_revision from get_agent_variables to be refused, rather than overwrite, when the agent changed since. A refused config returns error.body.issues, each with a code and where it points.
set_agent_voice_stack
ChatGPTSave revision-bound shared voice_setup for workflow publication, or explicitly publish an ordinary voice stack, optional outgoing-only version-pinned audio environment, and selected language profiles. Each locale override may set only exact voice, transcriber, and greeting; every resulting stack and existing credential binding is validated before a frozen publication is created. The environment is never caller/STT input. An engine whose agent-catalog row says has_language_axis false (a voice-to-voice engine) refuses languages, language_profiles and follow_caller with a 400 naming the field and the engine.
start_close_call
ChatGPTUse an existing administrator-connected Close CRM organization. Never invent contact, lead or phone IDs. List contacts (25 per page, newest first) before selecting an exact phone. start_close_call places one billed Skysay AI call only with the user's explicit authorization; reuse request_key after uncertain results. Finished calls are logged to Close with their true status, AI summary and authenticated Skysay recording/transcript link. log_close_call exports an existing finished inbound or outbound call whose phone matches the selected contact. This sends call information to Close. An unconfirmed delivery may already exist remotely and is never automatically replayed. No SMS synchronization or Close dialer replacement.
start_highlevel_call
ChatGPTUse a specific administrator-approved HighLevel contact and its original installation. Never invent or replace approval, location or contact IDs. Starting places one ordinary billed Skysay call after current opt-out and admission checks; retries return that same call. Outcome returns only its callId/state/status.
start_simulation_run
ChatGPTStart a run of a simulation suite. This SPENDS the workspace's budget -- every attempt is metered, and a voice attempt costs synthesis and transcription too. preview_simulation_run returns the estimate without starting anything. idempotency_key is required and is what makes a retry safe: the same key returns the same run instead of starting a second one.
start_sip_connection_test_call
ChatGPTBring your own SIP trunk: create, read or change a carrier SIP connection and its numbers through the same service as /v1/sip-connections. Passwords are write-only and never returned. Attaching a number for incoming calls, and check_sip_connection_number_ownership, place one Skysay verification call to that number (rate limited per number and per workspace); outbound with the number is refused until its ownership is confirmed. start_sip_connection_test_call places one billed call (calls:write) from the number to the given phone; check_sip_connection_reachability sends one SIP OPTIONS to the carrier server. No carrier settings change.
test_phone_server
ChatGPTDry-run verify a customer phone server before assigning a number to it.
update_agent
ChatGPTApply the same generic PATCH fields and validation as PATCH /v1/agents/{agent_id}; unknown fields retain REST's no-op compatibility behavior.
update_campaign
ChatGPTEdit a campaign's settings. A draft accepts every setting; a scheduled or paused campaign accepts name, from_number_ids, calling windows and zone, retry policy, concurrency, ends_at and language (and scheduled_start_at while scheduled). A running campaign accepts no edits until it is paused. Returns the campaign and the list of changed fields.
update_number_rules
ChatGPTUpdate customer-facing Number rules for one phone number.
account_overview
Claudeget_agent
Claudelist_agents
Claudelist_calls
Claudelist_numbers
Claude