API and MCP reference
442 operations in 15 areas. 408 of them are available to AI assistants over MCP.
Every operation runs as a signed-in person, with that person’s access. An assistant connected over MCP is limited in the same way, and risky changes wait for the person’s approval in Studio.
Operations marked API only are steps a browser has to take itself, such as signing in, or addresses other services call.
This page is an overview, with one line for each operation.
Agent authoring and personal settings
Create and configure agents, review their work, manage invitations and maintain your personal settings.
-
Accept guide session
MCP
acceptGuideSession -
Accepttransfer agent
MCP
accepttransferAgent -
Agenda add
MCP
agenda_add -
Agenda list
MCP
agenda_list -
Agenda update
MCP
agenda_update -
Answer guide session
MCP
answerGuideSession -
Approves or rejects a tool that is waiting for review on an agent
MCP
approveAgentTool -
Approves or rejects the changes waiting for review in one category of an agent
MCP
reviewAgentCategory -
Archive agent
MCP
archiveAgent -
Asks for access to an agent you can see but not open
MCP
requestAgentInvitation -
Cancel background task
MCP
cancelBackgroundTask -
Changes an agent's instructions
MCP
updateAgentInstructions -
Changes an agent's settings, voice and model
MCP
updateAgentSettings -
Changes an agent's variables
MCP
updateAgentVariables -
Changes how an agent writes on each channel
MCP
updateAgentChannelStyles -
Changes the company's settings for the agenda tool
MCP
putAgendaSettings -
Changes what an agent remembers and how
MCP
updateAgentMemory -
Changes which agent this agent is built on
MCP
updateAgentBuiltOn -
Changes which tools and knowledge searches an agent has
MCP
updateAgentTools -
Changes who can see and edit an agent
MCP
updateAgentAccess -
Changes your own preferences
MCP
updateUserPreferences -
Changes your own profile
MCP
updateUserProfile -
Compares two versions of an agent and shows what changed
MCP
compareAgentVersions -
Create agent from template
MCP
createAgentFromTemplate -
Create agent receiving address
MCP
createAgentReceivingAddress -
Create agent test run
MCP
createAgentTestRun -
Create guide session
MCP
createGuideSession -
Create memory webhook
MCP
createMemoryWebhook -
Create public link invitation
MCP
createPublicLinkInvitation -
Creates a new agent
MCP
createAgent -
Decline agent transfer
MCP
declineAgentTransfer -
Delete agent
MCP
deleteAgent -
Discard guide session
MCP
discardGuideSession -
Disconnect connected app
MCP
disconnectConnectedApp -
Download billing invoice
MCP
downloadBillingInvoice -
Duplicate agent
MCP
duplicateAgent -
Edit guide session
MCP
editGuideSession -
Export agent content
MCP
exportAgentContent -
Exports staff, community members or the audit log as CSV
MCP
exportCompanyCsv -
Get company
MCP
getCompanyRead the public company identity for the current host, including before sign-in. -
Get guide session
MCP
getGuideSession -
Get guide target
MCP
getGuideTarget -
Get me
MCP
getMe -
Import public link invitations
MCP
importPublicLinkInvitations -
Inspect agent test run
MCP
inspectAgentTestRun -
Invites a person to work on an agent
MCP
inviteAgentCollaborator -
List connected apps
MCP
listConnectedApps -
List memory deliveries
MCP
listMemoryDeliveries -
List people
MCP
listPeople -
List policies
MCP
listPolicies -
List public link invitations
MCP
listPublicLinkInvitations -
List roles
MCP
listRoles -
Lists the agents a new agent can be built on
MCP
listAgentBases -
Lists the agents you can see, with the ones you can open and the ones you can only see the name of
MCP
listAgents -
Lists the models you can choose for an agent
MCP
listModelChoices -
Pause agent
MCP
pauseAgent -
Publishes the agent's current draft as a new version
MCP
publishAgent -
Put agent channels
MCP
putAgentChannels -
Put agent public entry
MCP
putAgentPublicEntry -
Put agent voice settings
MCP
putAgentVoiceSettings -
Put agent widget skin
MCP
putAgentWidgetSkin -
Reads your own preferences
MCP
getUserPreferences -
Reads your own profile
MCP
getUserProfile -
Reads your own sign-in methods and sessions
MCP
getUserSecurity -
Replay conversation steps
MCP
replayConversationSteps -
Resend public link invitation
MCP
resendPublicLinkInvitation -
Restore agent
MCP
restoreAgent -
Reveal conversation words
MCP
revealConversationWordsreveal Conversation Words Requires a reason and records an audit entry before revealing private conversation words. -
Revoke public link invitation
MCP
revokePublicLinkInvitation -
Save agent test case
MCP
saveAgentTestCase -
Service disconnect connected app
MCP
serviceDisconnectConnectedApp -
Service start connected app
MCP
serviceStartConnectedApp -
Service test connected app event
MCP
serviceTestConnectedAppEvent -
Shows a preview of the agent on one channel (chat, texts, email, WhatsApp or voice)
MCP
getStudioPreview -
Signs you out of one session, or everywhere
MCP
revokeUserSession -
Test agent phone channel
MCP
testAgentPhoneChannel -
Transfer agent
MCP
transferAgent -
Update agent knowledge searches
MCP
updateAgentKnowledgeSearches -
Update agent tool settings
MCP
updateAgentToolSettings
Agents
Inspect agent configuration, inheritance, publication readiness and channel settings before making changes.
-
List agent dependencies
MCP
listAgentDependenciesRead the dependencies reported for this agent. -
List agent images
MCP
listAgentImagesRead the image records available on the agent and their revision. -
List agent test cases
MCP
listAgentTestCasesRead the agent's saved test cases and current revision. -
List agent test runs
MCP
listAgentTestRunsRead recorded test-run summaries and their states. -
List saved agent versions
MCP
listAgentVersionsList version numbers, authors and the environments using each version. -
Read a person's effective agent access
MCP
getEffectiveAgentAccessRead resolved permissions, category and section scope for the named person on this agent. -
Read agent email and phone channels
MCP
getAgentChannelsRead phone and email channel configuration, enabled state and readiness reasons. -
Read agent instruction inheritance
MCP
getAgentInheritanceRead the base chain, inherited parts and insertion points visible to the caller. -
Read agent instruction sections
MCP
listAgentSectionsRead grouped instruction sections and their editable state. -
Read agent instructions
MCP
getAgentInstructionsRead the instruction content and revision visible to the caller. -
Read agent knowledge searches
MCP
getAgentKnowledgeSearchesRead configured knowledge searches, source filters, mode and enabled state. -
Read agent lifecycle options
MCP
getAgentLifecycleRead lifecycle state and the actions currently described for this agent. -
Read agent memory settings
MCP
getAgentMemoryRead memory kinds, retention, processing steps, sharing destinations and lookup-tool settings. -
Read agent public entry settings
MCP
getAgentPublicEntryRead public link, widget and app entry settings, usage limits and reported readiness. -
Read agent publication readiness
MCP
getAgentPublishRead the current publication state and readiness information before publishing. -
Read agent settings
MCP
getAgentSettingsRead model selection, token and budget settings, input options and current revision. -
Read agent sharing settings
MCP
getAgentAccessRead the agent access configuration and current revision under the caller's existing authority. -
Read agent test choices
MCP
getAgentTestChoicesRead the choices offered for configuring an agent test. -
Read agent variable definitions
MCP
getAgentVariablesRead the agent variable configuration and its revision. -
Read agent voice settings
MCP
getAgentVoiceSettingsRead voice configuration and reported limits, usage and readiness for the selected environment. -
Read agent widget appearance
MCP
getAgentWidgetSkinRead widget colours, layout, launcher, header and branding options. -
Read agent writing styles by channel
MCP
getAgentChannelStylesRead channel-specific instruction styles and their placement relative to shared sections. -
Read an agent
MCP
getAgentRead the agent name, description, category, visibility and current revision. -
Read an agent base selection
MCP
getAgentBuiltOnRead the selected base agent and inheritance settings. -
Read an agent overview
MCP
getAgentOverviewRead the agent overview with the state and summary information available to the caller. -
Read an agent tool settings layer
MCP
getAgentToolSettingsRead the settings and argument defaults explicitly configured for this agent and tool. -
Read effective agent tool settings
MCP
getAgentEffectiveToolSettingsRead merged tool settings with each value's source and lock state, plus the resulting model input schema. -
Read skills bound to an agent
MCP
getAgentSkillsRead bound skill references, versions and per-agent usage guidance and tool switches. -
Read the impact of an agent base
MCP
getBuiltOnImpactRead the impact information for the agent's base relationship. -
Read tools assigned to an agent
MCP
getAgentToolsRead the tools assigned to this agent, their guidance and approval state.
AI guidance
Inspect published AI guidance.
-
List AI guidance
MCP
listFalconGuidanceList AI guidance with the full text, declared variables and usage locations. -
List saved guidance samples
MCP
listFalconGuidanceSamplesRead example sample inputs and expected labels for this published guide. -
Propose an AI guidance draft
MCP
proposeFalconGuidanceDraftReplace the registered content parts of a draft. -
Publish an AI guidance draft
API only
publishFalconGuidanceDraftPublish the exact independently reviewed draft revision from the staff console with a fresh second step. -
Read a guidance trial
MCP
getFalconGuidanceTrialRead a saved trial with the exact source guide and sample revision, answers and confidence. -
Read AI guidance and its history
MCP
getFalconGuidanceRead AI guidance and its history with the full text, declared variables and usage locations. -
Read an AI guidance draft
MCP
getFalconGuidanceDraftRead the current draft and its review state without changing published guidance. -
Review an AI guidance draft
MCP
reviewFalconGuidanceDraftApprove the exact draft revision as a staff member who contributed none of its edits. -
Save a guidance sample
MCP
saveFalconGuidanceSampleSave a example sample and expected labels with its current revision. -
Try AI guidance on a saved sample
MCP
runFalconGuidanceTrialRun the current publication, an earlier published version or an exact saved draft revision against one saved example sample.
Browser authentication and consent
Sign in, verify security challenges and review connected MCP clients.
-
Accept a membership invitation
API only
acceptInvitationAccept the invitation for the verified recipient. -
Cancel an MCP request
API only
cancelMcpPendingOperationCancel a pending request without executing it. -
Confirm an MCP request
API only
confirmMcpPendingOperationApprove execution of the exact pending request in its original browser review session. -
Disconnect an MCP client
MCP
revokeMcpConnectionRevoke the selected MCP connection and its continued access. -
Finish connecting a preset
API only
completeConnectorPresetContract and synthetic fixture only. -
Finish connecting an app
API only
serviceCompleteConnectedAppCompany/person-bound single-use callback state. -
Finish signing in
API only
completeSignInExchange the challenge response for a browser session. -
Finish workspace setup
API only
completeWorkspaceSetupSave the workspace’s initial configuration after the setup challenge. -
List your MCP connections
MCP
listMcpConnectionsRead the MCP clients connected by the current person. -
Read a membership invitation
API only
getInvitationLook up a membership invitation using its invitation proof. -
Read an MCP request awaiting review
API only
getMcpPendingOperationRead the exact pending request in the original browser review session. -
Read an uncertain MCP request’s receipt
API only
reconcileMcpPendingOperationRead an execution receipt without repeating the uncertain action. -
Read sign-in choices
API only
getSignInOptionsRead the sign-in methods available for this workspace. -
Read workspace setup
API only
getWorkspaceSetupRead the remaining setup required for this workspace. -
Remove a security method
MCP
removeSecurityMethodRemove a security method after the required browser security check. -
Replace backup codes
MCP
regenerateBackupCodesInvalidate the old backup codes and issue replacements for the current person. -
Reset a person’s security methods
MCP
resetPersonFactorsReset the selected person’s security methods under current administrator authority. -
Review an MCP connection request
API only
reviewMcpConsentValidate the registered client, redirect and requested permissions before browser consent. -
Send a phone verification code
API only
startPhoneVerificationSend a verification challenge to the current person’s phone. -
Start a security check
API only
startStepUpCreates a ten-minute browser/session-bound challenge. -
Start adding a security method
API only
beginSecurityEnrollmentCreate a challenge to enroll a passkey or another supported security method. -
Start signing in
API only
startSignInCreate a sign-in challenge for the selected method. -
Verify a new security method
API only
confirmSecurityEnrollmentVerify the enrollment response and attach the security method to the current person. -
Verify a phone number
API only
confirmPhoneVerificationVerify the phone challenge and save the verified phone. -
Verify a second sign-in step
API only
completeSecondStepComplete the current session’s second authentication challenge.
Company administration
Manage company membership, security, appearance, billing and operating settings.
-
Accept company setup suggestions
MCP
companyAcceptGuideSessionApply the reviewed company setup guide result under the current caller’s settings authority and declared preconditions. -
Add a company person
MCP
createCompanyPersonCreate a membership record with the supplied name, address and role. -
Add a GitHub installation
MCP
createCompanyGithubInstallationRecord a GitHub installation and its repository access for this company. -
Adds a cloud account to deploy agents to
MCP
createCompanyDeploymentAccount -
Adds a payment method
MCP
createCompanyPaymentMethod -
Adds an agent image
MCP
createCompanyImage -
Answer a company setup question
MCP
companyAnswerGuideSessionSubmit an answer to the current company setup guide question and return the next guide state. -
Applies the draft theme so everyone sees it
MCP
changeCompanyThemeApply -
Change billing details
MCP
updateCompanyBillingSave the company’s billing details using their current revision. -
Change email domain policy
MCP
updateCompanyDomainPolicyReplace the allowed and blocked email domain policy using its current revision. -
Change MCP access policy
MCP
updateCompanyMcpPolicyReplace the company MCP policy with reviewed values using its current revision. -
Changes a deployment account
MCP
updateCompanyDeploymentAccount -
Changes a payment method
MCP
updateCompanyPaymentMethod -
Changes a person's role or details
MCP
updateCompanyPerson -
Changes an agent image
MCP
updateCompanyImage -
Changes an invitation
MCP
updateCompanyInvitation -
Changes the defaults for traveller payments
MCP
updateTravellerPaymentDefaults -
Changes the draft theme
MCP
changeCompanyThemeDraft -
Complete a privacy request
MCP
completeCompanyPrivacyRequestMark or execute the requested completion under the privacy request’s current state and company policy. -
Discard a company setup guide
MCP
companyDiscardGuideSessionDiscard the proposed company setup guide result without applying its suggested settings. -
Edit a company setup answer
MCP
companyEditGuideSessionChange a saved answer in the company setup guide before accepting its proposed settings. -
Export authored content
MCP
exportCompanyAuthoredContentRequest an export of authored content visible under the company’s current access policy. -
Export the audit log
MCP
exportCompanyAuditRequest an export of company audit records under the caller’s current audit permissions. -
Goes back to an earlier theme
MCP
changeCompanyThemeRevert -
Invites a person to the company
MCP
createCompanyInvitation -
List privacy requests
MCP
listCompanyPrivacyRequestsList the company’s recorded privacy requests and their progress so authorized staff can handle them. -
Lists earlier themes
MCP
listCompanyThemeHistory -
Lists entries in the company's audit log
MCP
listCompanyAudit -
Lists the choices available for agent images
MCP
getCompanyImageOptions -
Lists the cloud accounts the company deploys agents to
MCP
listCompanyDeploymentAccount -
Lists the company's agent images
MCP
listCompanyImage -
Lists the company's invitations
MCP
listCompanyInvitation -
Lists the company's payment methods
MCP
listCompanyPaymentMethod -
Lists the design tokens a theme can change
MCP
getCompanyThemeTokens -
Lists the filters and choices for the people list
MCP
getCompanyPeopleOptions -
Lists the people in the company
MCP
listCompanyPerson -
Makes a preview of the draft theme
MCP
changeCompanyThemePreview -
Moderate company authors
MCP
moderateCompanyAuthorsApply the requested moderation action to the selected community authors. -
Moves agents or instructions between categories, using a preview you made just before
MCP
applyCompanyCategoryChange -
Open the billing portal
MCP
createBillingPortalSessionCreate a short-lived billing portal session for the company so an authorized person can manage payment details with the billing provider. -
Preview or invite many people
MCP
invitePeoplePreview up to 500 invitation rows, then queue ready invitations after one recent second step. -
Read a company setup guide
MCP
companyGetGuideSessionRead the current question, answers and proposed settings for an existing company setup guide session. -
Read billing details
MCP
getCompanyBillingRead company billing configuration and available invoice information. -
Read company message topics
MCP
getCompanyMessageTopicsCompany message topics and their consent classification, quiet hours and daily limits. -
Read company validation checks
MCP
getValidationChecksRead company-defined identity and input validation checks. -
Read deployment details
MCP
getCompanyDeploymentDetailsRead the deployment details for the supplied account and resource selection. -
Read email domain policy
MCP
getCompanyDomainPolicyRead the company rules for allowed and blocked email domains before changing enrollment or invitation policy. -
Read MCP access policy
MCP
getCompanyMcpPolicyRead who may connect MCP clients and which actions require confirmation under the current company policy. -
Read Microsoft sign-in settings
MCP
getCompanyMicrosoftSignIn -
Read the company plan
MCP
getCompanyPlanRead the current company plan and its limits before requesting a feature that depends on plan eligibility. -
Reads one agent image
MCP
getCompanyImage -
Reads one deployment account
MCP
getCompanyDeploymentAccount -
Reads one invitation
MCP
getCompanyInvitation -
Reads one payment method
MCP
getCompanyPaymentMethod -
Reads one person
MCP
getCompanyPerson -
Reads payment totals and defaults for traveller payments
MCP
getTravellerPaymentTotals -
Reads the company's theme: the live one and any draft
MCP
getCompanyTheme -
Reads the full details for one person
MCP
getCompanyPersonDetails -
Record a privacy request
MCP
createCompanyPrivacyRequestRecord a person’s requested privacy action for company handling. -
Record Microsoft admin approval
MCP
completeCompanyMicrosoftConsent -
Run a company action
MCP
actOnCompanyGeneralRun a supported company-level action against the current settings revision. -
Run a connection action
MCP
actOnCompanyConnectionRun a supported action on one company connection. -
Run a data privacy action
MCP
actOnCompanyDataPrivacyRun a supported action on the company data privacy settings. -
Run a deployment account action
MCP
actOnCompanyDeploymentAccountRun a supported action on a company deployment account. -
Run a GitHub installation action
MCP
actOnCompanyGithubInstallationRun a supported action on a company GitHub installation. -
Run a model settings action
MCP
actOnCompanyModelLimitsRun a supported action on company model settings using the current revision. -
Run a security action
MCP
actOnCompanySecurityRun a supported action on company security settings. -
Run a single sign-on action
MCP
actOnCompanySsoRun a supported action on the company’s single sign-on configuration. -
Run a tool category action
MCP
actOnCompanyToolCategoryRun a supported action on a company tool category. -
Run an event source action
MCP
actOnCompanyEventSourceRun a supported action on one company event source. -
Run an MCP policy action
MCP
actOnCompanyMcpPolicyRun a supported action on the company MCP policy, subject to current company authority and the declared revision precondition. -
Runs an action on a payment method, such as verify or remove
MCP
actOnCompanyPaymentMethod -
Runs an action on a person, such as sign out everywhere or remove. The actions allowed depend on the person
MCP
actOnCompanyPersonRuns an action on a person, such as sign_out_everywhere or remove. -
Runs an action on an agent image, such as build or remove. The actions allowed depend on the image
MCP
actOnCompanyImageRuns an action on an agent image, such as build or remove. -
Runs an action on an invitation, such as resend or revoke
MCP
actOnCompanyInvitation -
Save a connection credential
MCP
setCompanyConnectionsSecretReplace the write-only credential for one company connection. -
Save a model credential
MCP
setCompanyModelsSecretReplace the write-only credential in company model settings. -
Save an event source credential
MCP
setCompanyEventSourcesSecretReplace the write-only credential for one company event source. -
Save company validation checks
MCP
putValidationChecksReplace company-defined checks used with built-in safety and field-fit checks. -
Save Microsoft sign-in settings
MCP
putCompanyMicrosoftSignIn -
Searches the company's audit log
MCP
searchCompanyAudit -
Searches the company's people
MCP
searchCompanyPeople -
Shows what moving agents or instructions between categories would change
MCP
previewCompanyCategoryChange -
Signs a person out everywhere
MCP
signOutCompanyPerson -
Start a company setup guide
MCP
companyCreateGuideSessionCreate a company setup guide session for the requested settings target. -
Throws away the draft theme
MCP
changeCompanyThemeDiscard -
Try a validation check
MCP
tryValidationCheckEvaluate sample text with one company-defined check and return the decision without saving the sample. -
Update company message topics
MCP
updateCompanyMessageTopicsCompany message topics and their consent classification, quiet hours and daily limits. -
Uploads a logo for the theme
MCP
uploadCompanyLogo
Company self-serve sign-up
Create and review a new company workspace without granting production access before operator staff approval.
-
Approve a company sign-up
MCP
approveCompanySignupRequestApprove a verified request and create its limited workspace defaults. -
List company email reputation guards
MCP
listEmailReputationRead rolling SES bounce and complaint rates and any automatic outbound-email pauses. -
List company sign-up requests
MCP
listCompanySignupRequestsRead verified company sign-ups waiting for operator staff approval. -
Start a company sign-up
API only
startCompanySignupSubmit company details, a verified mailbox and a processor-vault payment reference for a new workspace sign-up. -
Unpause a company's outbound email
MCP
unpauseCompanyEmailAfter review, staff can clear a company's automatic email-reputation pause. -
Verify a company sign-up
API only
verifyCompanySignupVerify the mailbox code sent for a company sign-up.
Connections
Inspect configured app and channel connections, sender readiness and tool grants.
-
Change company app sign-in settings
MCP
updateCompanyAppSettingsChange between Falcon's client and the company's own client. -
Connect an Other email mailbox
MCP
createOtherEmailConnectionConnect a hand-entered SMTP and IMAP mailbox after a mandatory test send; credentials are write-only and encrypted. -
Create an incoming email map
MCP
createIncomingEmailMapCreate an ordered email rule that maps a recipient, sender, subject or keyword to a workflow or agent. -
Create an incoming request map
MCP
createIncomingRequestMapCreate a signed, bounded request address that maps an incoming request to a workflow or agent. -
Disconnect an Other email mailbox
MCP
disconnectOtherEmailConnectionDisable a mailbox and remove stored credentials. -
List a connection's tool choices
MCP
listToolConnectionChoicesList tools available through a selected connection. -
List available message senders
MCP
listSendingSendersList senders and their declared channel readiness. -
List company message keys
MCP
listCompanyMessageKeysRead message-key metadata and configured state. -
List connected app deliveries
MCP
serviceListConnectedAppDeliveriesInspect recorded deliveries for an app connection. -
List connected apps
MCP
serviceListConnectedAppsList app connections visible in the current company scope. -
List connection presets
MCP
listConnectorPresetsList reusable connection presets. -
List incoming email maps
MCP
listIncomingEmailMapsRead the ordered rules that route inbound email, the addresses assigned to agents and identities, and the company's forwarding or MX setup. -
List incoming request maps
MCP
listIncomingRequestMapsRead request maps, their rotatable addresses and recent accepted, ignored or refused results. -
List SendGrid connections
MCP
listSendGridConnectionList configured SendGrid connections and their status. -
List twilio connections
MCP
listTwilioConnectionsList configured Twilio connections and their status. -
Read a connected app
MCP
serviceGetConnectedAppRead an existing app connection's label, state and configuration. -
Read a connection preset
MCP
getConnectorPresetRead a preset's provider and connection requirements. -
Read a SendGrid connection
MCP
getSendGridConnectionInspect a SendGrid connection's configured state. -
Read a Twilio connection
MCP
getTwilioConnectionInspect a Twilio connection's configured state. -
Read an app event example
MCP
getAppCloudEventExampleInspect the app event envelope. -
Read company app sign-in settings
MCP
getCompanyAppSettingsRead the sign-in choice and identity-connectability flag. -
Read company messaging rules
MCP
getCompanyMessagingRulesRead the message kinds and sending rules that apply. -
Read message-key tool grants
MCP
getMessageKeyToolGrantsRead which tools a message key may use. -
Read one saved Other email mailbox
MCP
getOtherEmailConnectionRead mailbox status and last test without credentials. -
Read saved Other email mailboxes
MCP
listOtherEmailConnectionsRead mailbox status, addresses and the last provider test without credentials. -
Read the company webhook endpoint
MCP
getCompanyWebhookEndpointInspect the configured shared webhook endpoint. -
Receive a mapped incoming request
API only
receiveIncomingRequestVerify and map a signed incoming request. -
Rotate an incoming request address
MCP
rotateIncomingRequestMapRotate a request map address while retaining its mapping and target. -
Update an incoming email map
MCP
updateIncomingEmailMapChange an email map's matching rule or target while retaining its inbound address. -
Update an incoming request map
MCP
updateIncomingRequestMapChange the target, verification, conditions or mapping without changing the request address.
Identities
Manage people and places that agents act for.
-
Choose an identity binding's RCS sender
MCP
updateCompanyIdentityBindingRcsAttach an identity RCS registration or return the binding to the agent's shared sender. -
Choose company binding calendars
MCP
updateCompanyIdentityBindingCalendarChoose which already granted calendars narrow this identity binding’s working hours. -
Choose personal binding calendars
MCP
updatePersonalIdentityBindingCalendarChoose which already granted calendars narrow this identity binding’s working hours. -
Commit a company identity import
MCP
commitCompanyIdentityImportWrite reviewed rows as drafts bound to no agent, applying explicit update or skip decisions to code-then-email matches. -
Preview a company identity import
MCP
previewCompanyIdentityImportRead CSV or JSON identity rows, apply adjustable header mapping, validate every row and show code-then-email matches without writing identities or sending mail. -
Preview an identity RCS registration
MCP
previewCompanyIdentityBindingRcsRegistrationPreview the REQ-650 registration builder pre-filled from identity fields. -
Read a company binding address test
MCP
getCompanyIdentityBindingTestTest only the current receiving email, SIP address or attached number of an enabled binding. -
Read a personal binding address test
MCP
getPersonalIdentityBindingTestTest only the current receiving email, SIP address or attached number of an enabled binding. -
Read an identity binding's RCS sender
MCP
getCompanyIdentityBindingRcsRead the agent-shared or identity-dedicated RCS choice, approval status and identity sign-off. -
Read company binding calendar status
MCP
getCompanyIdentityBindingCalendarRead the calendars selected for this binding and the last successful refresh time. -
Read personal binding calendar status
MCP
getPersonalIdentityBindingCalendarRead the calendars selected for this binding and the last successful refresh time. -
Request a company binding address test
MCP
createCompanyIdentityBindingTestTest only the current receiving email, SIP address or attached number of an enabled binding. -
Request a personal binding address test
MCP
createPersonalIdentityBindingTestTest only the current receiving email, SIP address or attached number of an enabled binding.
Knowledge
Inspect knowledge bases, their sources and synchronization progress.
-
Ask about documents
MCP
askAboutDocumentsAsk one registered yes/no or pick-one question about referenced items without loading their content into the agent context. -
List knowledge bases
MCP
listKnowledgeBaseList knowledge bases and their source summaries. -
List knowledge sources
MCP
listKnowledgeSourceList sources configured for a knowledge base. -
List knowledge syncs
MCP
listKnowledgeSyncsRead recorded synchronization attempts for a knowledge base. -
Read a knowledge base
MCP
getKnowledgeBaseInspect a knowledge base's configuration, source counts and revision. -
Read a knowledge source
MCP
getKnowledgeSourceInspect a source's location, schedule, tags and current state.
Partners
Manage consented partner access to client companies.
-
Accept a partner invitation
MCP
acceptPartnerInvitationAccept a pending partner invitation as a client administrator. -
Create a partner account
MCP
createPartnerAccountCreate a staff-approved partner account. -
Invite a partner to a client
MCP
createPartnerInvitationCreate a consent invitation from a partner to a client company. -
List partner clients
MCP
listPartnerClientsList client companies linked to a partner. -
List partners with client access
MCP
listCompanyPartnerAccessShow client administrators which partners can act in this company. -
Revoke partner access
MCP
revokePartnerAccessRevoke a partner's delegated access in the current client company.
Tools, knowledge and workflow authoring
Configure reusable skills, tools, connections, knowledge, storage, workflows and reports.
-
Adds a connection to another MCP server
MCP
createRemoteMcpConnection -
Adds a source to a knowledge base
MCP
createKnowledgeSource -
Adds a storage connection
MCP
createStorageConnection -
Adds a webhook to a workflow
MCP
createPipelineWebhook -
Adds something that starts a workflow
MCP
createPipelineTrigger -
Archive workflow
MCP
archivePipeline -
Cancel report schedule
MCP
cancelReportSchedule -
Cancel workflow run
MCP
cancelPipelineRun -
Changes a company skill's draft
MCP
updateCompanySkill -
Changes a company tool
MCP
updateCompanyTool -
Changes a connection to another MCP server
MCP
updateRemoteMcpConnection -
Changes a file store
MCP
updateFileStore -
Changes a knowledge base
MCP
updateKnowledgeBase -
Changes a knowledge source
MCP
updateKnowledgeSource -
Changes a storage connection
MCP
updateStorageConnection -
Changes a workflow webhook
MCP
updatePipelineWebhook -
Changes the company's settings for the get file tool
MCP
updateGetFileSettings -
Changes the company's settings for the list files tool
MCP
updateListFilesSettings -
Changes the company's settings for the save file tool
MCP
updateSaveFileSettings -
Changes the skills an agent uses and when it uses them
MCP
updateAgentSkills -
Changes which tools a message key may use
MCP
updateMessageKeyToolGrants -
Check twilio connection
MCP
checkTwilioConnection -
Checks that a storage connection works
MCP
checkStorageConnection -
Connect connector preset
MCP
connectConnectorPreset -
Create falcon code repository
MCP
createFalconCodeRepository -
Create report schedule
MCP
createReportSchedule -
Create send grid connection
MCP
createSendGridConnection -
Create twilio connection
MCP
createTwilioConnection -
Creates a company skill
MCP
createCompanySkill -
Creates a file store
MCP
createFileStore -
Creates a knowledge base
MCP
createKnowledgeBase -
Creates a link to a stored file
MCP
createFileLink -
Creates a new company skill and adds it to an agent in one step
MCP
createAndBindAgentSkill -
Defines a new company tool
MCP
createCompanyTool -
Disconnect remote connector
MCP
disconnectRemoteConnector -
Export report
MCP
exportReport -
Get agent daily cost cap
MCP
getAgentDailyCostCap -
Get agent skill derivation
MCP
getAgentSkillDerivation -
Get cost report
MCP
getCostReport -
Get report schedules
MCP
getReportSchedules -
Get workflow event example
MCP
getPipelineEventExample -
Get workflow raise example
MCP
getPipelineRaiseExample -
Get workflow report
MCP
getPipelineReport -
Get workflow version
MCP
getPipelineVersion -
List knowledge base choices
MCP
listKnowledgeBaseChoices -
Lists a workflow's webhooks
MCP
listPipelineWebhooks -
Lists the company's skills
MCP
listCompanySkills -
Lists the company's workflows
MCP
listPipelines -
Lists the knowledge bases a connection can reach, so you can add them
MCP
discoverKnowledgeBases -
Lists the tools and knowledge searches you can add to an agent
MCP
listToolCatalog -
Lists what starts a workflow
MCP
listPipelineTriggers -
Makes a copy of a company skill
MCP
duplicateCompanySkill -
Moves a company tool through review and release: submit it for review, approve it, publish it or retire it
MCP
actOnTool -
Publishes a skill's draft as a new version
MCP
publishCompanySkill -
Put tool webhook signing
MCP
putToolWebhookSigning -
Put twilio connection
MCP
putTwilioConnection -
Reads a skill's published versions and whether its draft is ready to publish
MCP
getCompanySkillPublication -
Reads one company skill
MCP
getCompanySkill -
Refresh tool catalog
MCP
refreshToolCatalog -
Reschedule workflow run
MCP
reschedulePipelineRun -
Resolve tool ui action
MCP
resolveToolUiAction -
Restores an older workflow version as the draft. To change Live, make an older version live instead
MCP
rollbackPipelineRestores an older workflow version as the draft. -
Retry workflow run
MCP
retryPipelineRun -
Runnow workflow run
MCP
runnowPipelineRun -
Runs a test call of a company tool. Repeat the same call with the same idempotency key to read its result
MCP
testCompanyToolRuns a test call of a company tool. -
Select connector tools
MCP
selectConnectorTools -
Shows the tool a workflow's agents use to report the exceptions the workflow declares
MCP
getPipelineExceptionTool -
Starts syncing a knowledge base from its sources
MCP
startKnowledgeSync -
Test knowledge search
MCP
testKnowledgeSearch -
Test send grid connection
MCP
testSendGridConnection -
Test workflow
MCP
testPipeline -
Update agent skill derivation
MCP
updateAgentSkillDerivation -
Update company messaging rules
MCP
updateCompanyMessagingRules -
Update company webhook endpoint
MCP
updateCompanyWebhookEndpoint -
Update falcon code repository
MCP
updateFalconCodeRepository -
Update report schedule
MCP
updateReportSchedule -
Update send grid connection
MCP
updateSendGridConnection -
Update step tool settings
MCP
updateStepToolSettings -
Update tool implementation choice
MCP
updateToolImplementationChoice -
Update tool sign in
MCP
updateToolSignIn
Service callbacks and client transport
Receive authenticated callbacks and exchange conversation and workflow data.
-
Accept a signed guest invitation
API only
acceptPublicGuestInvitationAccept a single-use signed invitation proof without Studio sign-in. -
Accept a signed tool event
API only
acceptToolCallEventMessage-key grants default empty. -
Add an agenda item from a company server
API only
addPersonAgendaContract and synthetic fixture only. -
List a person’s agenda
MCP
listPersonAgendaRead the agenda items for the referenced person under current conversation-read permission. -
Prepare a conversation upload
API only
createClientUploadSynthetic client exchange. -
Raise a signed workflow exception
API only
raisePipelineExceptionContract and synthetic fixture only. -
Read a private company theme PNG
MCP
getCompanyThemeAssetRead an authorized company theme asset as PNG bytes. -
Read a workflow run by its server reference
MCP
fetchPipelineRunRead a workflow run within the caller’s permitted scope. -
Read conversation events
API only
getClientEventsSynthetic client exchange. -
Receive a tool completion callback
API only
receiveToolWebhookCallbackBound to tenant, waiting call/version and output schema. -
Upload conversation content
API only
putClientUploadSynthetic client exchange.
Storage
Inspect file stores, storage configuration and file-tool examples.
-
List file expiry folders
MCP
listExpiryFoldersInspect configured expiry folders and retention rules. -
List file stores
MCP
listFileStoreList the company's file stores and their connection assignments. -
List storage connections
MCP
listStorageConnectionList configured storage connections and their readiness. -
Read a file move job
MCP
getFileMoveJobInspect an existing file move job's progress. -
Read a file store
MCP
getFileStoreRead a file store's location, settings and revision. -
Read a file-listing example
MCP
getListFilesExampleInspect example file-listing arguments and results. -
Read a file-reading example
MCP
getReadFileExampleInspect example file-reading arguments and results. -
Read a save-file example
MCP
getSaveFileExampleInspect example save-file arguments and results. -
Read a storage connection
MCP
getStorageConnectionInspect a storage connection's configuration and security status. -
Read a storage policy
MCP
getStoragePolicyRead the required storage policy for a selected connection. -
Read get-file tool settings
MCP
getGetFileSettingsInspect the get-file tool's configured access and defaults. -
Read list-files tool settings
MCP
getListFilesSettingsInspect the list-files tool's configured scope and defaults. -
Read save-file tool settings
MCP
getSaveFileSettingsInspect destination and file-handling settings.
Tools
Inspect tool definitions, safeguards, task progress and integration examples.
-
Ask one question across GitHub files
MCP
askGithubFilesAsk one registered question over bounded GitHub file items at an immutable commit. -
Find relevant github files
MCP
findRelevantGithubFilesRank relevant files in a connected GitHub repository at an immutable commit without returning repository content. -
List built-in tool definitions
MCP
listBuiltInToolDefinitionsInspect the built-in tool kinds and their configuration fields. -
List company tools
MCP
listCompanyToolList tool definitions, safeguards and publication state. -
List connected code repositories
MCP
listFalconCodeRepositoryList the connected repositories available for code tools. -
List remote mcp connections
MCP
listRemoteMcpConnectionsList configured remote MCP connections and their status. -
List tool implementation choices
MCP
listToolImplementationChoicesCompare the available backend kinds. -
List tool interface action kinds
MCP
listToolUiActionKindsInspect the supported interface action kinds. -
Read a background task
MCP
getBackgroundTaskRead an existing task's progress and result using its task identifier. -
Read a background task event example
MCP
getBackgroundTaskEventExampleInspect a task progress event's shape. -
Read a company tool
MCP
getCompanyToolRead a tool's input and output shapes, backend, safeguards and current revision. -
Read a connected code repository
MCP
getFalconCodeRepositoryInspect a connected repository's configuration and state. -
Read a recorded tool call
MCP
getToolCallRecordRead the status and permitted result of an existing tool call using its call identifier. -
Read a remote MCP connection
MCP
getRemoteMcpConnectionRead a configured remote MCP connection and its status. -
Read a tool completion event example
MCP
getToolEventBridgeCompletionExampleInspect the completion event format for a tool that finishes asynchronously. -
Read a tool interface action example
MCP
getToolUiActionExampleRead an example of a tool result that requests an interface action. -
Read a tool webhook callback example
MCP
getToolWebhookCallbackExampleInspect the callback shape used to complete a deferred tool call. -
Read a tool webhook request example
MCP
getToolWebhookRequestExampleInspect the request shape a tool webhook receives. -
Read a tool's sign-in requirements
MCP
getToolSignInInspect the connection and sign-in requirements for a tool. -
Read agenda tool settings
MCP
getAgendaSettingsInspect the agenda tool's configured defaults. -
Read an agenda event example
MCP
getAgendaEventExampleInspect the declared agenda event shape. -
Read background task limits
MCP
getBackgroundTaskLimitsInspect the configured task limits. -
Read email shared-sender reply settings
MCP
getEmailMessagingSettingsRead Send email settings, including what to do when a reply could be for more than one open conversation. -
Read Slack shared-sender reply settings
MCP
getSlackMessagingSettingsRead Slack sender settings, including what to do when a reply could be for more than one open conversation. -
Read Telegram shared-sender reply settings
MCP
getTelegramMessagingSettingsRead Telegram sender settings, including what to do when a reply could be for more than one open conversation. -
Read text shared-sender reply settings
MCP
getTextMessagingSettingsRead text sender settings, including what to do when a reply could be for more than one open conversation. -
Read tool call examples
MCP
getToolCallExamplesRead example arguments and results to understand a tool's declared interface. -
Read tool editing options
MCP
getCompanyToolOptionsRead icon choices and current safeguard authority. -
Read tool publication state
MCP
getToolPublicationInspect the saved tool versions and their publication state. -
Read tool webhook signing status
MCP
getToolWebhookSigningRead webhook signing configuration and key status. -
Read WhatsApp shared-sender reply settings
MCP
getWhatsappMessagingSettingsRead WhatsApp sender settings, including what to do when a reply could be for more than one open conversation. -
Set email shared-sender reply settings
MCP
putEmailMessagingSettingsSave Send email settings for replies that could be for more than one open conversation. -
Set Slack shared-sender reply settings
MCP
putSlackMessagingSettingsSave the Slack sender setting for replies that could be for more than one open conversation. -
Set Telegram shared-sender reply settings
MCP
putTelegramMessagingSettingsSave the Telegram sender setting for replies that could be for more than one open conversation. -
Set text shared-sender reply settings
MCP
putTextMessagingSettingsSave the text sender setting for replies that could be for more than one open conversation, including the seven-day recent window. -
Set WhatsApp shared-sender reply settings
MCP
putWhatsappMessagingSettingsSave the WhatsApp sender setting for replies that could be for more than one open conversation.
Workflows
Inspect settings saved on workflow steps and the values they inherit.
-
Adopt a Gmail reply draft agent
MCP
adoptGmailReplyDraftTemplateCreate and publish a Dev reply draft workflow using an existing immutable agent publication containing only the reviewed draft instructions. -
Create a call-recording-ready workflow starter
MCP
createCallRecordingStarterCreate and activate a workflow that starts when a call recording is ready. -
Install the Gmail reply draft workflow
MCP
installGmailReplyDraftTemplateInstall reviewed draft instructions on an unused root agent, publish its immutable Dev version and create the reply draft workflow. -
Read effective workflow step tool settings
MCP
getStepEffectiveToolSettingsRead a step's resolved tool settings and their sources. -
Read workflow step tool settings
MCP
getStepToolSettingsRead the settings saved directly on a workflow step. -
Receive a finished call recording
API only
receiveCallRecordingReceive a provider-signed finished recording notification for the transcript and report starter.