[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M781J9SPV7SFPSY46QD0PWSS":3,"skill-same:01M781J9SPV7SFPSY46QD0PWSS":47},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":29,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M781J9SPV7SFPSY46QD0PWSS","pm-gong",null,"Gong connector knowledge and safe action guide.","polymetrics-ai\u002Fcli","polymetrics-ai","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F177650388?v=4","01M77Z920R1RTP5NXCP1V1HNMS","Polymetrics","01M77Z921DPWZC4DQSSZNWF82B",7,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-gong\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: pm-gong\ndescription: Gong connector knowledge and safe action guide.\n---\n\n# pm-gong\n\n## Purpose\n\nReads Gong users, calls, scorecards, settings, flows, and related public API resources; executes selected typed POST read-query commands; models Gong mutations, multipart uploads, and top-level array uploads as typed reverse-ETL actions.\n\n## Icon\n\n- id: gong\n- asset: icons\u002Fgong.svg\n- source: upstream_registry\n- review_status: upstream_seeded\n- review_url: https:\u002F\u002Fus-66463.app.gong.io\u002Fsettings\u002Fapi\u002Fdocumentation\n\n## Capabilities\n\n- check=true catalog=true read=true write=true query=false\n- Integration type: api\n\n## Authentication\n\n- Use pm credentials add with --from-env or --value-stdin for secret fields.\n\n## Configuration\n\n- base_url\n- max_pages\n- mode\n- page_size\n- start_date\n- access_key (secret) (required)\n- access_key_secret (secret) (required)\n\n## ETL Streams\n\n- users:\n  - primary key: id\n  - cursor: created\n  - fields: active(boolean), created(string), email_address(string), first_name(string), id(string), last_name(string), manager_id(string), phone_number(string), title(string)\n- calls:\n  - primary key: id\n  - cursor: started\n  - fields: direction(string), duration(integer), id(string), is_private(boolean), language(string), media(string), scheduled(string), scope(string), started(string), system(string), title(string), url(string)\n- scorecards:\n  - primary key: scorecardId\n  - cursor: updated\n  - fields: created(string), enabled(boolean), scorecardId(string), scorecardName(string), updated(string), workspaceId(string)\n- crm_integrations:\n  - fields: created(string), id(string), name(string), title(string), updated(string)\n- workspaces:\n  - fields: created(string), id(string), name(string), title(string), updated(string)\n- trackers:\n  - fields: created(string), id(string), name(string), title(string), updated(string)\n- briefs:\n  - fields: created(string), id(string), name(string), title(string), updated(string)\n- library_folders:\n  - fields: created(string), id(string), name(string), title(string), updated(string)\n- flows:\n  - fields: created(string), id(string), name(string), title(string), updated(string)\n- flow_folders:\n  - fields: created(string), id(string), name(string), title(string), updated(string)\n- call_outcomes:\n  - fields: created(string), id(string), name(string), title(string), updated(string)\n- permission_profiles:\n  - fields: created(string), id(string), name(string), title(string), updated(string)\n\n## Sync Modes\n\n- ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped, incremental_append, incremental_append_deduped\n\n## Reverse ETL Actions\n\n- add_call:\n  - endpoint: POST \u002Fcalls\n  - required fields: actualStart, clientUniqueId, direction, parties, primaryUser\n  - risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval\n- create_permission_profile:\n  - endpoint: POST \u002Fpermission-profile?workspaceId={{ record.workspaceId }}\n  - required fields: workspaceId\n  - risk: high: administrative Gong settings or permissions mutation; requires reverse ETL approval and destructive confirmation\n- update_permission_profile:\n  - endpoint: PUT \u002Fpermission-profile?profileId={{ record.profileId }}\n  - required fields: profileId\n  - risk: high: administrative Gong settings or permissions mutation; requires reverse ETL approval and destructive confirmation\n- update_meeting:\n  - endpoint: PUT \u002Fmeetings\u002F{meetingId}\n  - required fields: meetingId, endTime, invitees, organizerEmail, startTime\n  - risk: medium: mutates Gong API state; requires reverse ETL approval\n- delete_meeting:\n  - endpoint: DELETE \u002Fmeetings\u002F{meetingId}\n  - required fields: meetingId\n  - risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation\n- content_viewed:\n  - endpoint: PUT \u002Fcustomer-engagement\u002Fcontent\u002Fviewed\n  - required fields: contentId, contentTitle, contentUrl, eventTimestamp, reportingSystem\n  - risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval\n- content_shared:\n  - endpoint: PUT \u002Fcustomer-engagement\u002Fcontent\u002Fshared\n  - required fields: contentId, contentTitle, contentUrl, eventTimestamp, reportingSystem\n  - risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval\n- custom_action:\n  - endpoint: PUT \u002Fcustomer-engagement\u002Faction\n  - required fields: eventTimestamp, reportingSystem\n  - risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval\n- register_crm_integration:\n  - endpoint: PUT \u002Fcrm\u002Fintegrations\n  - required fields: name, ownerEmail\n  - risk: medium: mutates Gong API state; requires reverse ETL approval\n- delete_crm_integration:\n  - endpoint: DELETE \u002Fcrm\u002Fintegrations?integrationId={{ record.integrationId }}&clientRequestId={{ record.clientRequestId }}\n  - required fields: integrationId, clientRequestId\n  - risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation\n- add_calls_users_access:\n  - endpoint: PUT \u002Fcalls\u002Fusers-access\n  - risk: medium: mutates Gong API state; requires reverse ETL approval\n- delete_calls_users_access:\n  - endpoint: DELETE \u002Fcalls\u002Fusers-access\n  - risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation\n- create_meeting:\n  - endpoint: POST \u002Fmeetings\n  - required fields: endTime, invitees, organizerEmail, startTime\n  - risk: medium: mutates Gong API state; requires reverse ETL approval\n- integration_settings:\n  - endpoint: POST \u002Fintegration-settings\n  - required fields: integrationTypeSettings\n  - risk: high: administrative Gong settings or permissions mutation; requires reverse ETL approval and destructive confirmation\n- unassign_flows_by_instance_id:\n  - endpoint: POST \u002Fflows\u002Fprospects\u002Funassign-flows-by-instance-id\n  - required fields: flowInstanceIds\n  - risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation\n- unassign_flows_by_crm_id:\n  - endpoint: POST \u002Fflows\u002Fprospects\u002Funassign-flows-by-crm-id\n  - required fields: crmProspectId\n  - risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation\n- submit_flow_prospects_bulk_assignment:\n  - endpoint: POST \u002Fflows\u002Fprospects\u002Fbulk-assignments\n  - required fields: flowId, flowInstanceOwnerEmail, prospects\n  - risk: medium: mutates Gong API state; requires reverse ETL approval\n- assign_prospects:\n  - endpoint: POST \u002Fflows\u002Fprospects\u002Fassign\n  - required fields: crmProspectsIds, flowId, flowInstanceOwnerEmail\n  - risk: medium: mutates Gong API state; requires reverse ETL approval\n- assign_prospects_cool_off_override:\n  - endpoint: POST \u002Fflows\u002Fprospects\u002Fassign\u002Fcool-off-override\n  - required fields: crmProspectsIds, flowId, flowInstanceOwnerEmail\n  - risk: medium: mutates Gong API state; requires reverse ETL approval\n- add_digital_interaction:\n  - endpoint: POST \u002Fdigital-interaction\n  - required fields: content, eventId, eventType, timestamp\n  - risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval\n- purge_phone_number:\n  - endpoint: POST \u002Fdata-privacy\u002Ferase-data-for-phone-number?phoneNumber={{ record.phoneNumber }}\n  - required fields: phoneNumber\n  - risk: critical: destructive Gong data privacy erasure; requires reverse ETL plan, preview, approval, and destructive confirmation\n- purge_email_address:\n  - endpoint: POST \u002Fdata-privacy\u002Ferase-data-for-email-address?emailAddress={{ record.emailAddress }}\n  - required fields: emailAddress\n  - risk: critical: destructive Gong data privacy erasure; requires reverse ETL plan, preview, approval, and destructive confirmation\n- update_task:\n  - endpoint: PATCH \u002Ftasks\u002F{taskId}\n  - required fields: taskId, userId\n  - risk: medium: mutates Gong API state; requires reverse ETL approval\n- upload_call_media:\n  - endpoint: PUT \u002Fv2\u002Fcalls\u002F{{ record.id }}\u002Fmedia\n  - required fields: id, media_file_path\n  - risk: high: uploads call media from a bounded local file path to Gong; file path\u002Fcontent are redacted in plans and require reverse ETL approval\n- upload_crm_entities:\n  - endpoint: POST \u002Fv2\u002Fcrm\u002Fentities\n  - required fields: data_file_path\n  - risk: high: uploads CRM data from a bounded local file path to Gong; file path\u002Fcontent are redacted in plans and require reverse ETL approval\n- upload_crm_entity_schema:\n  - endpoint: POST \u002Fv2\u002Fcrm\u002Fentity-schema\n  - required fields: selected_fields\n  - risk: high: uploads CRM entity schema as a bounded top-level JSON array; use only reviewed table mappings and reverse ETL approval\n- upload_target_assignments:\n  - endpoint: POST \u002Fv2\u002Ftargets\u002F{{ record.targetId }}\u002Fassignments\n  - required fields: targetId, workspaceId, assignments_file_path\n  - risk: high: uploads target assignments from a bounded local file path to Gong; file path\u002Fcontent are redacted in plans and require reverse ETL approval\n\n## Security\n\n- read risk: external Gong API read of call, user, CRM, settings, flow, and activity data; direct reads are bounded and redacted\n- write risk: typed Gong reverse ETL mutations for calls, meetings, CRM, permissions, flows, engagement, multipart uploads, top-level array CRM schema upload, and data privacy erasure\n- approval: reverse ETL writes require plan, preview, approval, execute; destructive\u002Fadmin actions require --confirm destructive; local file upload plans bind a SHA-256 payload identity that is snapshot-verified before network send\n- Never pass secret values in chat, shell arguments, logs, docs, or JSON output.\n\n## Command Surface\n\n- Inspect, read, and safely plan typed Gong operations.\n- Usage: pm gong \u003Ccommand> [flags]\n- Source CLI: Gong API (Public OpenAPI 3.0.1)\n- PM execution policy pm-request-contract-bounds-v1: each max N bytes qualifier is the effective PM request limit, not a provider schema assertion; path\u002Fquery values are measured after exact wire encoding and rejected rather than truncated.\n- Global flags:\n  - --credential (string): Credential name to use for the Gong request.\n  - --connection (string): Alias for --credential.\n  - --config (string_array): Connector config override as key=value.\n  - --json (boolean): Emit machine-readable JSON output.\n  - --limit (integer): Maximum PM ETL records to emit; does not control Gong page size or total provider-side results.\n  - --max-bytes (integer): Maximum direct-read response bytes; typed operations are capped at 16 MiB and each operation may declare a lower limit.\n  - --plan (string): Execute an approved reverse-ETL plan by id.\n  - --preview (boolean): Preview a reverse-ETL write command without making a network mutation.\n  - --approval-token-stdin (boolean): Read the approval token as one bounded line from standard input.\n  - --confirm (string): Typed confirmation challenge for destructive reverse-ETL writes.\n- Calls\n  - calls list - List Gong calls as ETL records. [intent=etl availability=implemented stream=calls]; notes: Use --from\u002F--to for provider-side Gong call time bounds. --to is an exclusive upper bound. Global --limit caps PM output records only; Gong request page size remains the connector page_size config for compatibility.; flags: --from (non-empty, max 4096 bytes, format=date-time), --to (non-empty, max 4096 bytes, format=date-time)\n  - calls get - Retrieve data for a specific call (\u002Fv2\u002Fcalls\u002F{id}) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --id (max 4096 bytes), --page, --page-cursor\n  - calls create - sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval [intent=reverse_etl availability=partial write=add_call]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --actualStart, --clientUniqueId, --direction, --parties, --primaryUser\n  - calls users-access add - mutates Gong API state; requires reverse ETL approval [intent=reverse_etl availability=partial write=add_calls_users_access]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: medium: mutates Gong API state; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.\n  - calls users-access delete - removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation [intent=reverse_etl availability=partial write=delete_calls_users_access]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.\n  - calls extensive - Retrieve detailed call data by various filters (\u002Fv2\u002Fcalls\u002Fextensive) [intent=direct_read availability=implemented operation=gong.calls_extensive]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --call-id (required), --from, --to, --primary-user-id, --workspace-id, --context, --context-timing, --include-parties, --include-media, --include-public-comments, --include-brief, --include-call-outcome, --include-highlights, --include-key-points, --include-outline, --include-structure, --include-topics, --include-trackers, --include-tracker-occurrences, --include-speakers, --include-questions, --include-person-stats, --include-video-stats, --page, --page-cursor\n  - calls users-access get - Retrieve users that have specific individual access to calls (\u002Fv2\u002Fcalls\u002Fusers-access) [intent=direct_read availability=implemented operation=gong.calls_users_access_get]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --call-id (required), --page, --page-cursor\n  - calls transcript - Retrieve transcripts of calls (\u002Fv2\u002Fcalls\u002Ftranscript) [intent=direct_read availability=implemented operation=gong.calls_transcript]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --call-id (required), --from, --to, --workspace-id, --page, --page-cursor\n  - calls upload-media - Add call media (\u002Fv2\u002Fcalls\u002F{id}\u002Fmedia) [intent=reverse_etl availability=implemented write=upload_call_media]; approval: reverse ETL plan -> preview -> approval -> execute; destructive confirmation required; risk: high: uploads call media from a bounded project-local file path; file path\u002Fcontent are redacted in plans; notes: Uses typed multipart write support; no generic upload command is exposed.; flags: --id, --media-file-path\n- Users\n  - users list - List Gong users as ETL records. [intent=etl availability=implemented stream=users]\n  - users get - Retrieve user (\u002Fv2\u002Fusers\u002F{id}) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --id (max 4096 bytes), --page, --page-cursor\n  - users settings-history - Retrieve user settings history (\u002Fv2\u002Fusers\u002F{id}\u002Fsettings-history) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --id (max 4096 bytes), --page, --page-cursor\n  - users extensive - List users by filter (\u002Fv2\u002Fusers\u002Fextensive) [intent=direct_read availability=implemented operation=gong.users_extensive]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --user-id, --created-from, --created-to, --include-avatars, --page, --page-cursor\n- Scorecards\n  - scorecards list - List Gong scorecards as ETL records. [intent=etl availability=implemented stream=scorecards]\n- Workspaces\n  - workspaces list - List Gong workspaces as ETL records. [intent=etl availability=implemented stream=workspaces]\n- Settings\n  - settings trackers list - List Gong tracker settings as ETL records. [intent=etl availability=implemented stream=trackers]\n  - settings briefs list - List Gong AI brief settings as ETL records. [intent=etl availability=implemented stream=briefs]\n- Permissions\n  - permissions profiles list - List Gong permission profiles as ETL records. [intent=etl availability=implemented stream=permission_profiles]\n  - permissions profile get - Permission profile for a given profile Id (\u002Fv2\u002Fpermission-profile) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --profileId (max 4096 bytes), --page, --page-cursor\n  - permissions profile-users list - List all users attached to a given permission profile (\u002Fv2\u002Fpermission-profile\u002Fusers) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --profileId (max 4096 bytes), --page, --page-cursor\n  - permissions profile create - administrative Gong settings or permissions mutation; requires reverse ETL approval and destructive confirmation [intent=reverse_etl availability=partial write=create_permission_profile]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: administrative Gong settings or permissions mutation; requires reverse ETL approval and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --workspaceId\n  - permissions profile update - administrative Gong settings or permissions mutation; requires reverse ETL approval and destructive confirmation [intent=reverse_etl availability=partial write=update_permission_profile]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: administrative Gong settings or permissions mutation; requires reverse ETL approval and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --profileId\n- CRM\n  - crm integrations list - List Generic CRM integrations as ETL records. [intent=etl availability=implemented stream=crm_integrations]\n  - crm entity-schema get - List Schema Fields (\u002Fv2\u002Fcrm\u002Fentity-schema) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --integrationId (max 4096 bytes), --objectType (max 4096 bytes), --page, --page-cursor\n  - crm entities get - Get CRM objects (\u002Fv2\u002Fcrm\u002Fentities) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --integrationId (max 4096 bytes), --objectType (max 4096 bytes), --objectsCrmIds (max 4096 bytes), --page, --page-cursor\n  - crm request-status get - Get Request Status (\u002Fv2\u002Fcrm\u002Frequest-status) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --integrationId (max 4096 bytes), --clientRequestId (max 4096 bytes), --page, --page-cursor\n  - crm integrations register - mutates Gong API state; requires reverse ETL approval [intent=reverse_etl availability=partial write=register_crm_integration]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: medium: mutates Gong API state; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --name, --ownerEmail\n  - crm integrations delete - removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation [intent=reverse_etl availability=partial write=delete_crm_integration]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --clientRequestId, --integrationId\n  - crm upload-entities - Upload CRM objects (\u002Fv2\u002Fcrm\u002Fentities) [intent=reverse_etl availability=implemented write=upload_crm_entities]; approval: reverse ETL plan -> preview -> approval -> execute; destructive confirmation required; risk: high: uploads CRM data from a bounded project-local file path; file path\u002Fcontent are redacted in plans; notes: Uses typed multipart write support; no generic upload command is exposed.; flags: --data-file-path\n  - crm upload-entity-schema - Upload Object Schema (\u002Fv2\u002Fcrm\u002Fentity-schema) [intent=reverse_etl availability=partial write=upload_crm_entity_schema]; approval: reverse ETL plan -> preview -> approval -> execute; destructive confirmation required; risk: high: uploads CRM entity schema as a top-level JSON array; no raw CLI body is exposed; notes: Write action supports schema-gated top-level array bodies for table\u002Freverse-ETL mappings; provider-style raw JSON CLI flags remain intentionally unavailable.\n- Meetings\n  - meetings update - mutates Gong API state; requires reverse ETL approval [intent=reverse_etl availability=partial write=update_meeting]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: medium: mutates Gong API state; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --endTime, --invitees, --meetingId, --organizerEmail, --startTime\n  - meetings delete - removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation [intent=reverse_etl availability=partial write=delete_meeting]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --meetingId\n  - meetings create - mutates Gong API state; requires reverse ETL approval [intent=reverse_etl availability=partial write=create_meeting]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: medium: mutates Gong API state; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --endTime, --invitees, --organizerEmail, --startTime\n  - meetings integration-status - Validate Gong meeting Integration (\u002Fv2\u002Fmeetings\u002Fintegration\u002Fstatus) [intent=direct_read availability=implemented operation=gong.meetings_integration_status]; approval: none: read-only POST query with schema-gated body; risk: bounded POST read-query; sends only typed email array body fields and redacts sensitive response fields; notes: Executes through the typed operation direct-read engine; no raw body flag is exposed.; flags: --email (required), --page, --page-cursor\n- Engagement\n  - engagement content-viewed - sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval [intent=reverse_etl availability=partial write=content_viewed]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --contentId, --contentTitle, --contentUrl, --eventTimestamp, --reportingSystem\n  - engagement content-shared - sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval [intent=reverse_etl availability=partial write=content_shared]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --contentId, --contentTitle, --contentUrl, --eventTimestamp, --reportingSystem\n  - engagement custom-action - sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval [intent=reverse_etl availability=partial write=custom_action]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --eventTimestamp, --reportingSystem\n- Stats\n  - stats interaction - Retrieve interaction stats for applicable users by date (\u002Fv2\u002Fstats\u002Finteraction) [intent=direct_read availability=implemented operation=gong.stats_interaction]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --from-date (required), --to-date (required), --user-id, --created-from, --created-to, --page, --page-cursor\n  - stats activity-scorecards - Retrieve answered scorecards for applicable reviewed users or scorecards for a date range (\u002Fv2\u002Fstats\u002Factivity\u002Fscorecards) [intent=direct_read availability=implemented operation=gong.stats_activity_scorecards]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --call-from-date, --call-to-date, --review-from-date, --review-to-date, --review-method, --reviewed-user-id, --scorecard-id (required), --page, --page-cursor\n  - stats activity-day-by-day - Retrieve daily activity for applicable users for a date range (\u002Fv2\u002Fstats\u002Factivity\u002Fday-by-day) [intent=direct_read availability=implemented operation=gong.stats_activity_day_by_day]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --from-date (required), --to-date (required), --user-id, --created-from, --created-to, --page, --page-cursor\n  - stats activity-aggregate - Retrieve aggregated activity for defined users by date (\u002Fv2\u002Fstats\u002Factivity\u002Faggregate) [intent=direct_read availability=implemented operation=gong.stats_activity_aggregate]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --from-date (required), --to-date (required), --user-id, --created-from, --created-to, --page, --page-cursor\n  - stats activity-aggregate-by-period - Retrieve aggregated activity for defined users by a date range with grouping in time periods (\u002Fv2\u002Fstats\u002Factivity\u002Faggregate-by-period) [intent=direct_read availability=implemented operation=gong.stats_activity_aggregate_by_period]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --from-date (required), --to-date (required), --user-id, --created-from, --created-to, --aggregation-period (required), --page, --page-cursor\n- Engage Flows\n  - flows list - List Gong Engage flows as ETL records. [intent=etl availability=implemented stream=flows]\n  - flows folders list - List Gong Engage flow folders as ETL records. [intent=etl availability=implemented stream=flow_folders]\n  - flows bulk-assignment get - Get the results of a bulk assignment of prospects to a flow (\u002Fv2\u002Fflows\u002Fprospects\u002Fbulk-assignments\u002F{id}) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --id (max 4096 bytes), --page, --page-cursor\n  - flows prospects unassign-by-instance - removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation [intent=reverse_etl availability=partial write=unassign_flows_by_instance_id]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --flowInstanceIds\n  - flows prospects unassign-by-crm - removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation [intent=reverse_etl availability=partial write=unassign_flows_by_crm_id]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --crmProspectId\n  - flows prospects bulk-assign - mutates Gong API state; requires reverse ETL approval [intent=reverse_etl availability=partial write=submit_flow_prospects_bulk_assignment]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: medium: mutates Gong API state; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --flowId, --flowInstanceOwnerEmail, --prospects\n  - flows prospects assign - mutates Gong API state; requires reverse ETL approval [intent=reverse_etl availability=partial write=assign_prospects]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: medium: mutates Gong API state; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --crmProspectsIds, --flowId, --flowInstanceOwnerEmail\n  - flows prospects assign-cool-off-override - mutates Gong API state; requires reverse ETL approval [intent=reverse_etl availability=partial write=assign_prospects_cool_off_override]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: medium: mutates Gong API state; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --crmProspectsIds, --flowId, --flowInstanceOwnerEmail\n  - flows steps - Get flow details and steps for one or more Engage flows (\u002Fv2\u002Fflows\u002Fsteps) [intent=direct_read availability=implemented operation=gong.flows_steps]; approval: none: read-only POST query with schema-gated body; risk: bounded POST read-query; sends only typed flow ID array body fields and redacts sensitive response fields; notes: Executes through the typed operation direct-read engine; no raw body flag is exposed.; flags: --flow-id (required), --page, --page-cursor\n  - flows prospects - List prospects assigned flows (\u002Fv2\u002Fflows\u002Fprospects) [intent=direct_read availability=implemented operation=gong.flows_prospects]; approval: none: read-only POST query with schema-gated body; risk: bounded POST read-query; sends only typed CRM prospect or flow instance ID arrays and redacts sensitive response fields; notes: Executes through the typed operation direct-read engine; no raw body flag is exposed.; flags: --crm-prospect-id, --flow-instance-id, --page, --page-cursor\n- Library\n  - library folders list - List Gong library folders as ETL records. [intent=etl availability=implemented stream=library_folders]\n  - library folder-content list - List of calls in a specific folder (\u002Fv2\u002Flibrary\u002Ffolder-content) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --folderId (max 4096 bytes), --page, --page-cursor\n- Entities\n  - entities get-brief - Generate a brief for a CRM entity (\u002Fv2\u002Fentities\u002Fget-brief) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --workspaceId (max 4096 bytes), --briefName (max 4096 bytes), --crmEntityType (max 4096 bytes), --crmEntityId (max 4096 bytes), --timePeriod (max 4096 bytes), --fromDateTime (max 4096 bytes), --toDateTime (max 4096 bytes), --page, --page-cursor\n  - entities ask - Ask about an entity (\u002Fv2\u002Fentities\u002Fask-entity) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --workspaceId (max 4096 bytes), --crmEntityType (max 4096 bytes), --crmEntityId (max 4096 bytes), --timePeriod (max 4096 bytes), --fromDateTime (max 4096 bytes), --toDateTime (max 4096 bytes), --question (max 4096 bytes), --page, --page-cursor\n- Data Privacy\n  - privacy find-phone - Retrieve all references to a phone number. (\u002Fv2\u002Fdata-privacy\u002Fdata-for-phone-number) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --phoneNumber (max 4096 bytes), --page, --page-cursor\n  - privacy find-email - Retrieve all references to an email address. (\u002Fv2\u002Fdata-privacy\u002Fdata-for-email-address) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --emailAddress (max 4096 bytes), --page, --page-cursor\n  - privacy erase-phone - destructive Gong data privacy erasure; requires reverse ETL plan, preview, approval, and destructive confirmation [intent=reverse_etl availability=partial write=purge_phone_number]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: critical: destructive Gong data privacy erasure; requires reverse ETL plan, preview, approval, and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --phoneNumber\n  - privacy erase-email - destructive Gong data privacy erasure; requires reverse ETL plan, preview, approval, and destructive confirmation [intent=reverse_etl availability=partial write=purge_email_address]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: critical: destructive Gong data privacy erasure; requires reverse ETL plan, preview, approval, and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --emailAddress\n- Tasks\n  - tasks update - mutates Gong API state; requires reverse ETL approval [intent=reverse_etl availability=partial write=update_task]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: medium: mutates Gong API state; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --taskId, --userId\n  - tasks list - List user's tasks (\u002Fv2\u002Ftasks) [intent=direct_read availability=implemented operation=gong.tasks_list]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --user-id (required), --status (required), --task-action (required), --task-type (required), --workspace-id, --page, --page-cursor\n- Digital Interactions\n  - digital-interaction create - sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval [intent=reverse_etl availability=partial write=add_digital_interaction]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --content, --eventId, --eventType, --timestamp\n- Logs\n  - logs list - Retrieve logs data by type and time range (\u002Fv2\u002Flogs) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --logType (max 4096 bytes), --fromDateTime (max 4096 bytes), --toDateTime (max 4096 bytes), --page, --page-cursor\n- Coaching\n  - coaching list - List all coaching metrics (\u002Fv2\u002Fcoaching) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --workspace-id (max 4096 bytes), --manager-id (max 4096 bytes), --from (max 4096 bytes), --to (max 4096 bytes), --page, --page-cursor\n- Outcomes\n  - call-outcomes list - List Gong call outcomes as ETL records. [intent=etl availability=implemented stream=call_outcomes]\n- Integration Settings\n  - integration-settings update - administrative Gong settings or permissions mutation; requires reverse ETL approval and destructive confirmation [intent=reverse_etl availability=partial write=integration_settings]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: administrative Gong settings or permissions mutation; requires reverse ETL approval and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --integrationTypeSettings\n- Targets\n  - targets list - List target definitions (\u002Fv2\u002Ftargets) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --workspaceId (max 4096 bytes), --page, --page-cursor\n  - targets upload-assignments - Upload target assignments (\u002Fv2\u002Ftargets\u002F{targetId}\u002Fassignments) [intent=reverse_etl availability=implemented write=upload_target_assignments]; approval: reverse ETL plan -> preview -> approval -> execute; destructive confirmation required; risk: high: uploads target assignments from a bounded project-local file path; file path\u002Fcontent are redacted in plans; notes: Uses typed multipart write support; no generic upload command is exposed.; flags: --targetId, --workspaceId, --validate-only, --assignments-file-path\n- Help topics:\n  - gong-auth - Use Gong access key and access key secret via credentials; never pass secrets in command text.\n  - gong-writes - Gong mutations are typed reverse-ETL actions with plan, preview, approval, execute gates.\n  - gong-direct-read - Gong direct reads are bounded JSON GET or typed POST operations with redaction for secret\u002Fdownload\u002Fcontent-shaped fields; call transcripts support a 16 MiB cap.\n\n## Commands\n\n### Inspect as a manual\n\n```bash\npm connectors inspect gong\n```\n\n### Inspect as structured JSON\n\n```bash\npm connectors inspect gong --json\n```\n\n## Agent Rules\n\n- Run pm connectors inspect gong before creating credentials or plans.\n- Use --json only when the caller needs structured output; use the manual for human-readable guidance.\n- Never ask the user to paste secret values into chat.\n- For reverse ETL writes, create a plan, show the preview, wait for explicit approval, then run with the approval token.\n","# pm-gong\n\n## Purpose\n\nReads Gong users, calls, scorecards, settings, flows, and related public API resources; executes selected typed POST read-query commands; models Gong mutations, multipart uploads, and top-level array uploads as typed reverse-ETL actions.\n\n## Icon\n\n- id: gong\n- asset: icons\u002Fgong.svg\n- source: upstream_registry\n- review_status: upstream_seeded\n- review_url: https:\u002F\u002Fus-66463.app.gong.io\u002Fsettings\u002Fapi\u002Fdocumentation\n\n## Capabilities\n\n- check=true catalog=true read=true write=true query=false\n- Integration type: api\n\n## Authentication\n\n- Use pm credentials add with --from-env or --value-stdin for secret fields.\n\n## Configuration\n\n- base_url\n- max_pages\n- mode\n- page_size\n- start_date\n- access_key (secret) (required)\n- access_key_secret (secret) (required)\n\n## ETL Streams\n\n- users:\n  - primary key: id\n  - cursor: created\n  - fields: active(boolean), created(string), email_address(string), first_name(string), id(string), last_name(string), manager_id(string), phone_number(string), title(string)\n- calls:\n  - primary key: id\n  - cursor: started\n  - fields: direction(string), duration(integer), id(string), is_private(boolean), language(string), media(string), scheduled(string), scope(string), started(string), system(string), title(string), url(string)\n- scorecards:\n  - primary key: scorecardId\n  - cursor: updated\n  - fields: created(string), enabled(boolean), scorecardId(string), scorecardName(string), updated(string), workspaceId(string)\n- crm_integrations:\n  - fields: created(string), id(string), name(string), title(string), updated(string)\n- workspaces:\n  - fields: created(string), id(string), name(string), title(string), updated(string)\n- trackers:\n  - fields: created(string), id(string), name(string), title(string), updated(string)\n- briefs:\n  - fields: created(string), id(string), name(string), title(string), updated(string)\n- library_folders:\n  - fields: created(string), id(string), name(string), title(string), updated(string)\n- flows:\n  - fields: created(string), id(string), name(string), title(string), updated(string)\n- flow_folders:\n  - fields: created(string), id(string), name(string), title(string), updated(string)\n- call_outcomes:\n  - fields: created(string), id(string), name(string), title(string), updated(string)\n- permission_profiles:\n  - fields: created(string), id(string), name(string), title(string), updated(string)\n\n## Sync Modes\n\n- ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped, incremental_append, incremental_append_deduped\n\n## Reverse ETL Actions\n\n- add_call:\n  - endpoint: POST \u002Fcalls\n  - required fields: actualStart, clientUniqueId, direction, parties, primaryUser\n  - risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval\n- create_permission_profile:\n  - endpoint: POST \u002Fpermission-profile?workspaceId={{ record.workspaceId }}\n  - required fields: workspaceId\n  - risk: high: administrative Gong settings or permissions mutation; requires reverse ETL approval and destructive confirmation\n- update_permission_profile:\n  - endpoint: PUT \u002Fpermission-profile?profileId={{ record.profileId }}\n  - required fields: profileId\n  - risk: high: administrative Gong settings or permissions mutation; requires reverse ETL approval and destructive confirmation\n- update_meeting:\n  - endpoint: PUT \u002Fmeetings\u002F{meetingId}\n  - required fields: meetingId, endTime, invitees, organizerEmail, startTime\n  - risk: medium: mutates Gong API state; requires reverse ETL approval\n- delete_meeting:\n  - endpoint: DELETE \u002Fmeetings\u002F{meetingId}\n  - required fields: meetingId\n  - risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation\n- content_viewed:\n  - endpoint: PUT \u002Fcustomer-engagement\u002Fcontent\u002Fviewed\n  - required fields: contentId, contentTitle, contentUrl, eventTimestamp, reportingSystem\n  - risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval\n- content_shared:\n  - endpoint: PUT \u002Fcustomer-engagement\u002Fcontent\u002Fshared\n  - required fields: contentId, contentTitle, contentUrl, eventTimestamp, reportingSystem\n  - risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval\n- custom_action:\n  - endpoint: PUT \u002Fcustomer-engagement\u002Faction\n  - required fields: eventTimestamp, reportingSystem\n  - risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval\n- register_crm_integration:\n  - endpoint: PUT \u002Fcrm\u002Fintegrations\n  - required fields: name, ownerEmail\n  - risk: medium: mutates Gong API state; requires reverse ETL approval\n- delete_crm_integration:\n  - endpoint: DELETE \u002Fcrm\u002Fintegrations?integrationId={{ record.integrationId }}&clientRequestId={{ record.clientRequestId }}\n  - required fields: integrationId, clientRequestId\n  - risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation\n- add_calls_users_access:\n  - endpoint: PUT \u002Fcalls\u002Fusers-access\n  - risk: medium: mutates Gong API state; requires reverse ETL approval\n- delete_calls_users_access:\n  - endpoint: DELETE \u002Fcalls\u002Fusers-access\n  - risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation\n- create_meeting:\n  - endpoint: POST \u002Fmeetings\n  - required fields: endTime, invitees, organizerEmail, startTime\n  - risk: medium: mutates Gong API state; requires reverse ETL approval\n- integration_settings:\n  - endpoint: POST \u002Fintegration-settings\n  - required fields: integrationTypeSettings\n  - risk: high: administrative Gong settings or permissions mutation; requires reverse ETL approval and destructive confirmation\n- unassign_flows_by_instance_id:\n  - endpoint: POST \u002Fflows\u002Fprospects\u002Funassign-flows-by-instance-id\n  - required fields: flowInstanceIds\n  - risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation\n- unassign_flows_by_crm_id:\n  - endpoint: POST \u002Fflows\u002Fprospects\u002Funassign-flows-by-crm-id\n  - required fields: crmProspectId\n  - risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation\n- submit_flow_prospects_bulk_assignment:\n  - endpoint: POST \u002Fflows\u002Fprospects\u002Fbulk-assignments\n  - required fields: flowId, flowInstanceOwnerEmail, prospects\n  - risk: medium: mutates Gong API state; requires reverse ETL approval\n- assign_prospects:\n  - endpoint: POST \u002Fflows\u002Fprospects\u002Fassign\n  - required fields: crmProspectsIds, flowId, flowInstanceOwnerEmail\n  - risk: medium: mutates Gong API state; requires reverse ETL approval\n- assign_prospects_cool_off_override:\n  - endpoint: POST \u002Fflows\u002Fprospects\u002Fassign\u002Fcool-off-override\n  - required fields: crmProspectsIds, flowId, flowInstanceOwnerEmail\n  - risk: medium: mutates Gong API state; requires reverse ETL approval\n- add_digital_interaction:\n  - endpoint: POST \u002Fdigital-interaction\n  - required fields: content, eventId, eventType, timestamp\n  - risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval\n- purge_phone_number:\n  - endpoint: POST \u002Fdata-privacy\u002Ferase-data-for-phone-number?phoneNumber={{ record.phoneNumber }}\n  - required fields: phoneNumber\n  - risk: critical: destructive Gong data privacy erasure; requires reverse ETL plan, preview, approval, and destructive confirmation\n- purge_email_address:\n  - endpoint: POST \u002Fdata-privacy\u002Ferase-data-for-email-address?emailAddress={{ record.emailAddress }}\n  - required fields: emailAddress\n  - risk: critical: destructive Gong data privacy erasure; requires reverse ETL plan, preview, approval, and destructive confirmation\n- update_task:\n  - endpoint: PATCH \u002Ftasks\u002F{taskId}\n  - required fields: taskId, userId\n  - risk: medium: mutates Gong API state; requires reverse ETL approval\n- upload_call_media:\n  - endpoint: PUT \u002Fv2\u002Fcalls\u002F{{ record.id }}\u002Fmedia\n  - required fields: id, media_file_path\n  - risk: high: uploads call media from a bounded local file path to Gong; file path\u002Fcontent are redacted in plans and require reverse ETL approval\n- upload_crm_entities:\n  - endpoint: POST \u002Fv2\u002Fcrm\u002Fentities\n  - required fields: data_file_path\n  - risk: high: uploads CRM data from a bounded local file path to Gong; file path\u002Fcontent are redacted in plans and require reverse ETL approval\n- upload_crm_entity_schema:\n  - endpoint: POST \u002Fv2\u002Fcrm\u002Fentity-schema\n  - required fields: selected_fields\n  - risk: high: uploads CRM entity schema as a bounded top-level JSON array; use only reviewed table mappings and reverse ETL approval\n- upload_target_assignments:\n  - endpoint: POST \u002Fv2\u002Ftargets\u002F{{ record.targetId }}\u002Fassignments\n  - required fields: targetId, workspaceId, assignments_file_path\n  - risk: high: uploads target assignments from a bounded local file path to Gong; file path\u002Fcontent are redacted in plans and require reverse ETL approval\n\n## Security\n\n- read risk: external Gong API read of call, user, CRM, settings, flow, and activity data; direct reads are bounded and redacted\n- write risk: typed Gong reverse ETL mutations for calls, meetings, CRM, permissions, flows, engagement, multipart uploads, top-level array CRM schema upload, and data privacy erasure\n- approval: reverse ETL writes require plan, preview, approval, execute; destructive\u002Fadmin actions require --confirm destructive; local file upload plans bind a SHA-256 payload identity that is snapshot-verified before network send\n- Never pass secret values in chat, shell arguments, logs, docs, or JSON output.\n\n## Command Surface\n\n- Inspect, read, and safely plan typed Gong operations.\n- Usage: pm gong \u003Ccommand> [flags]\n- Source CLI: Gong API (Public OpenAPI 3.0.1)\n- PM execution policy pm-request-contract-bounds-v1: each max N bytes qualifier is the effective PM request limit, not a provider schema assertion; path\u002Fquery values are measured after exact wire encoding and rejected rather than truncated.\n- Global flags:\n  - --credential (string): Credential name to use for the Gong request.\n  - --connection (string): Alias for --credential.\n  - --config (string_array): Connector config override as key=value.\n  - --json (boolean): Emit machine-readable JSON output.\n  - --limit (integer): Maximum PM ETL records to emit; does not control Gong page size or total provider-side results.\n  - --max-bytes (integer): Maximum direct-read response bytes; typed operations are capped at 16 MiB and each operation may declare a lower limit.\n  - --plan (string): Execute an approved reverse-ETL plan by id.\n  - --preview (boolean): Preview a reverse-ETL write command without making a network mutation.\n  - --approval-token-stdin (boolean): Read the approval token as one bounded line from standard input.\n  - --confirm (string): Typed confirmation challenge for destructive reverse-ETL writes.\n- Calls\n  - calls list - List Gong calls as ETL records. [intent=etl availability=implemented stream=calls]; notes: Use --from\u002F--to for provider-side Gong call time bounds. --to is an exclusive upper bound. Global --limit caps PM output records only; Gong request page size remains the connector page_size config for compatibility.; flags: --from (non-empty, max 4096 bytes, format=date-time), --to (non-empty, max 4096 bytes, format=date-time)\n  - calls get - Retrieve data for a specific call (\u002Fv2\u002Fcalls\u002F{id}) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --id (max 4096 bytes), --page, --page-cursor\n  - calls create - sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval [intent=reverse_etl availability=partial write=add_call]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --actualStart, --clientUniqueId, --direction, --parties, --primaryUser\n  - calls users-access add - mutates Gong API state; requires reverse ETL approval [intent=reverse_etl availability=partial write=add_calls_users_access]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: medium: mutates Gong API state; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.\n  - calls users-access delete - removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation [intent=reverse_etl availability=partial write=delete_calls_users_access]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.\n  - calls extensive - Retrieve detailed call data by various filters (\u002Fv2\u002Fcalls\u002Fextensive) [intent=direct_read availability=implemented operation=gong.calls_extensive]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --call-id (required), --from, --to, --primary-user-id, --workspace-id, --context, --context-timing, --include-parties, --include-media, --include-public-comments, --include-brief, --include-call-outcome, --include-highlights, --include-key-points, --include-outline, --include-structure, --include-topics, --include-trackers, --include-tracker-occurrences, --include-speakers, --include-questions, --include-person-stats, --include-video-stats, --page, --page-cursor\n  - calls users-access get - Retrieve users that have specific individual access to calls (\u002Fv2\u002Fcalls\u002Fusers-access) [intent=direct_read availability=implemented operation=gong.calls_users_access_get]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --call-id (required), --page, --page-cursor\n  - calls transcript - Retrieve transcripts of calls (\u002Fv2\u002Fcalls\u002Ftranscript) [intent=direct_read availability=implemented operation=gong.calls_transcript]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --call-id (required), --from, --to, --workspace-id, --page, --page-cursor\n  - calls upload-media - Add call media (\u002Fv2\u002Fcalls\u002F{id}\u002Fmedia) [intent=reverse_etl availability=implemented write=upload_call_media]; approval: reverse ETL plan -> preview -> approval -> execute; destructive confirmation required; risk: high: uploads call media from a bounded project-local file path; file path\u002Fcontent are redacted in plans; notes: Uses typed multipart write support; no generic upload command is exposed.; flags: --id, --media-file-path\n- Users\n  - users list - List Gong users as ETL records. [intent=etl availability=implemented stream=users]\n  - users get - Retrieve user (\u002Fv2\u002Fusers\u002F{id}) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --id (max 4096 bytes), --page, --page-cursor\n  - users settings-history - Retrieve user settings history (\u002Fv2\u002Fusers\u002F{id}\u002Fsettings-history) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --id (max 4096 bytes), --page, --page-cursor\n  - users extensive - List users by filter (\u002Fv2\u002Fusers\u002Fextensive) [intent=direct_read availability=implemented operation=gong.users_extensive]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --user-id, --created-from, --created-to, --include-avatars, --page, --page-cursor\n- Scorecards\n  - scorecards list - List Gong scorecards as ETL records. [intent=etl availability=implemented stream=scorecards]\n- Workspaces\n  - workspaces list - List Gong workspaces as ETL records. [intent=etl availability=implemented stream=workspaces]\n- Settings\n  - settings trackers list - List Gong tracker settings as ETL records. [intent=etl availability=implemented stream=trackers]\n  - settings briefs list - List Gong AI brief settings as ETL records. [intent=etl availability=implemented stream=briefs]\n- Permissions\n  - permissions profiles list - List Gong permission profiles as ETL records. [intent=etl availability=implemented stream=permission_profiles]\n  - permissions profile get - Permission profile for a given profile Id (\u002Fv2\u002Fpermission-profile) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --profileId (max 4096 bytes), --page, --page-cursor\n  - permissions profile-users list - List all users attached to a given permission profile (\u002Fv2\u002Fpermission-profile\u002Fusers) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --profileId (max 4096 bytes), --page, --page-cursor\n  - permissions profile create - administrative Gong settings or permissions mutation; requires reverse ETL approval and destructive confirmation [intent=reverse_etl availability=partial write=create_permission_profile]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: administrative Gong settings or permissions mutation; requires reverse ETL approval and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --workspaceId\n  - permissions profile update - administrative Gong settings or permissions mutation; requires reverse ETL approval and destructive confirmation [intent=reverse_etl availability=partial write=update_permission_profile]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: administrative Gong settings or permissions mutation; requires reverse ETL approval and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --profileId\n- CRM\n  - crm integrations list - List Generic CRM integrations as ETL records. [intent=etl availability=implemented stream=crm_integrations]\n  - crm entity-schema get - List Schema Fields (\u002Fv2\u002Fcrm\u002Fentity-schema) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --integrationId (max 4096 bytes), --objectType (max 4096 bytes), --page, --page-cursor\n  - crm entities get - Get CRM objects (\u002Fv2\u002Fcrm\u002Fentities) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --integrationId (max 4096 bytes), --objectType (max 4096 bytes), --objectsCrmIds (max 4096 bytes), --page, --page-cursor\n  - crm request-status get - Get Request Status (\u002Fv2\u002Fcrm\u002Frequest-status) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --integrationId (max 4096 bytes), --clientRequestId (max 4096 bytes), --page, --page-cursor\n  - crm integrations register - mutates Gong API state; requires reverse ETL approval [intent=reverse_etl availability=partial write=register_crm_integration]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: medium: mutates Gong API state; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --name, --ownerEmail\n  - crm integrations delete - removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation [intent=reverse_etl availability=partial write=delete_crm_integration]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --clientRequestId, --integrationId\n  - crm upload-entities - Upload CRM objects (\u002Fv2\u002Fcrm\u002Fentities) [intent=reverse_etl availability=implemented write=upload_crm_entities]; approval: reverse ETL plan -> preview -> approval -> execute; destructive confirmation required; risk: high: uploads CRM data from a bounded project-local file path; file path\u002Fcontent are redacted in plans; notes: Uses typed multipart write support; no generic upload command is exposed.; flags: --data-file-path\n  - crm upload-entity-schema - Upload Object Schema (\u002Fv2\u002Fcrm\u002Fentity-schema) [intent=reverse_etl availability=partial write=upload_crm_entity_schema]; approval: reverse ETL plan -> preview -> approval -> execute; destructive confirmation required; risk: high: uploads CRM entity schema as a top-level JSON array; no raw CLI body is exposed; notes: Write action supports schema-gated top-level array bodies for table\u002Freverse-ETL mappings; provider-style raw JSON CLI flags remain intentionally unavailable.\n- Meetings\n  - meetings update - mutates Gong API state; requires reverse ETL approval [intent=reverse_etl availability=partial write=update_meeting]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: medium: mutates Gong API state; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --endTime, --invitees, --meetingId, --organizerEmail, --startTime\n  - meetings delete - removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation [intent=reverse_etl availability=partial write=delete_meeting]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --meetingId\n  - meetings create - mutates Gong API state; requires reverse ETL approval [intent=reverse_etl availability=partial write=create_meeting]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: medium: mutates Gong API state; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --endTime, --invitees, --organizerEmail, --startTime\n  - meetings integration-status - Validate Gong meeting Integration (\u002Fv2\u002Fmeetings\u002Fintegration\u002Fstatus) [intent=direct_read availability=implemented operation=gong.meetings_integration_status]; approval: none: read-only POST query with schema-gated body; risk: bounded POST read-query; sends only typed email array body fields and redacts sensitive response fields; notes: Executes through the typed operation direct-read engine; no raw body flag is exposed.; flags: --email (required), --page, --page-cursor\n- Engagement\n  - engagement content-viewed - sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval [intent=reverse_etl availability=partial write=content_viewed]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --contentId, --contentTitle, --contentUrl, --eventTimestamp, --reportingSystem\n  - engagement content-shared - sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval [intent=reverse_etl availability=partial write=content_shared]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --contentId, --contentTitle, --contentUrl, --eventTimestamp, --reportingSystem\n  - engagement custom-action - sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval [intent=reverse_etl availability=partial write=custom_action]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --eventTimestamp, --reportingSystem\n- Stats\n  - stats interaction - Retrieve interaction stats for applicable users by date (\u002Fv2\u002Fstats\u002Finteraction) [intent=direct_read availability=implemented operation=gong.stats_interaction]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --from-date (required), --to-date (required), --user-id, --created-from, --created-to, --page, --page-cursor\n  - stats activity-scorecards - Retrieve answered scorecards for applicable reviewed users or scorecards for a date range (\u002Fv2\u002Fstats\u002Factivity\u002Fscorecards) [intent=direct_read availability=implemented operation=gong.stats_activity_scorecards]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --call-from-date, --call-to-date, --review-from-date, --review-to-date, --review-method, --reviewed-user-id, --scorecard-id (required), --page, --page-cursor\n  - stats activity-day-by-day - Retrieve daily activity for applicable users for a date range (\u002Fv2\u002Fstats\u002Factivity\u002Fday-by-day) [intent=direct_read availability=implemented operation=gong.stats_activity_day_by_day]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --from-date (required), --to-date (required), --user-id, --created-from, --created-to, --page, --page-cursor\n  - stats activity-aggregate - Retrieve aggregated activity for defined users by date (\u002Fv2\u002Fstats\u002Factivity\u002Faggregate) [intent=direct_read availability=implemented operation=gong.stats_activity_aggregate]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --from-date (required), --to-date (required), --user-id, --created-from, --created-to, --page, --page-cursor\n  - stats activity-aggregate-by-period - Retrieve aggregated activity for defined users by a date range with grouping in time periods (\u002Fv2\u002Fstats\u002Factivity\u002Faggregate-by-period) [intent=direct_read availability=implemented operation=gong.stats_activity_aggregate_by_period]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --from-date (required), --to-date (required), --user-id, --created-from, --created-to, --aggregation-period (required), --page, --page-cursor\n- Engage Flows\n  - flows list - List Gong Engage flows as ETL records. [intent=etl availability=implemented stream=flows]\n  - flows folders list - List Gong Engage flow folders as ETL records. [intent=etl availability=implemented stream=flow_folders]\n  - flows bulk-assignment get - Get the results of a bulk assignment of prospects to a flow (\u002Fv2\u002Fflows\u002Fprospects\u002Fbulk-assignments\u002F{id}) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --id (max 4096 bytes), --page, --page-cursor\n  - flows prospects unassign-by-instance - removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation [intent=reverse_etl availability=partial write=unassign_flows_by_instance_id]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --flowInstanceIds\n  - flows prospects unassign-by-crm - removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation [intent=reverse_etl availability=partial write=unassign_flows_by_crm_id]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: removes Gong access, integration, meeting, or flow assignment state; requires reverse ETL approval and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --crmProspectId\n  - flows prospects bulk-assign - mutates Gong API state; requires reverse ETL approval [intent=reverse_etl availability=partial write=submit_flow_prospects_bulk_assignment]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: medium: mutates Gong API state; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --flowId, --flowInstanceOwnerEmail, --prospects\n  - flows prospects assign - mutates Gong API state; requires reverse ETL approval [intent=reverse_etl availability=partial write=assign_prospects]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: medium: mutates Gong API state; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --crmProspectsIds, --flowId, --flowInstanceOwnerEmail\n  - flows prospects assign-cool-off-override - mutates Gong API state; requires reverse ETL approval [intent=reverse_etl availability=partial write=assign_prospects_cool_off_override]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: medium: mutates Gong API state; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --crmProspectsIds, --flowId, --flowInstanceOwnerEmail\n  - flows steps - Get flow details and steps for one or more Engage flows (\u002Fv2\u002Fflows\u002Fsteps) [intent=direct_read availability=implemented operation=gong.flows_steps]; approval: none: read-only POST query with schema-gated body; risk: bounded POST read-query; sends only typed flow ID array body fields and redacts sensitive response fields; notes: Executes through the typed operation direct-read engine; no raw body flag is exposed.; flags: --flow-id (required), --page, --page-cursor\n  - flows prospects - List prospects assigned flows (\u002Fv2\u002Fflows\u002Fprospects) [intent=direct_read availability=implemented operation=gong.flows_prospects]; approval: none: read-only POST query with schema-gated body; risk: bounded POST read-query; sends only typed CRM prospect or flow instance ID arrays and redacts sensitive response fields; notes: Executes through the typed operation direct-read engine; no raw body flag is exposed.; flags: --crm-prospect-id, --flow-instance-id, --page, --page-cursor\n- Library\n  - library folders list - List Gong library folders as ETL records. [intent=etl availability=implemented stream=library_folders]\n  - library folder-content list - List of calls in a specific folder (\u002Fv2\u002Flibrary\u002Ffolder-content) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --folderId (max 4096 bytes), --page, --page-cursor\n- Entities\n  - entities get-brief - Generate a brief for a CRM entity (\u002Fv2\u002Fentities\u002Fget-brief) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --workspaceId (max 4096 bytes), --briefName (max 4096 bytes), --crmEntityType (max 4096 bytes), --crmEntityId (max 4096 bytes), --timePeriod (max 4096 bytes), --fromDateTime (max 4096 bytes), --toDateTime (max 4096 bytes), --page, --page-cursor\n  - entities ask - Ask about an entity (\u002Fv2\u002Fentities\u002Fask-entity) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --workspaceId (max 4096 bytes), --crmEntityType (max 4096 bytes), --crmEntityId (max 4096 bytes), --timePeriod (max 4096 bytes), --fromDateTime (max 4096 bytes), --toDateTime (max 4096 bytes), --question (max 4096 bytes), --page, --page-cursor\n- Data Privacy\n  - privacy find-phone - Retrieve all references to a phone number. (\u002Fv2\u002Fdata-privacy\u002Fdata-for-phone-number) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --phoneNumber (max 4096 bytes), --page, --page-cursor\n  - privacy find-email - Retrieve all references to an email address. (\u002Fv2\u002Fdata-privacy\u002Fdata-for-email-address) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --emailAddress (max 4096 bytes), --page, --page-cursor\n  - privacy erase-phone - destructive Gong data privacy erasure; requires reverse ETL plan, preview, approval, and destructive confirmation [intent=reverse_etl availability=partial write=purge_phone_number]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: critical: destructive Gong data privacy erasure; requires reverse ETL plan, preview, approval, and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --phoneNumber\n  - privacy erase-email - destructive Gong data privacy erasure; requires reverse ETL plan, preview, approval, and destructive confirmation [intent=reverse_etl availability=partial write=purge_email_address]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: critical: destructive Gong data privacy erasure; requires reverse ETL plan, preview, approval, and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --emailAddress\n- Tasks\n  - tasks update - mutates Gong API state; requires reverse ETL approval [intent=reverse_etl availability=partial write=update_task]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: medium: mutates Gong API state; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --taskId, --userId\n  - tasks list - List user's tasks (\u002Fv2\u002Ftasks) [intent=direct_read availability=implemented operation=gong.tasks_list]; approval: none: read-only POST query with schema-gated body; risk: bounded typed POST read-query; response size is capped and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; notes: Executes through the typed operation direct-read engine; no raw body or generic HTTP flag is exposed.; flags: --user-id (required), --status (required), --task-action (required), --task-type (required), --workspace-id, --page, --page-cursor\n- Digital Interactions\n  - digital-interaction create - sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval [intent=reverse_etl availability=partial write=add_digital_interaction]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: sends call, engagement, or digital interaction content to Gong; requires reverse ETL approval; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --content, --eventId, --eventType, --timestamp\n- Logs\n  - logs list - Retrieve logs data by type and time range (\u002Fv2\u002Flogs) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --logType (max 4096 bytes), --fromDateTime (max 4096 bytes), --toDateTime (max 4096 bytes), --page, --page-cursor\n- Coaching\n  - coaching list - List all coaching metrics (\u002Fv2\u002Fcoaching) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --workspace-id (max 4096 bytes), --manager-id (max 4096 bytes), --from (max 4096 bytes), --to (max 4096 bytes), --page, --page-cursor\n- Outcomes\n  - call-outcomes list - List Gong call outcomes as ETL records. [intent=etl availability=implemented stream=call_outcomes]\n- Integration Settings\n  - integration-settings update - administrative Gong settings or permissions mutation; requires reverse ETL approval and destructive confirmation [intent=reverse_etl availability=partial write=integration_settings]; approval: Use reverse ETL plan -> preview -> approval -> execute. Connector command execution is metadata-only for complex object\u002Farray records; use typed reverse ETL records.; risk: high: administrative Gong settings or permissions mutation; requires reverse ETL approval and destructive confirmation; notes: No raw HTTP body is accepted. Object and array payloads must come from typed reverse-ETL records validated by writes.json.; flags: --integrationTypeSettings\n- Targets\n  - targets list - List target definitions (\u002Fv2\u002Ftargets) [intent=direct_read availability=implemented]; risk: bounded Gong JSON read; response is limited to 1 MiB and secret\u002Fdownload\u002Fcontent-shaped fields are redacted; flags: --workspaceId (max 4096 bytes), --page, --page-cursor\n  - targets upload-assignments - Upload target assignments (\u002Fv2\u002Ftargets\u002F{targetId}\u002Fassignments) [intent=reverse_etl availability=implemented write=upload_target_assignments]; approval: reverse ETL plan -> preview -> approval -> execute; destructive confirmation required; risk: high: uploads target assignments from a bounded project-local file path; file path\u002Fcontent are redacted in plans; notes: Uses typed multipart write support; no generic upload command is exposed.; flags: --targetId, --workspaceId, --validate-only, --assignments-file-path\n- Help topics:\n  - gong-auth - Use Gong access key and access key secret via credentials; never pass secrets in command text.\n  - gong-writes - Gong mutations are typed reverse-ETL actions with plan, preview, approval, execute gates.\n  - gong-direct-read - Gong direct reads are bounded JSON GET or typed POST operations with redaction for secret\u002Fdownload\u002Fcontent-shaped fields; call transcripts support a 16 MiB cap.\n\n## Commands\n\n### Inspect as a manual\n\n```bash\npm connectors inspect gong\n```\n\n### Inspect as structured JSON\n\n```bash\npm connectors inspect gong --json\n```\n\n## Agent Rules\n\n- Run pm connectors inspect gong before creating credentials or plans.\n- Use --json only when the caller needs structured output; use the manual for human-readable guidance.\n- Never ask the user to paste secret values into chat.\n- For reverse ETL writes, create a plan, show the preview, wait for explicit approval, then run with the approval token.\n",{"name":5,"description":7},"main","813f457a925f7ee3fe3bea101a43e445992c8552","docs\u002Fskills\u002Fpm-gong",0,"https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli","https:\u002F\u002Fcli.polymetrics.ai","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai","Local-first data infrastructure for agents and developers.","2026-09-21 12:42:03",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add polymetrics-ai\u002Fcli --skill pm-gong",{"tool":39,"command":40},"bunx","bunx skills add polymetrics-ai\u002Fcli --skill pm-gong",{"tool":42,"command":43},"pnpm","pnpm dlx skills add polymetrics-ai\u002Fcli --skill pm-gong","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-gong\u002FSKILL.md",true,[],[48,55,62,69,76,83],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":19},"01M782EH9BFHYZVECKJ31F427S","recipe-preview-approve-reverse-etl","Preview and approve a reverse ETL plan safely.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Frecipe-preview-approve-reverse-etl\u002FSKILL.md",[],[],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M782EFGH5NRZ2CXDK0V9YWFW","recipe-github-prs-to-warehouse","Sync GitHub pull requests into the local warehouse.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Frecipe-github-prs-to-warehouse\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M782ECJZRQAK8E86CE7R2YM2","pm-zoom","Zoom connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zoom\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M782EASYDANMV35W2ZHG2QD0","pm-zonka-feedback","Zonka Feedback connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zonka-feedback\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M782E8WA94A906385AET1ZWH","pm-zoho-invoice","Zoho Invoice connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zoho-invoice\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M782E73M7F23B6VBGM72QMMQ","pm-zoho-inventory","Zoho Inventory connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zoho-inventory\u002FSKILL.md",[],[]]