AGENT SKILL

pm-getgist

GetGist connector knowledge and safe action guide.

License 许可
AGPL-3.0
所属仓库
polymetrics-ai/cli
最近更新
2026-09-21
Stars
★ 7
Forks
0

01 前言 Front Matter

name
pm-getgist
description
GetGist connector knowledge and safe action guide.

02 资源文件 1

03 SKILL.md 正文

pm-getgist

Purpose

Reads Gist contacts, tags, segments, campaigns, forms, teammates, articles, collections, conversations, teams, workspace metadata, and e-commerce resources through the Gist REST API; writes regular JSON Gist resources and relationship actions.

Icon

Capabilities

  • check=true catalog=true read=true write=true query=false
  • Integration type: api

Authentication

  • Use pm credentials add with --from-env or --value-stdin for secret fields.

Configuration

  • article_id
  • article_query
  • base_url
  • batch_id
  • campaign_id
  • category_id
  • collection_id
  • contact_email
  • contact_id
  • contact_user_id
  • conversation_id
  • customer_id
  • event_type
  • form_id
  • include_count
  • mode
  • order_id
  • product_id
  • product_variant_id
  • segment_id
  • store_id
  • subscription_type_id
  • team_id
  • teammate_id
  • variant_id
  • api_key (secret) (required)

ETL Streams

  • contacts:
    • primary key: id
    • cursor: updated_at
    • fields: created_at(integer), email(string), id(integer), last_contacted_at(integer), last_seen_at(integer), name(string), phone(string), session_count(integer), signed_up_at(integer), type(string), unsubscribed_from_emails(boolean), updated_at(integer), user_id(string)
  • contact_details:
    • primary key: id
    • cursor: updated_at
    • fields: created_at(integer), email(string), id(integer), last_contacted_at(integer), last_seen_at(integer), name(string), phone(string), session_count(integer), signed_up_at(integer), type(string), unsubscribed_from_emails(boolean), updated_at(integer), user_id(string)
  • contact_batch_status:
    • primary key: id
    • fields: created_at(integer), description(string), id(string), name(string), status(string), title(string), type(string), updated_at(integer)
  • articles:
    • primary key: id
    • fields: created_at(integer), description(string), id(integer), name(string), status(string), title(string), type(string), updated_at(integer)
  • article_details:
    • primary key: id
    • fields: created_at(integer), description(string), id(integer), name(string), status(string), title(string), type(string), updated_at(integer)
  • article_search:
    • primary key: id
    • fields: created_at(integer), description(string), id(integer), name(string), status(string), title(string), type(string), updated_at(integer)
  • article_settings:
    • primary key: id
    • fields: created_at(integer), description(string), id(string), name(string), status(string), title(string), type(string), updated_at(integer)
  • collections:
    • primary key: id
    • fields: created_at(integer), description(string), id(integer), name(string), status(string), title(string), type(string), updated_at(integer)
  • collection_details:
    • primary key: id
    • fields: created_at(integer), description(string), id(integer), name(string), status(string), title(string), type(string), updated_at(integer)
  • events:
    • primary key: id
    • fields: created_at(integer), description(string), id(integer), name(string), status(string), title(string), type(string), updated_at(integer)
  • tags:
    • primary key: id
    • fields: id(integer), name(string), type(string)
  • segments:
    • primary key: id
    • fields: count(integer), created_at(integer), id(integer), name(string), person_type(string), type(string), updated_at(integer)
  • segment_details:
    • primary key: id
    • fields: count(integer), created_at(integer), id(integer), name(string), person_type(string), type(string), updated_at(integer)
  • forms:
    • primary key: id
    • fields: created_at(integer), id(integer), name(string), type(string), updated_at(integer)
  • form_details:
    • primary key: id
    • fields: created_at(integer), id(integer), name(string), type(string), updated_at(integer)
  • form_submissions:
    • primary key: id
    • fields: created_at(integer), description(string), id(integer), name(string), status(string), title(string), type(string), updated_at(integer)
  • campaigns:
    • primary key: id
    • fields: created_at(integer), id(integer), name(string), status(string), subject(string), type(string), updated_at(integer)
  • campaign_details:
    • primary key: id
    • fields: created_at(integer), id(integer), name(string), status(string), subject(string), type(string), updated_at(integer)
  • subscription_types:
    • primary key: id
    • fields: created_at(integer), description(string), id(integer), name(string), status(string), title(string), type(string), updated_at(integer)
  • subscription_type_details:
    • primary key: id
    • fields: created_at(integer), description(string), id(integer), name(string), status(string), title(string), type(string), updated_at(integer)
  • conversations:
    • primary key: id
    • fields: created_at(integer), description(string), id(integer), name(string), status(string), title(string), type(string), updated_at(integer)
  • conversation_details:
    • primary key: id
    • fields: created_at(integer), description(string), id(integer), name(string), status(string), title(string), type(string), updated_at(integer)
  • conversation_messages:
    • primary key: id
    • fields: created_at(integer), description(string), id(integer), name(string), status(string), title(string), type(string), updated_at(integer)
  • conversation_global_counts:
    • primary key: scope
    • fields: closed(integer), count(integer), id(integer), open(integer), scope(string), team_id(integer), teammate_id(integer)
  • conversation_team_counts:
    • primary key: scope
    • fields: closed(integer), count(integer), id(integer), open(integer), scope(string), team_id(integer), teammate_id(integer)
  • conversation_teammate_counts:
    • primary key: scope
    • fields: closed(integer), count(integer), id(integer), open(integer), scope(string), team_id(integer), teammate_id(integer)
  • teams:
    • primary key: id
    • fields: created_at(integer), description(string), id(integer), name(string), status(string), title(string), type(string), updated_at(integer)
  • team_details:
    • primary key: id
    • fields: created_at(integer), description(string), id(integer), name(string), status(string), title(string), type(string), updated_at(integer)
  • teammates:
    • primary key: id
    • fields: email(string), id(integer), name(string), type(string)
  • teammate_details:
    • primary key: id
    • fields: email(string), id(integer), name(string), type(string)
  • token_info:
    • primary key: id
    • fields: created_at(integer), description(string), id(string), name(string), status(string), title(string), type(string), updated_at(integer)
  • ecommerce_stores:
    • primary key: id
    • fields: created_at(integer), description(string), id(integer), name(string), status(string), title(string), type(string), updated_at(integer)
  • ecommerce_store_details:
    • primary key: id
    • fields: created_at(integer), description(string), id(integer), name(string), status(string), title(string), type(string), updated_at(integer)
  • ecommerce_customer_details:
    • primary key: id
    • fields: created_at(integer), description(string), id(string), name(string), status(string), title(string), type(string), updated_at(integer)
  • ecommerce_product_details:
    • primary key: id
    • fields: created_at(integer), description(string), id(string), name(string), status(string), title(string), type(string), updated_at(integer)
  • ecommerce_product_variant_details:
    • primary key: id
    • fields: created_at(integer), description(string), id(string), name(string), status(string), title(string), type(string), updated_at(integer)
  • ecommerce_product_category_details:
    • primary key: id
    • fields: created_at(integer), description(string), id(string), name(string), status(string), title(string), type(string), updated_at(integer)

Sync Modes

  • ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped

Reverse ETL Actions

  • create_article:
    • endpoint: POST /articles
    • risk: create through the Gist API
  • update_article:
    • endpoint: PATCH /articles/{{ record.article_id }}
    • required fields: article_id
    • risk: update through the Gist API
  • delete_article:
    • endpoint: DELETE /articles/{{ record.article_id }}
    • required fields: article_id
    • risk: delete through the Gist API
  • create_collection:
    • endpoint: POST /collections
    • risk: create through the Gist API
  • update_collection:
    • endpoint: POST /collections/{{ record.collection_id }}
    • required fields: collection_id
    • risk: update through the Gist API
  • delete_collection:
    • endpoint: DELETE /collections/{{ record.collection_id }}
    • required fields: collection_id
    • risk: delete through the Gist API
  • upsert_contact:
    • endpoint: POST /contacts
    • risk: upsert through the Gist API
  • upsert_contacts_batch:
    • endpoint: POST /contacts/batch
    • risk: upsert through the Gist API
  • delete_contact:
    • endpoint: DELETE /contacts/{{ record.contact_id }}
    • required fields: contact_id
    • risk: delete through the Gist API
  • track_event:
    • endpoint: POST /events
    • risk: create through the Gist API
  • upsert_tag:
    • endpoint: POST /tags
    • risk: upsert through the Gist API
  • delete_tag:
    • endpoint: DELETE /tags/{{ record.tag_id }}
    • required fields: tag_id
    • risk: delete through the Gist API
  • add_tag_to_contacts:
    • endpoint: POST /tags
    • risk: update through the Gist API
  • remove_tag_from_contacts:
    • endpoint: POST /tags
    • risk: update through the Gist API
  • subscribe_contact_to_form:
    • endpoint: POST /forms/{{ record.form_id }}/subscribe
    • required fields: form_id
    • risk: update through the Gist API
  • subscribe_contact_to_campaign:
    • endpoint: POST /campaigns
    • risk: update through the Gist API
  • unsubscribe_contact_from_campaign:
    • endpoint: POST /campaigns
    • risk: update through the Gist API
  • attach_contact_to_subscription_type:
    • endpoint: POST /subscription_types/{{ record.subscription_type_id }}
    • required fields: subscription_type_id
    • risk: update through the Gist API
  • detach_contact_from_subscription_type:
    • endpoint: POST /subscription_types/{{ record.subscription_type_id }}
    • required fields: subscription_type_id
    • risk: update through the Gist API
  • create_conversation:
    • endpoint: POST /conversations
    • risk: create through the Gist API
  • update_conversation:
    • endpoint: PATCH /conversations/{{ record.conversation_id }}
    • required fields: conversation_id
    • risk: update through the Gist API
  • reply_to_conversation:
    • endpoint: POST /conversations/{{ record.conversation_id }}/messages
    • required fields: conversation_id
    • risk: create through the Gist API
  • delete_conversation:
    • endpoint: DELETE /conversations/{{ record.conversation_id }}
    • required fields: conversation_id
    • risk: delete through the Gist API
  • unassign_conversation:
    • endpoint: PATCH /conversations/{{ record.conversation_id }}/assign
    • required fields: conversation_id
    • risk: update through the Gist API
  • assign_conversation:
    • endpoint: PATCH /conversations/{{ record.conversation_id }}/assign
    • required fields: conversation_id
    • risk: update through the Gist API
  • snooze_conversation:
    • endpoint: PATCH /conversations/{{ record.conversation_id }}
    • required fields: conversation_id
    • risk: update through the Gist API
  • unsnooze_conversation:
    • endpoint: PATCH /conversations/{{ record.conversation_id }}
    • required fields: conversation_id
    • risk: update through the Gist API
  • close_conversation:
    • endpoint: PATCH /conversations/{{ record.conversation_id }}
    • required fields: conversation_id
    • risk: update through the Gist API
  • prioritize_conversation:
    • endpoint: PATCH /conversations/{{ record.conversation_id }}/priority
    • required fields: conversation_id
    • risk: update through the Gist API
  • tag_conversation:
    • endpoint: POST /conversations/{{ record.conversation_id }}/tags
    • required fields: conversation_id
    • risk: update through the Gist API
  • untag_conversation:
    • endpoint: DELETE /conversations/{{ record.conversation_id }}/tags
    • required fields: conversation_id
    • risk: delete through the Gist API
  • create_store:
    • endpoint: POST /ecommerce/stores
    • risk: create through the Gist API
  • update_store:
    • endpoint: PATCH /ecommerce/stores/{{ record.store_id }}
    • required fields: store_id
    • risk: update through the Gist API
  • create_customer:
    • endpoint: POST /ecommerce/stores/{{ record.store_id }}/customers
    • required fields: store_id
    • risk: create through the Gist API
  • update_customer:
    • endpoint: PATCH /ecommerce/stores/{{ record.store_id }}/customers/{{ record.customer_id }}
    • required fields: store_id, customer_id
    • risk: update through the Gist API
  • create_product:
    • endpoint: POST /ecommerce/stores/{{ record.store_id }}/products
    • required fields: store_id
    • risk: create through the Gist API
  • update_product:
    • endpoint: PATCH /ecommerce/stores/{{ record.store_id }}/products/{{ record.product_id }}
    • required fields: store_id, product_id
    • risk: update through the Gist API
  • create_product_variant:
    • endpoint: POST /ecommerce/stores/{{ record.store_id }}/products/{{ record.product_id }}/variants
    • required fields: store_id, product_id
    • risk: create through the Gist API
  • update_product_variant:
    • endpoint: PATCH /ecommerce/stores/{{ record.store_id }}/products/{{ record.product_id }}/variants/{{ record.product_variant_id }}
    • required fields: store_id, product_id, product_variant_id
    • risk: update through the Gist API
  • create_product_category:
    • endpoint: POST /ecommerce/stores/{{ record.store_id }}/categories
    • required fields: store_id
    • risk: create through the Gist API
  • update_product_category:
    • endpoint: PATCH /ecommerce/stores/{{ record.store_id }}/categories/{{ record.category_id }}
    • required fields: store_id, category_id
    • risk: update through the Gist API
  • upsert_cart:
    • endpoint: POST /ecommerce/stores/{{ record.store_id }}/customers/{{ record.customer_id }}/cart
    • required fields: store_id, customer_id
    • risk: upsert through the Gist API
  • delete_cart:
    • endpoint: DELETE /ecommerce/stores/{{ record.store_id }}/customers/{{ record.customer_id }}/cart
    • required fields: store_id, customer_id
    • risk: delete through the Gist API
  • create_order:
    • endpoint: POST /ecommerce/stores/{{ record.store_id }}/orders
    • required fields: store_id
    • risk: create through the Gist API
  • update_order:
    • endpoint: PATCH /ecommerce/stores/{{ record.store_id }}/orders/{{ record.order_id }}
    • required fields: store_id, order_id
    • risk: update through the Gist API

Security

  • read risk: external Gist API reads of workspace, contact, marketing, conversation, team, knowledge base, and e-commerce data
  • write risk: creates, updates, deletes, tags, subscribes, assigns, replies to, and otherwise mutates Gist workspace resources
  • approval: reverse ETL writes require plan preview and approval token
  • Never pass secret values in chat, shell arguments, logs, docs, or JSON output.

Commands

Inspect as a manual

pm connectors inspect getgist

Inspect as structured JSON

pm connectors inspect getgist --json

Agent Rules

  • Run pm connectors inspect getgist before creating credentials or plans.
  • Use --json only when the caller needs structured output; use the manual for human-readable guidance.
  • Never ask the user to paste secret values into chat.
  • For reverse ETL writes, create a plan, show the preview, wait for explicit approval, then run with the approval token.

04 同仓库更多 Skills