summer_github_issues_read
Check issue permission and repository visibility, or read one original GitHub issue by number
Check issue permission and repository visibility, or read one original GitHub issue by number. Restricted to company-selected repositories; no credentials or writes. Issue closure does not resolve the customer case.
Parametersnumbercompanyrequiredsource_idrequiredenvironmentrequired
summer_github_connection_read
Read the company GitHub installation, selected repositories/folders and cached commit status
Read the company GitHub installation, selected repositories/folders and cached commit status. Makes no GitHub request and returns no credentials.
Parameterscompanyrequiredenvironmentrequired
summer_github_connection_start
Get the Summer browser URL for a company administrator to install and authorize the Summer GitHub App
Get the Summer browser URL for a company administrator to install and authorize the Summer GitHub App. Code access is read-only; issue handoffs use separate GitHub Issues permission and exact case approval. Does not grant access or connect an installation by itself.
Parameterscompanyrequiredenvironmentrequired
summer_github_repositories_list
List repositories available to this company GitHub installation
List repositories available to this company GitHub installation. Provider metadata read; no file content.
Parameterspagecompanyrequiredenvironmentrequired
summer_github_folders_list
Browse repository folders at a branch or commit before selecting access
Browse repository folders at a branch or commit before selecting access.
ParametersrefrequiredpathcompanyrequiredrepositoryrequiredenvironmentrequiredrepositoryIdrequired
summer_github_sources_save
Choose repository branches/commits and allowed folders
Choose repository branches/commits and allowed folders. A dot selects the whole repository. Replaces selections with an expected version and invalidates old cached access. Does not sync code.
Parameterscompanyrequiredsourcesrequiredenvironmentrequiredidempotency_keyexpected_versionrequired
summer_github_sources_sync
Refresh the selected repository code cache once from GitHub
Refresh the selected repository code cache once from GitHub. Reuses the cache for an unchanged commit; sandbox startup never pulls GitHub.
Parameterscompanyrequiredsource_idrequiredenvironmentrequiredidempotency_key
summer_github_sources_read
List cached source paths, or read one cached file with path
List cached source paths, or read one cached file with path. Only currently selected company folders are available. No live GitHub call or credentials.
Parameterspathoffsetcompanyrequiredsource_idrequiredenvironmentrequired
summer_github_connection_disconnect
Disconnect this company/environment GitHub source access and remove its cached archives
Disconnect this company/environment GitHub source access and remove its cached archives.
Parameterscompanyrequiredenvironmentrequiredidempotency_keyexpected_versionrequired
summer_reports_themes_get
Read one saved recurring-issue report and its source snapshot, including reports older than the latest list
Read one saved recurring-issue report and its source snapshot, including reports older than the latest list. Requires current operational company access.
Parametersreportrequiredcompanyrequiredenvironmentrequired
summer_reports_themes_list
Read the latest private recurring-issue reports, original case references, source coverage, generation status and human review
Read the latest private recurring-issue reports, original case references, source coverage, generation status and human review. Generated themes are suggestions, not verified causes.
Parameterscompanyrequiredenvironmentrequired
summer_reports_themes_generate
Generate a private recurring-issue report from the admitted case-summary cohort
Generate a private recurring-issue report from the admitted case-summary cohort. One immutable request ID prevents duplicate inference. No customer, knowledge or publication effect.
Parameterstorequiredfromrequiredcompanyrequiredrequest_idrequiredenvironmentrequiredidempotency_key
summer_reports_themes_review
Record a human disposition on a saved recurring-issue theme at its expected revision
Record a human disposition on a saved recurring-issue theme at its expected revision. Retains the original analysis and source references; does not change cases or company knowledge.
Parametersthemerequiredreasonrequiredreportrequiredcompanyrequireddispositionrequiredenvironmentrequiredidempotency_keyexpected_revisionrequired
summer_workflows_list
Read built-in tasks and company/environment-owned workflow templates
Read built-in tasks and company/environment-owned workflow templates. Selecting one never runs work.
Parameterscompanyrequiredretiredenvironmentrequired
summer_workflows_history
Read the original revisions and authenticated edits for a saved workflow
Read the original revisions and authenticated edits for a saved workflow.
Parameterscompanyrequiredworkflowrequiredenvironmentrequired
summer_workflows_save
Save, retire or restore a task template with its expected revision
Save, retire or restore a task template with its expected revision. Changes no case or effect authority.
Parametersidrequirednamerequiredreasonrequiredcompanyrequiredretiredrequireddescriptionrequiredenvironmentrequiredinstructionsrequiredidempotency_keyexpected_revisionrequired
summer_workflows_request_text
Prepare editable operator guidance from an exact active workflow revision and feedback
Prepare editable operator guidance from an exact active workflow revision and feedback. Starts no investigation and executes no action.
Parametersidrequiredcompanyrequiredfeedbackenvironmentrequiredexpected_revisionrequired
summer_support_policy_read
Read business hours, holidays, response commitments and scheduled policy revisions
Read business hours, holidays, response commitments and scheduled policy revisions.
Parameterscompanyrequired
summer_support_policy_update
Save business hours and response commitments with the expected revision and an effective date
Save business hours and response commitments with the expected revision and an effective date.
ParametersreasonrequiredcompanyrequiredcalendarrequiredcommitmentsrequiredeffectiveAtrequiredidempotency_keyexpectedRevisionrequiredpauseOnCustomerWaitrequired
summer_saved_replies_list
Read company saved replies, optionally including retired replies
Read company saved replies, optionally including retired replies.
Parameterscompanyrequiredretired
summer_saved_replies_save
Create, edit, retire or restore a saved reply with its expected revision and reason
Create, edit, retire or restore a saved reply with its expected revision and reason. Sends nothing. API reference: https://api.gosummer.ai/v1/openapi.json
Parametersidrequiredbodyrequirednamerequiredreasonrequiredcompanyrequiredretiredrequiredidempotency_keyexpectedRevisionrequired
summer_saved_replies_history
Read original revisions of a saved reply
Read original revisions of a saved reply.
Parametersreplyrequiredcompanyrequired
summer_saved_views_list
Read this person's saved inbox views and shared company views
Read this person's saved inbox views and shared company views.
Parameterscompanyrequired
summer_saved_views_save
Save a personal or shared inbox view
Save a personal or shared inbox view. Known case filters are normalized by the same service as the UI.
Parametersidrequiredkindrequirednamerequiredqueryrequiredsharedrequiredcompanyrequiredidempotency_key
summer_saved_views_delete
Remove an owned inbox view, retaining the database's ownership checks
Remove an owned inbox view, retaining the database's ownership checks.
Parametersidrequiredkindrequiredcompanyrequiredidempotency_key
summer_quality_scenarios_list
Read quality scenarios, assessments and current outcomes
Read quality scenarios, assessments and current outcomes.
Parameterscompanyrequired
summer_quality_scenarios_get
Read one scenario and its saved assessments
Read one scenario and its saved assessments.
Parameterscompanyrequiredscenariorequired
summer_quality_scenarios_save
Create, revise or retire a quality scenario, with expected revision and reason
Create, revise or retire a quality scenario, with expected revision and reason.
Parametersidrequiredkindrequiredfieldsrequiredreasonrequiredcompanyrequiredretiredrequiredidempotency_keyexpectedRevisionrequired
summer_quality_assessments_save
Record an evidence-backed assessment or correction
Record an evidence-backed assessment or correction. Does not approve a plan or customer action.
ParametersidrequiredkindrequirednotesrequiredchecksrequiredcompanyrequiredoutcomerequiredrunKindrequiredcorrectsrequiredscenarioIdrequiredrunReferencerequiredidempotency_key
summer_quality_corrections_list
Read evidence-backed corrections to previous quality assessments
Read evidence-backed corrections to previous quality assessments.
Parameterscompanyrequired
summer_privacy_requests_list
Read privacy export/deletion requests, status and original event history
Read privacy export/deletion requests, status and original event history. Does not export or delete data.
Parameterscompanyrequired
summer_privacy_requests_create
File an export or deletion request for human review
File an export or deletion request for human review. Cannot approve, perform or attest completion of the work.
ParametersidrequiredkindrequiredscoperequiredreasonrequiredcompanyrequiredrequestKindrequiredsubjectKindrequiredsubjectLabelrequiredidempotency_key
summer_work_routing_read
Read eligible teammates and automatic owner/reviewer routing settings
Read eligible teammates and automatic owner/reviewer routing settings.
Parameterscompanyrequired
summer_work_routing_update
Save automatic owner/reviewer routing with the expected version
Save automatic owner/reviewer routing with the expected version. Does not grant roles or approval authority.
Parameterscompanyrequiredversionrequiredissue_moderequiredreview_moderequiredissue_membersrequiredreview_membersrequiredidempotency_key
summer_cases_engineering_list
Read private engineering issue associations, optionally checking original GitHub state
Read private engineering issue associations, optionally checking original GitHub state. Does not close cases or send replies.
Parameterscaserequiredcompanyrequiredrefreshenvironmentrequired
summer_cases_similar_list
Read bounded original case-summary text matches, with source observation and matching terms
Read bounded original case-summary text matches, with source observation and matching terms. Does not establish customer identity, link cases, call a model or start work.
Parameterscaserequiredlimitcompanyrequiredenvironmentrequired
summer_slack_discussions_channels
Read connected Slack posting channels, or inspect the current internal channel name/privacy, posting revision and authenticated sender
Read connected Slack posting channels, or inspect the current internal channel name/privacy, posting revision and authenticated sender. Enables no grant and posts nothing.
Parameterschannelcompanyrequiredenvironmentrequired
summer_cases_discussions_read
Read original Slack replies for an exact recorded case discussion
Read original Slack replies for an exact recorded case discussion. A root supplied for an unknown send must match the saved original sender, approved text and operation metadata before its source can be retained. Never posts or approves work.
Parameterscaserequiredrootcursorcompanyrequiredoperationrequiredenvironmentrequired
summer_cases_discussions_list
Read case-linked Slack discussion receipts and original thread links
Read case-linked Slack discussion receipts and original thread links. Unknown posting stays unknown; no message is sent.
Parameterscaserequiredcompanyrequiredenvironmentrequired
summer_cases_assignment_read
Read a case's issue owner, plan reviewer and eligible teammates
Read a case's issue owner, plan reviewer and eligible teammates.
Parameterscaserequiredcompanyrequiredenvironmentrequired
summer_cases_assignment_update
Assign an issue owner or plan reviewer with the previous owner as a conflict check
Assign an issue owner or plan reviewer with the previous owner as a conflict check. Does not grant roles or approve a plan.
ParameterscaserequiredcompanyrequiredmemberIdrequiredpreviousrequiredrequestIdrequiredenvironmentrequiredidempotency_key
summer_reports_credits
Read all-time and month-to-date credits, pending reservations and monthly usage in the company timezone
Read all-time and month-to-date credits, pending reservations and monthly usage in the company timezone.
Parameterscompanyrequiredenvironmentrequired
summer_reports_samples_list
Read paginated original issue/message references behind service counts and timing samples, with date/channel/hour filters in the company timezone
Read paginated original issue/message references behind service counts and timing samples, with date/channel/hour filters in the company timezone. No messages are sent or marked read.
ParametersfromhourlimitoffsetchannelcompanyrequiredmeasurerequiredthroughweekdayobservedAtenvironmentrequired
summer_reports_service_metrics
Read response and resolution metrics, 90-day daily issue/message and timing trends, and weekday/hour incoming-message heatmaps in the company timezone
Read response and resolution metrics, 90-day daily issue/message and timing trends, and weekday/hour incoming-message heatmaps in the company timezone. Missing timings stay unmeasured.
Parameterscompanyrequiredenvironmentrequired
summer_reports_delivery
Read delivery attempts, failures and recorded results
Read delivery attempts, failures and recorded results. Does not retry a delivery.
Parameterscompanyrequiredenvironmentrequired
summer_reports_commitments
Read outstanding customer promises and unfinished work
Read outstanding customer promises and unfinished work.
Parameterscompanyrequiredenvironmentrequired
summer_human_tasks_list
Read work that Summer agents or blocked approvals asked a person to do, with owners, due times, recorded outcomes and change history for one selected task
Read work that Summer agents or blocked approvals asked a person to do, with owners, due times, recorded outcomes and change history for one selected task.
Parameterscaseminetaskstatuscompanyrequiredenvironmentrequired
summer_human_tasks_update
Complete, dismiss, reopen or assign a human task with its expected version
Complete, dismiss, reopen or assign a human task with its expected version. Records the person and outcome. Does not approve a plan or change customer records.
ParameterstaskIdrequiredcompanyrequiredoutcomeversionrequiredoperationrequiredassigneeIdenvironmentrequiredidempotency_key
summer_agent_exclusions_list
Read the company's sender exclusions and original edit history
Read the company's sender exclusions and original edit history. Changes retain human approval.
Parameterscompanyrequiredenvironmentrequired
summer_messenger_conversations_list
Search and filter the complete Messenger inbox, including visitor conversations without Ops cases
Search and filter the complete Messenger inbox, including visitor conversations without Ops cases.
Parametersqsortlimitcursorfiltercompanyrequiredenvironmentrequiredconversation
summer_messenger_conversations_get
Read original Messenger messages with saved human sender_display_name, contact form details, read receipts and attachments without marking the chat read
Read original Messenger messages with saved human sender_display_name, contact form details, read receipts and attachments without marking the chat read.
Parametersviewaftercompanyrequiredfile_idenvironmentrequiredconversationrequiredreceipt_after
summer_pharmacy_calls_settings_read
Read demo pharmacy-call voice, vocabulary and change history
Read demo pharmacy-call voice, vocabulary and change history. Starts no call.
Parameterscompanyrequiredenvironmentrequired
summer_pharmacy_calls_settings_update
Save the demo pharmacy-call voice and vocabulary with the expected revision
Save the demo pharmacy-call voice and vocabulary with the expected revision. Starts no call.
Parameterscompanyrequiredrevisionrequiredvoice_idrequiredvocabularyrequiredenvironmentrequiredidempotency_key
summer_imports_intercom_list
Read Intercom migration previews, saved progress, counts, errors and Summer inbox destinations
Read Intercom migration previews, saved progress, counts, errors and Summer inbox destinations. Does not start an import.
Parameterscompanyrequiredenvironmentrequired
summer_imports_intercom_preview
Check the saved Intercom key against a workspace and preview contact/conversation counts
Check the saved Intercom key against a workspace and preview contact/conversation counts. Save the selected Summer inbox and explicit account-matching choice. Import nothing; send nothing.
Parametersregioncompanyrequiredworkspacerequiredenvironmentrequiredinstallationrequiredmatch_accountsidempotency_key
summer_imports_intercom_control
Start, pause, resume or rescan an Intercom migration with its current version
Start, pause, resume or rescan an Intercom migration with its current version. Optional incremental sync reconciles the same original IDs; no replies, notifications or agent runs. Names/email never verify an account.
Parametersactionrequiredimportrequiredcompanyrequiredkeep_syncenvironmentrequiredidempotency_keyexpected_versionrequired
summer_imports_intercom_profiles
Search imported Summer profiles and their original conversation references
Search imported Summer profiles and their original conversation references. Contact details do not establish account ownership.
Parametersqoffsetcompanyrequiredworkspacerequiredenvironmentrequired
summer_teammates_names_list
List suggested female and gender-neutral teammate names whose gosummer
List suggested female and gender-neutral teammate names whose gosummer.ai address is still free. Each has a suggested photo_url to show; create with use_suggested_photo: true to add that name, address and photo together. Any typed first and last name also works.
Parameterscompanyrequired
summer_teammates_list
List the company's teammates with their address, photo, status, unread mail count and Slack connection
List the company's teammates with their address, photo, status, unread mail count and Slack connection.
Parameterscompanyrequired
summer_teammates_create
Add a teammate
Add a teammate. A managed teammate gets [email protected], unique across Summer. A company-managed teammate uses the company's own address. Invites no one, joins no Slack workspace and sends nothing.
Parameterscompanyrequiredrequestrequiredidempotency_key
summer_teammates_update
Change a teammate's shown name, photo or status, with the expected revision and a reason
Change a teammate's shown name, photo or status, with the expected revision and a reason. Retiring disconnects Slack and keeps the address reserved.
Parametersreasonrequiredstatusrequiredcompanyrequiredrevisionrequiredteammaterequiredavatar_urlrequireddisplay_namerequiredidempotency_key
summer_teammates_slack_disconnect
Disconnect a teammate's Slack account from Summer and delete its saved token
Disconnect a teammate's Slack account from Summer and delete its saved token. The Slack account itself stays in the workspace. Connecting needs the Slack sign-in in Summer settings.
Parametersreasonrequiredcompanyrequiredteammaterequiredidempotency_key
summer_teammates_setup_status
Live status of each step to get a teammate posting approved replies in vendor Slack channels: Slack connected, teammate added, Slack invitation received, teammate connected, chosen as sender, in each
Live status of each step to get a teammate posting approved replies in vendor Slack channels: Slack connected, teammate added, Slack invitation received, teammate connected, chosen as sender, in each vendor channel, and agent replies allowed there. Unreadable sources are reported as unknown.
Parameterscompanyrequired
summer_teammates_slack_channels_join
Join a public Slack channel as the connected teammate
Join a public Slack channel as the connected teammate. Sends no message. A private or shared channel needs someone in it to /invite the teammate in Slack.
Parameterschannelrequiredcompanyrequiredteammaterequiredidempotency_key
summer_teammates_mailbox_list
List mail received by a Summer-managed teammate, newest first, with sender, subject and a short preview
List mail received by a Summer-managed teammate, newest first, with sender, subject and a short preview. Company-managed teammates have no mailbox in Summer.
Parameterslimitbeforecompanyrequiredteammaterequired
summer_teammates_mailbox_get
Read one message in a Summer-managed teammate's mailbox, including its text
Read one message in a Summer-managed teammate's mailbox, including its text. Marks it read for the team.
Parameterscompanyrequiredmessagerequiredteammaterequired
summer_client_status
Check live Summer MCP/API versions, old client warnings and the seven-day discovery refresh interval
Check live Summer MCP/API versions, old client warnings and the seven-day discovery refresh interval. Optional cached client versions and the last successful check timestamp distinguish known and unknown status.
Parameterscli_versionmcp_versionlast_checked_at
summer_account_me
Show the signed-in person, Summer access status, profile photo path and this connection's grant
Show the signed-in person, Summer access status, profile photo path and this connection's grant.
Takes no parameters.
summer_account_photo_remove
Remove your own profile photo
Remove your own profile photo. Replies you send afterward show your initials; earlier replies keep the photo they were sent with.
Parametersidempotency_key
summer_account_companies_list
List companies the person can access and whether this connection includes each one
List companies the person can access and whether this connection includes each one.
Takes no parameters.
summer_account_access_request_read
Read the person's Summer access request
Read the person's Summer access request. Approval is a separate Summer team decision.
Takes no parameters.
summer_account_access_request_submit
Submit or update a Summer access request
Submit or update a Summer access request. This cannot approve access.
Parametersnoterequiredcompany_namerequiredidempotency_key
summer_account_connections_list
List this person's agent connections, grants, last use and expiry
List this person's agent connections, grants, last use and expiry.
Takes no parameters.
summer_account_connections_revoke
Revoke one of this person's agent connections immediately
Revoke one of this person's agent connections immediately.
Parametersreasonconnectionrequiredidempotency_key
summer_guides_get
Read the company's editable guidebook, draft articles, assets and publication state
Read the company's editable guidebook, draft articles, assets and publication state. Customer guides share the existing company knowledge source.
Parameterscompanyrequired
summer_guides_save
Create or edit guidebook details at the expected version
Create or edit guidebook details at the expected version. Saves a private draft; does not publish.
Parametersreasonrequiredcompanyrequiredsettingsrequiredidempotency_keyexpected_versionrequired
summer_guides_articles_get
Read an editable guide article and its current knowledge revision
Read an editable guide article and its current knowledge revision.
Parametersarticlerequiredcompanyrequired
summer_guides_articles_save
Create or edit a Markdown customer article with source references and managed asset IDs
Create or edit a Markdown customer article with source references and managed asset IDs. Saves a draft in the shared knowledge library; later edits do not change a published release.
Parametersslugrequiredtitlerequiredtopicrequiredreasonrequiredarticlerequiredcompanyrequiredcontentrequiredsummaryrequiredasset_idsrequiredsource_urlrequiredverified_atidempotency_key+1 more
summer_guides_preview
Read the exact current draft, article revisions and authenticated preview URL before publishing
Read the exact current draft, article revisions and authenticated preview URL before publishing. No public access token is issued.
Parameterscompanyrequired
summer_guides_authoring
Read the company's reviewed guide-authoring brief, draft article references and publication state
Read the company's reviewed guide-authoring brief, draft article references and publication state. This read starts no model run and changes no customer data.
Parameterscompanyrequired
summer_guides_publish
Publish the exact selected article revisions and ready media to the company's customer help center
Publish the exact selected article revisions and ready media to the company's customer help center. Requires explicit publication authority; does not approve customer business actions.
Parametersreasonrequiredcompanyrequiredarticlesrequiredidempotency_keyexpected_versionrequired
summer_guides_unpublish
Remove the company's guide and release media from Summer's public serving path at the expected version
Remove the company's guide and release media from Summer's public serving path at the expected version. Downloaded copies cannot be recalled.
Parametersreasonrequiredcompanyrequiredidempotency_keyexpected_versionrequired
summer_guides_history
Read the company's guide edits, upload and publication history
Read the company's guide edits, upload and publication history.
Parameterscompanyrequired
summer_guides_hosting_get
Read the optional custom guide domain, DNS instructions and verified HTTPS status
Read the optional custom guide domain, DNS instructions and verified HTTPS status. Summer-hosted guide URLs need no customer DNS setup.
Parameterscompanyrequired
summer_guides_hosting_save
Save or remove a custom guide hostname at the expected version
Save or remove a custom guide hostname at the expected version. Saving a name does not verify ownership or provision HTTPS.
Parameterscompanyrequiredhostnamerequiredidempotency_keyexpected_versionrequired
summer_guides_hosting_verify
Check the saved domain's DNS ownership, attach it through Summer's hosting connection and verify HTTPS
Check the saved domain's DNS ownership, attach it through Summer's hosting connection and verify HTTPS. Returns pending until each check succeeds.
Parameterscompanyrequiredidempotency_keyexpected_versionrequired
summer_assets_list
List the company's private guide media, metadata and upload status
List the company's private guide media, metadata and upload status. Uploading does not make a file public.
Parameterscompanyrequired
summer_assets_get
Read one guide asset, checksum and resumable chunk receipts
Read one guide asset, checksum and resumable chunk receipts. No secret upload capability is returned.
Parametersassetrequiredcompanyrequired
summer_assets_uploads_create
Start or recover a private resumable Markdown, image, video, PDF or caption upload from metadata
Start or recover a private resumable Markdown, image, video, PDF or caption upload from metadata. File bytes are transferred separately; this hosted endpoint has no local filesystem access.
Parametersidrequiredsha256requiredcaptionrequiredcompanyrequiredalt_textrequiredfilenamerequiredmedia_typerequiredprovenancerequiredtranscriptbyte_lengthrequiredidempotency_keyposter_asset_id
summer_assets_uploads_complete
Verify the original size, content signature and SHA-256 against saved private bytes, then mark a guide upload ready
Verify the original size, content signature and SHA-256 against saved private bytes, then mark a guide upload ready. A ready file remains private until published in a guide.
Parametersassetrequiredcompanyrequiredidempotency_key
summer_assets_edit
Edit guide media captions, alt text, provenance, transcript or poster at the expected version, or retire unused media
Edit guide media captions, alt text, provenance, transcript or poster at the expected version, or retire unused media. Published releases keep their pinned metadata.
Parametersassetrequiredreasonrequiredcaptionrequiredcompanyrequiredretiredalt_textrequiredprovenancerequiredtranscriptidempotency_keyposter_asset_idexpected_versionrequired
summer_company_capabilities
What this connection can do here, with a reason for everything unavailable
What this connection can do here, with a reason for everything unavailable.
Parameterscompanyrequiredenvironmentrequired
summer_company_setup_status
Saved, verified, pending, unavailable and enabled state for each setup item
Saved, verified, pending, unavailable and enabled state for each setup item.
Parameterscompanyrequiredenvironmentrequired
summer_capability_checks_list
Read the same operational capability checklist, results, discovery paths and review history shown in Summer
Read the same operational capability checklist, results, discovery paths and review history shown in Summer. Every usable API, browser or knowledge path can count.
Parameterscompanyrequiredenvironmentrequired
summer_capability_checks_get
Read one capability, its concrete test, evidence and latest 20 review records
Read one capability, its concrete test, evidence and latest 20 review records.
Parameterscompanyrequiredcapabilityrequiredenvironmentrequired
summer_capability_checks_save
Edit a capability expectation or add a business-specific custom_ capability with a reason
Edit a capability expectation or add a business-specific custom_ capability with a reason. Resets its result and retains history. Does not create a provider tool or grant execution access.
Parametersnotesrequiredcompanyrequiredcapabilityrequireddefinitionrequiredenvironmentrequiredidempotency_keyexpected_versionrequired
summer_capability_checks_report
Record the setup agent's capability assessment with original evidence and the path Summer can discover and use
Record the setup agent's capability assessment with original evidence and the path Summer can discover and use. A pass needs evidence and a discovery path. Reports are labeled as agent-reported, never human approval or independently verified execution.
Parametersnotesrequiredstaterequiredcompanyrequiredevidencerequiredcapabilityrequiredenvironmentrequiredfulfillmentidempotency_keyexpected_versionrequired
summer_capability_checks_test
Request a read-only Summer capability test on an authorized sample case
Request a read-only Summer capability test on an authorized sample case. Also needs investigations.request and current runtime access. Does not approve or execute customer changes.
Parameterscase_idrequiredcompanyrequiredcapabilityrequiredenvironmentrequiredidempotency_keyexpected_versionrequired
summer_company_settings_read
Read company-wide settings, including the email subject customers see on new support emails
Read company-wide settings, including the email subject customers see on new support emails. Changes affect every environment.
Parameterscompanyrequired
summer_company_settings_update
Update company-wide settings with the expected version
Update company-wide settings with the expected version. Affects every environment.
Parametersnamerequirednoterequiredcompanyrequiredtimezonerequiredworkflowrequiredemail_subjectidempotency_keyexpected_versionrequired
summer_integrations_list
List provider integrations, their categories, required fields, alternative credential sets and saved metadata
List provider integrations, their categories, required fields, alternative credential sets and saved metadata. Filter by search, category or connection. Connected means all required credentials and one complete alternative set are available, not a live provider check. read_only integrations are read with the company's own key and never written through. Never returns values.
Parameterssearchcompanyrequiredcategoryconnectionenvironmentrequired
summer_integrations_save
Save a custom integration's description, setup instructions and credential field names
Save a custom integration's description, setup instructions and credential field names. This saves metadata only, without credential values or a live connection check.
Parametersnamerequiredfieldsrequiredcompanyrequireddescriptionenvironmentrequiredintegrationrequiredinstructionsidempotency_keyexpected_versionrequired
summer_integrations_setup_prompt
Prepare an integration-specific MCP setup prompt and Codex or Claude Code app links
Prepare an integration-specific MCP setup prompt and Codex or Claude Code app links. Includes the selected company, environment and setup brief, never credential values. Does not launch an app or change configuration.
Parametersidnamerequiredfieldscompanyrequireddescriptionenvironmentrequiredinstructions
summer_credentials_list
List saved credential names, sources and versions
List saved credential names, sources and versions. Never returns values.
Parameterscompanyrequiredenvironmentrequired
summer_credentials_set
Save one selected credential value or Doppler reference
Save one selected credential value or Doppler reference. Replacing an active credential needs credentials.replace. Returns metadata only. Returns a local CLI command when a secret is involved.
Parametersnamerequiredsourcerequiredcompanyrequiredenvironmentrequiredsecret_nameidempotency_keyexpected_versionrequired
summer_knowledge_list
List current company knowledge documents
List current company knowledge documents. Knowledge is company-wide, not per environment. Pass tag to list documents with that tag, such as an integration name (slack, beluga, mdi), which is how Summer shows knowledge related to an integration.
Parameterstagqueryoffsetcompanyrequired
summer_knowledge_create
Upload a new company knowledge document with original revision history
Upload a new company knowledge document with original revision history. The shared library is used by all roles and environments. Existing document IDs are refused. API reference: https://api.gosummer.ai/v1/openapi.json
Parametersidrequiredpathrequiredtagsreasonrequiredcompanyrequiredcontentrequiredidempotency_key
summer_knowledge_get
Read one company knowledge document and its current revision
Read one company knowledge document and its current revision.
Parameterscompanyrequireddocumentrequired
summer_knowledge_history
Read the edit history of a company knowledge document
Read the edit history of a company knowledge document.
Parametersoffsetcompanyrequireddocumentrequired
summer_knowledge_edit
Edit an existing company knowledge document with the expected revision and a reason
Edit an existing company knowledge document with the expected revision and a reason. Affects every environment and later runs.
Parametersreasonrequiredstatusrequiredcompanyrequiredcontentrequireddocumentrequiredrevisionrequiredidempotency_key
summer_messenger_installations_list
List Messenger installations in this environment
List Messenger installations in this environment. Signing keys are never returned.
Parameterscompanyrequiredenvironmentrequired
summer_messenger_installations_create
Create an installation with a client-chosen ID
Create an installation with a client-chosen ID. The one-time signing key goes to the trusted local helper, never to model-visible output. Returns a local CLI command when a secret is involved.
Parametersidrequiredcompanyrequiredsettingsrequiredenvironmentrequiredidempotency_key
summer_messenger_installations_update
Update installation settings with the expected version
Update installation settings with the expected version. Keeps the signing key.
Parameterscompanyrequiredsettingsrequiredenvironmentrequiredinstallationrequiredidempotency_keyexpected_versionrequired
summer_messenger_installations_rotate_key
Issue a new signing key
Issue a new signing key. Existing signed sessions end. The key goes to the trusted local helper only. Returns a local CLI command when a secret is involved.
Parameterscompanyrequiredenvironmentrequiredinstallationrequiredidempotency_keyexpected_versionrequired
summer_messenger_assistant_read
Read assistant settings per installation and whether the managed runtime is enabled
Read assistant settings per installation and whether the managed runtime is enabled.
Parameterscompanyrequiredenvironmentrequired
summer_messenger_leads_list
Read consented website leads for this company and environment
Read consented website leads for this company and environment. Includes volunteered contact details and original submission references.
Parametersbeforecompanyrequiredenvironmentrequired
summer_messenger_assistant_update
Update assistant instructions and escalation permission with the expected revision
Update assistant instructions and escalation permission with the expected revision. Company facts live in shared knowledge. Cannot raise the spending limit.
Parameterscompanyrequiredrevisionrequiredsettingsrequiredenvironmentrequiredinstallationrequiredidempotency_key
summer_messenger_voice_read
Read voice chat settings per installation, the voice services and their voices, published help article count and the voice assistant's update status
Read voice chat settings per installation, the voice services and their voices, published help article count and the voice assistant's update status.
Parameterscompanyrequiredenvironmentrequired
summer_messenger_voice_update
Update voice chat settings with the expected revision
Update voice chat settings with the expected revision. Summer updates the voice assistant from these settings and the company's published help articles.
Parameterscompanyrequiredrevisionrequiredsettingsrequiredenvironmentrequiredinstallationrequiredidempotency_key
summer_messenger_email_read
Read support email addresses: the private forwarding address, the one DNS record to add, whether mail has arrived, sending status, Gmail forwarding codes and emails that need a look
Read support email addresses: the private forwarding address, the one DNS record to add, whether mail has arrived, sending status, Gmail forwarding codes and emails that need a look.
Parameterscompanyrequiredenvironmentrequired
summer_messenger_email_create
Add a support email address
Add a support email address. Summer creates its private forwarding address and signing key and returns the DNS record to add. The address starts off; nothing is sent.
Parameterscompanyrequiredenvironmentrequireddisplay_namerequiredidempotency_keyinstallation_idsupport_addressrequired
summer_messenger_email_update
Change the sender name or turn a support email address on or off, with the expected version
Change the sender name or turn a support email address on or off, with the expected version. Turning on needs one received email. Turning off keeps every email but stops new conversations and replies.
Parameterschannelrequiredcompanyrequiredenabledversionrequiredenvironmentrequireddisplay_nameidempotency_key
summer_messenger_email_check
Check forwarding, the DNS record and sending status for one support email address now
Check forwarding, the DNS record and sending status for one support email address now. Records the latest sending status; sends nothing.
Parameterschannelrequiredcompanyrequiredenvironmentrequired
summer_slack_identity_read
Read the support name and avatar shown on Summer's approved Slack replies, whether the Slack install allows them, and the change history
Read the support name and avatar shown on Summer's approved Slack replies, whether the Slack install allows them, and the change history.
Parameterscompanyrequired
summer_slack_identity_update
Set the support name and avatar on Summer's approved Slack replies, with the expected revision and a reason
Set the support name and avatar on Summer's approved Slack replies, with the expected revision and a reason. Null values use the plain Summer Ellis identity. Sends no message.
Parametersreasonrequiredcompanyrequiredrevisionrequiredavatar_urlrequireddisplay_namerequiredidempotency_key
summer_slack_channels_posting_update
Allow or stop approved agent replies in one vendor Slack channel, with the expected version from teammates
Allow or stop approved agent replies in one vendor Slack channel, with the expected version from teammates.setup.status and a reason. Each reply still needs a person to approve its exact text. Sends no message.
Parametersreasonrequiredallowedrequiredchannelrequiredcompanyrequiredidempotency_keyexpected_versionrequired
summer_slack_sender_update
Choose who posts approved vendor Slack replies: the Summer Ellis app (null) or a Summer Teammate, which then posts from its own Slack account
Choose who posts approved vendor Slack replies: the Summer Ellis app (null) or a Summer Teammate, which then posts from its own Slack account. Uses the revision from slack.identity.read and a reason. Sends no message.
Parametersreasonrequiredcompanyrequiredrevisionrequiredteammate_idrequiredidempotency_key
summer_slack_channels_list
List the Slack channels the company selected for Summer, with read and post access and each channel's vendor and purpose
List the Slack channels the company selected for Summer, with read and post access and each channel's vendor and purpose. Agents see the vendor and purpose with every vendor Slack read.
Parameterscompanyrequired
summer_slack_channels_describe
Set which vendor a selected Slack channel is for and what it is used for, with a reason
Set which vendor a selected Slack channel is for and what it is used for, with a reason. Null clears a field. Changes guidance for agents and people; sends no message and changes no channel access.
Parametersreasonrequiredvendorrequiredchannelrequiredcompanyrequiredpurposerequiredidempotency_keyinstallation_idrequired
summer_company_team_read
List company members and pending invitations
List company members and pending invitations. Role changes and invitations stay in Summer.
Parameterscompanyrequired
summer_messenger_conversations_assistant
Pause the assistant in one conversation so a person can take over, or ask it to resume
Pause the assistant in one conversation so a person can take over, or ask it to resume. Pausing stops automatic replies immediately.
Parameterspausedrequiredcompanyrequiredenvironmentrequiredconversationrequiredidempotency_key
summer_verification_run
Run supported harmless checks
Run supported harmless checks. Unsupported checks are reported as unsupported, never as passed.
Parameterscompanyrequiredtargetsrequiredenvironmentrequiredidempotency_key
summer_cases_list
List company-owned cases or conversations with emotion filters (sentiment: happy, neutral, upset, angry, sad, mixed or unknown), ordering, page size, coverage and a cursor
List company-owned cases or conversations with emotion filters (sentiment: happy, neutral, upset, angry, sad, mixed or unknown), ordering, page size, coverage and a cursor. Operational rows include conversationSentiment (label, confidence, evidence references, source, assessed_at and pending freshness). Operational filters require the company's operational connection; Messenger-only results include coverage limits.
ParameterslanemineplansortlimitcursorstatuscompanyrequiredpastSlasandboxautonomycategory+12 more
summer_cases_search
Find cases by customer name, email, phone, date of birth, support code, order or tracking number, vendor or Stripe ID, or message words, with status and date filters
Find cases by customer name, email, phone, date of birth, support code, order or tracking number, vendor or Stripe ID, or message words, with status and date filters. Returns one current workspace per verified customer (explicit splits stay separate), with the actual ticket code, all issue references, plan and run progress, orders and message excerpts. Message case_id opens the workspace; source_case_id retains the original issue. Search matches are leads, not proof of identity or completed work.
Parametersqdoblimitstatuscompanyrequiredmessagesenvironmentrequiredinclude_testcreated_afteractivity_aftercreated_beforeactivity_before
summer_cases_get
Read one case or conversation with its original messages and related records
Read one case or conversation with its original messages and related records. Operational records include workspace with the current customer ticket and all owned issue references, plus the shared saved timeline. The original case identity is retained. Includes conversationSentiment with happy, neutral, upset, angry, sad, mixed or unknown, confidence, exact evidence references, source, assessed_at and pending freshness; an estimate does not prove resolution.
Parameterscaserequiredaftercompanyrequiredenvironmentrequired
summer_cases_attachment
Get a short-lived download for an attachment that belongs to this case
Get a short-lived download for an attachment that belongs to this case.
Parameterscaserequiredcompanyrequiredattachmentrequiredenvironmentrequired
summer_cases_customer_profile
Read the case customer's profile: name, date of birth, contact details, default shipping and billing addresses, each order's addresses and earlier addresses
Read the case customer's profile: name, date of birth, contact details, default shipping and billing addresses, each order's addresses and earlier addresses. A saved address does not prove where an existing order ships.
Parameterscaserequiredcompanyrequiredenvironmentrequired
summer_investigations_list
Read shared investigation runs, saved plans, approval state and execution receipts across the verified customer’s cases, including historical issues
Read shared investigation runs, saved plans, approval state and execution receipts across the verified customer’s cases, including historical issues. Each run retains its original support_case_id; use that ID for write operations and original run evidence.
Parameterscaserequiredcompanyrequiredenvironmentrequired
summer_runs_list
List investigation and execution runs across cases, newest first, with status, plan approval and date filters
List investigation and execution runs across cases, newest first, with status, plan approval and date filters.
Parameterskindsortcursorstatuscompanyrequiredexecutedenvironmentrequiredcreated_aftercreated_before
summer_investigations_request
Ask Summer to investigate the case, or revise a saved plan with feedback
Ask Summer to investigate the case, or revise a saved plan with feedback. Completion is not approval.
Parameterscaserequiredcompanyrequiredrequestrequiredenvironmentrequiredidempotency_key
summer_investigations_plan_edit
Edit wording in the current saved plan at its expected revision, including proposed company knowledge text
Edit wording in the current saved plan at its expected revision, including proposed company knowledge text. Preserves targets, amounts, feedback sources and selected option. Invalidates prepared approval; does not apply knowledge or customer changes.
Parameterscaserequirededitsrequiredreasonrequiredcompanyrequiredrequestrequiredenvironmentrequiredidempotency_keyexpected_revisionrequired
summer_actions_prepare
Prepare the exact current plan and return its execution ID, approval hash and reviewed work
Prepare the exact current plan and return its execution ID, approval hash and reviewed work. Does not approve or execute. A delegated actions.approve grant can approve authorized work through API, CLI or MCP.
Parameterscaserequiredcompanyrequiredenvironmentrequiredidempotency_keyplan_request_idrequiredreplaces_execution
summer_actions_approve
Approve the exact prepared execution under the authenticated operator's delegated authority
Approve the exact prepared execution under the authenticated operator's delegated authority. Use only for work the operator authorized, read the prepared review first, and pass its exact hash. Records the authorization and queues ordinary execution; approval does not prove a customer outcome. No caller-supplied approver identity or identity-verification attestation.
Parameterscaserequiredcompanyrequiredexecutionrequiredenvironmentrequiredapproval_hashrequiredauthorizationrequiredidempotency_key
summer_events_list
Read configuration and activity events after a cursor
Read configuration and activity events after a cursor. Pagination uses next_cursor.
Parametersafterlimitcompanyrequiredenvironmentrequired
summer_service_accounts_list
List the company's service accounts
List the company's service accounts.
Parameterscompanyrequired
summer_service_accounts_save
Create, update, rotate or disable a service account
Create, update, rotate or disable a service account. A new secret goes to the trusted local helper only. Returns a local CLI command when a secret is involved.
Parametersnamerequiredscopesrequiredaccountrequiredcompanyrequireddisableenvironmentsrequiredrotate_secretidempotency_keyexpected_versionrequired
summer_webhooks_list
List webhook endpoints and delivery state
List webhook endpoints and delivery state.
Parameterscompanyrequiredenvironmentrequired
summer_webhooks_save
Create, update, rotate or disable a signed webhook endpoint
Create, update, rotate or disable a signed webhook endpoint. A new signing secret goes to the trusted local helper only. Returns a local CLI command when a secret is involved.
Parametersurlrequiredcompanyrequireddisablewebhookrequiredenvironmentrequiredevent_typesrequiredrotate_secretidempotency_keyexpected_versionrequired
summer_webhooks_replay
Queue past events after a cursor for delivery again to one endpoint
Queue past events after a cursor for delivery again to one endpoint. Receivers deduplicate by event ID.
Parametersafterrequiredlimitcompanyrequiredwebhookrequiredenvironmentrequiredidempotency_key