AppDirect - Printing Press CLI

Prerequisites: Install the CLI

This skill drives the appdirect-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. macOS / Linux:

   bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/appdirect/install.sh)
   

2. Windows (PowerShell):

   iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/appdirect/install.ps1 | iex
   

3. Verify: appdirect-cli --version
4. Ensure ~/.local/bin (macOS / Linux) or %LOCALAPPDATA%\Programs\msp-skills (Windows) is on $PATH.

The installer downloads the appdirect-cli and appdirect-mcp binaries into ~/.local/bin (macOS / Linux) or %LOCALAPPDATA%\Programs\msp-skills (Windows). It does not register the skill with your agent and writes no MCP client config - see mcp-install.md for that wire-up.

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

AppDirect partners manage thousands of subscriptions across hundreds of companies through a click-heavy console or hand-rolled curl with hourly-expiring OAuth tokens. This CLI mints and caches tokens invisibly, wraps the full marketplace REST surface (subscriptions, companies, users, billing, assisted sales, catalog), and syncs it all to local SQLite so commands like 'reconcile', 'subs changed', and 'pipeline' answer cross-entity questions no console screen can.

When to Use This CLI

Use this CLI for AppDirect marketplace operations: listing and managing subscriptions, companies, users, and memberships; pulling invoices and payments; reconciling billing; and working assisted-sales pipelines. It shines on cross-entity questions (billing mismatches, churn, stale deals) because everything syncs to a local SQLite store that supports search, SQL, and joins.

Anti-triggers

Do not use this CLI for:

• Building or theming a marketplace storefront - that is @appdirect/sfb-toolkit, not this CLI
• Developing ISV product connectors / integration event handlers - use the AppDirect connector SDKs
• End-user purchases on a marketplace you do not operate - this CLI needs partner API credentials
• AppDirect GraphQL-only surfaces (newer product/catalog graph queries) - this CLI wraps the REST API

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Local joins that close the books

• reconcile - Flag active subscriptions with no matching invoice, orphan invoices, and failed or unpaid payments across every company before month-close.

  Reach for this when asked whether billing matches reality across the marketplace - it answers in one call what otherwise takes hundreds of per-company console lookups.

  appdirect-cli reconcile --since 30d --agent
  

• payments unpaid - List failed or unavailable-gateway payments across all companies, sorted by amount and age.

  Use this for the weekly failed-payment chase instead of paging through company billing screens.

  appdirect-cli payments unpaid --since 7d --json
  

• company show - One customer's full picture - users, subscriptions, invoices, and open opportunities - in a single view.

  Pick this for onboarding or support questions about a specific customer instead of four separate API calls.

  appdirect-cli company show 12345678-aaaa-bbbb-cccc-1234567890ab --json
  

Change radar

• subs changed - See subscriptions created, ended, or in an inactive status (suspended/cancelled/failed) across all companies in a time window.

  Use this for churn checks and weekly change review across the whole marketplace.

  appdirect-cli subs changed --since 7d --json
  

Pipeline as data

• pipeline - Roll up the assisted-sales pipeline by status or owner with opportunity counts and ages.

  Use this when asked for a pipeline rollup by status or owner instead of opening each opportunity.

  appdirect-cli pipeline --group-by status --agent
  

• pipeline stale - Find open opportunities created more than N days ago, oldest first.

  Use this to surface stalled deals before they die quietly.

  appdirect-cli pipeline stale --days 14 --json
  

Command Reference

account - Manage account

• appdirect-cli account resource-company-create-active-user-post - Create a marketplace user with membership in the given company.
• appdirect-cli account resource-company-create-company-membership-patch - Update role assignments for one or more company memberships (users).
• appdirect-cli account resource-company-create-company-membership-post - Add a new or existing user as a member of a marketplace company.
• appdirect-cli account resource-company-create-company-post - Create a new marketplace company
• appdirect-cli account resource-company-delete-company-membership-delete - Delete a marketplace user's company membership.
• appdirect-cli account resource-company-get-invited-users-get - Retrieve a marketplace company's user invitations.
• appdirect-cli account resource-company-get-verified-domains-get - Retrieve a marketplace company's verified domains.
• appdirect-cli account resource-company-invite-csvusers-post - Invite multiple users to a marketplace company using a CSV file.
• appdirect-cli account resource-company-invite-managed-user-post - Invite a managed user as a member of a marketplace company.
• appdirect-cli account resource-company-invite-users-post - Invite multiple users to a marketplace company using list of Invitation resources.
• appdirect-cli account resource-company-partial-update-company-membership-patch - Enable or disable marketplace user's company membership.
• appdirect-cli account resource-company-patch-company-patch - Partially update marketplace company account information.
• appdirect-cli account resource-company-read-all-companies-get - Retrieve all marketplace companies. Rate limit: Bucket size is 20 requests, with a leak rate of 5 requests per second.
• appdirect-cli account resource-company-read-assignable-roles-get - Retrieve marketplace roles that can be assigned by this company membership.
• appdirect-cli account resource-company-read-company-activities-get - Retrieve company or user activities.
• appdirect-cli account resource-company-read-company-get - Retrieve a marketplace company by ID or external ID.
• appdirect-cli account resource-company-read-company-membership-get - Retrieve a marketplace user's company membership information.
• appdirect-cli account resource-company-read-company-memberships-get - List a marketplace company's user memberships.
• appdirect-cli account resource-company-read-domain-get - Get a specific company domain
• appdirect-cli account resource-company-read-domains-get - Retrieve a marketplace company's domains.
• appdirect-cli account resource-company-read-user-assignments-get - Retrieve a marketplace user's application assignments. Returns assignments that are not FAILED or CANCELLED.
• appdirect-cli account resource-company-read-user-checklist-get - Retrieve a marketplace user's checklist.
• appdirect-cli account resource-company-request-purchase-post - Request to purchase an application for the given marketplace company and user.
• appdirect-cli account resource-company-revoke-invitation-delete - Revoke a user's invitiation to a marketplace company.
• appdirect-cli account resource-company-update-company-membership-put - Update a marketplace user's company membership.
• appdirect-cli account resource-company-update-company-picture-put - Update a marketplace company’s profile picture, for example, with an image of a logo.
• appdirect-cli account resource-company-update-company-put - Update a marketplace company.
• appdirect-cli account resource-group-batch-create-or-update-group-memberships-post - Create batched group memberships change requests.
• appdirect-cli account resource-group-create-post - Create a user group for a marketplace company.
• appdirect-cli account resource-group-delete-delete - Delete a user group for the requested marketplace company.
• appdirect-cli account resource-group-delete-group-membership-delete - Delete a user from a marketplace company's user group.
• appdirect-cli account resource-group-read-all-get - Retrieve a marketplace company's user groups.
• appdirect-cli account resource-group-read-company-groups-for-user-get - Retrieve the list of groups the company membership is in.
• appdirect-cli account resource-group-read-get - Retrieve a marketplace company's user group.
• appdirect-cli account resource-group-read-group-membership-get - Retrieve a user/company membership resource.
• appdirect-cli account resource-group-read-group-memberships-get - List members of a user group for the requested marketplace company.
• appdirect-cli account resource-group-save-group-membership-put - Add a user to marketplace company's user group.
• appdirect-cli account resource-group-update-put - Update user group for the requested marketplace company.
• appdirect-cli account resource-invitation-update-invitation-with-registration-post - Accept a user's invitation to a marketplace company
• appdirect-cli account resource-my-apps-read-app-by-pending-id - Retrieve a marketplace user's application when assignment is pending.
• appdirect-cli account resource-my-apps-read-app-by-user-entitlement - Retrieve a marketplace user's application when assignment is complete.
• appdirect-cli account resource-my-apps-read-apps - List all applications assigned to a marketplace company user.
• appdirect-cli account resource-my-apps-update-apps-order - Update the order in which applications will should show up on the MyApps page.
• appdirect-cli account resource-read-company-assignable-roles-get - Retrieves a list of marketplace roles that the current
• appdirect-cli account resource-subscription-create-subscription-assignment-post - Create an application assignment for a marketplace user.
• appdirect-cli account resource-subscription-delete-subscription-assignment-delete - Delete a marketplace user's application assignment.
• appdirect-cli account resource-subscription-read-saml-certificate-get - Retrieve a subscriptions's public SAML verification certificate.
• appdirect-cli account resource-subscription-read-saml-info-get - Retrieve a subscription's SAML metadata.
• appdirect-cli account resource-subscription-read-subscription-assignment-count-head - Retrieve the number of users assigned to a subscription.
• appdirect-cli account resource-subscription-read-subscription-assignment-get - Retrieve a marketplace user's application assignment for a given subscription.
• appdirect-cli account resource-subscription-read-subscription-assignments-get - Retrieve the list of marketplace application assignments for the given subscription.
• appdirect-cli account resource-subscription-request-subscription-reactivation-post - Send a subscription reactivation request. This endpoint sends a notification to the subscription owner.
• appdirect-cli account resource-user-patch-user-profile-patch - Update a marketplace user's profile. Also marks user's checklist with profile as completed.
• appdirect-cli account resource-user-read-all-users-get - Retrieves all marketplace users
• appdirect-cli account resource-user-read-reseller-user-get - Reads a reseller user's company associations
• appdirect-cli account resource-user-read-user-get - Retrieves a marketplace user by ID or external ID. If you use the ID, you can omit a prefix or use 'id:' as the prefix.
• appdirect-cli account resource-user-read-user-memberships-get - Retrieve a user's company memberships.
• appdirect-cli account resource-user-read-user-profile-get - Retrieve profile information for a marketplace user.
• appdirect-cli account resource-user-set-temporary-password-put - Set a temporary password for the given marketplace user.
• appdirect-cli account resource-user-update-current-company-put - Update a marketplace user's last used company.
• appdirect-cli account resource-user-update-inactive-user-patch - Activate a marketplace user using its associated activation token.
• appdirect-cli account resource-user-update-user-patch - Update ('patch') one or more fields in the user details.
• appdirect-cli account resource-user-update-user-picture-put - Update a marketplace user’s profile picture.
• appdirect-cli account resource-user-update-user-profile-put - Update a marketplace user's profile. Also marks user's checklist with profile as completed.
• appdirect-cli account resource-user-update-user-put - Updates a marketplace user

app-market - Manage app market

• appdirect-cli app-market create-payment-method - When using a token, the validated payment method is assigned to the current user on the current marketplace.
• appdirect-cli app-market create-payment-method-token - Calls the payment gateway to validate the payment method, which is not yet associated with a user.
• appdirect-cli app-market create-transfer-method - Creates a new Transfer Method for the requesting (authenticated) user
• appdirect-cli app-market create-transfer-platform-configuration - Create a transfer platform configuration in the marketplace of the current user
• appdirect-cli app-market delete-payment-method - The payment method is deleted from the system and cannot be used anymore.
• appdirect-cli app-market delete-transfer-method - Deletes the transfer method with the specified ID
• appdirect-cli app-market delete-transfer-platform-configuration - Deletes the specified transfer platform configuration. It cannot be used anymore
• appdirect-cli app-market get-default-payment-methods - Returns the default payment methods for the specified user in the specified company
• appdirect-cli app-market get-payment-method-types - Returns all supported Payment Method Types. These are the only types of payment method that can be created.
• appdirect-cli app-market get-payment-methods - Returns all available payment methods for the specified user in the specified company.
• appdirect-cli app-market get-transfer-method - Retrieves the Transfer Method for the given ID
• appdirect-cli app-market get-transfer-methods - Retrieves the transfer methods associated with the requesting (authenticated) user
• appdirect-cli app-market get-transfer-platform-configuration - Retrieves the transfer platform configuration by ID
• appdirect-cli app-market get-transfer-platform-configurations - Retrieves all transfer platform configurations for the marketplace of the current user
• appdirect-cli app-market set-default-payment-method - Sets a default payment method for the specified user
• appdirect-cli app-market update-transfer-platform-configuration - Updates the specified transfer platform configuration

app-reseller - Manage app reseller

• appdirect-cli app-reseller resource-account-v1-company-api-detail-get - Retrieves the current reseller company details.
• appdirect-cli app-reseller resource-account-v1-company-api-get-get - Retrieves companies depending on context: in the Reseller context
• appdirect-cli app-reseller resource-account-v1-company-api-post-post - Create a new company linked to the current reseller.
• appdirect-cli app-reseller resource-account-v1-customer-company-association-api-delete-delete - Deletes a company association.
• appdirect-cli app-reseller resource-account-v1-customer-company-association-api-get-get - Retrieves all customer company associations.
• appdirect-cli app-reseller resource-account-v1-customer-company-association-api-post-post - Creates an association (link) between a customer company and a reseller company.
• appdirect-cli app-reseller resource-account-v1-user-api-get-get - In the Reseller Manager context, this request retrieves all Resellers and Referral users.
• appdirect-cli app-reseller resource-account-v1-user-api-post-post - Create a new user in a company linked to the Reseller company.
• appdirect-cli app-reseller resource-account-v1-user-detail-api-get-get - Get a single user details
• appdirect-cli app-reseller resource-billing-v1-assignment-api-delete - Unassign a product from a user.
• appdirect-cli app-reseller resource-billing-v1-order-uiapi-get - Retrieves a list of all user orders of a linked company. You can filter the list using optional query parameters.
• appdirect-cli app-reseller resource-billing-v1-subscription-api-delete - Note: This endpoint is being deprecated.
• appdirect-cli app-reseller resource-billing-v1-subscription-api-get - Note: This endpoint is being deprecated. // Retrieves a list of all user subscriptions of a linked company.
• appdirect-cli app-reseller resource-billing-v1-subscription-api-get-one - Note: This endpoint is being deprecated. // Read a subscription by ID
• appdirect-cli app-reseller resource-billing-v1-subscription-api-post - Note: This endpoint is being deprecated.
• appdirect-cli app-reseller resource-billing-v1-subscription-api-put - Note: This endpoint is being deprecated.
• appdirect-cli app-reseller resource-v1-payment-method-api-get - Deletes a user's payment methods
• appdirect-cli app-reseller resource-v1-payment-method-api-post - Creates a payment method on behalf of the specified user
• appdirect-cli app-reseller resource-v1-payment-methods-api-get - Retrieves a list of the specified user's payment methods
• appdirect-cli app-reseller resource-v1-subscription-assignment-api-get - Retrieves a list of assignments for a given subscription. You can filter the list using optional query parameters.
• appdirect-cli app-reseller resource-v1-subscription-assignment-api-post - Assign a seat of a purchased product to a user who is a member of a linked marketplace company
• appdirect-cli app-reseller sellable-product-editions-catalog-v1-api-get-get - Get product editions, costs and markups.
• appdirect-cli app-reseller sellable-products-catalog-v1-api-get-get - Retrieve all products that a Reseller can sell.

appdirect-sync - Manage appdirect sync

• appdirect-cli appdirect-sync resource-developer-account-create-developer-account-post - This call creates a developer account. Maximum of global requests of 20 per 2 seconds.
• appdirect-cli appdirect-sync resource-developer-account-expire-developer-account-post - This call expires a developer account. Maximum of global requests of 20 per 2 seconds.
• appdirect-cli appdirect-sync resource-user-assign-user-post - This call assigns a user. Maximum of global requests of 20 per 2 seconds.
• appdirect-cli appdirect-sync resource-user-unassign-user-post - This call unassigns a user. Maximum of global requests of 20 per 2 seconds.
• appdirect-cli appdirect-sync user-assignment-get - This call retrieves a user assignment. Maximum of global requests of 20 per 2 seconds.

appwise - Manage appwise

• appdirect-cli appwise disconnecting - Disconnects an existing user account from Search.
• appdirect-cli appwise events - Publishes content events that contain new or changed data in referenced resources.
• appdirect-cli appwise provisioning - Creates a new user connection for Search.
• appdirect-cli appwise users-index-search - Search a unified index of content derived from a user's connected accounts. Requires a user-based token.

assisted-sales - Manage assisted sales