# Vistaly Knowledge Base

## Docs

- [Create a new card](https://docs.vistaly.com/api-reference/cards/create-a-new-card.md): Create a new card in your organization
- [Get card context](https://docs.vistaly.com/api-reference/cards/get-card-context.md): Retrieve hierarchical context for a card including ancestors (parent cards), descendants (child cards), or both. Each card in the response includes a 'level' field (0=target card, positive integers=distance from target) and a 'children' array (IDs of direct child cards). Use direction='ancestors' to…
- [Get card details](https://docs.vistaly.com/api-reference/cards/get-card-details.md): Retrieve detailed information about a specific card
- [List comments for a card](https://docs.vistaly.com/api-reference/cards/list-comments-for-a-card.md): Retrieve all comments for a specific card
- [Search cards using semantic search](https://docs.vistaly.com/api-reference/cards/search-cards-using-semantic-search.md): Search for cards across your organization using natural language queries
- [Submit bulk metrics for a card](https://docs.vistaly.com/api-reference/cards/submit-bulk-metrics-for-a-card.md): Submit multiple metrics related to a specific card identified by `cardId`. This allows for bulk import of metric datapoints for tracking and performance measurement.
- [Submit metrics for a card](https://docs.vistaly.com/api-reference/cards/submit-metrics-for-a-card.md): Submit various metrics related to a specific card identified by `cardId`. This allows for tracking and performance measurement of the card.
- [Update card](https://docs.vistaly.com/api-reference/cards/update-card.md): Update an existing card
- [Update card parents](https://docs.vistaly.com/api-reference/cards/update-card-parents.md): Update a card's parent relationships by adding new parents and/or removing existing parents in a single atomic operation. This enables moving cards (remove old, add new) and multi-parent scenarios.
- [Redirect to full LLM documentation](https://docs.vistaly.com/api-reference/documentation/redirect-to-full-llm-documentation.md): Redirect to the complete Vistaly documentation with detailed guides, blog posts, API reference, and extensive examples for LLMs.
- [Redirect to summary LLM documentation](https://docs.vistaly.com/api-reference/documentation/redirect-to-summary-llm-documentation.md): Redirect to the comprehensive Vistaly documentation including API reference, guides, and key concepts in a condensed format for LLMs.
- [Delete feedback](https://docs.vistaly.com/api-reference/feedback/delete-feedback.md): Delete a feedback entry. This performs a soft delete by marking the feedback as deleted while preserving the data.
- [Submit user feedback](https://docs.vistaly.com/api-reference/feedback/submit-user-feedback.md): Submit feedback from users to improve the product. This can include general comments or specific insights on their experience.
- [Delete interview](https://docs.vistaly.com/api-reference/interviews/delete-interview.md): Delete an interview entry. This performs a soft delete by marking the interview as deleted while preserving the data.
- [Get interview transcript](https://docs.vistaly.com/api-reference/interviews/get-interview-transcript.md): Retrieve the transcript for a specific interview
- [Submit interview data](https://docs.vistaly.com/api-reference/interviews/submit-interview-data.md): Submit an interview record that contains valuable information regarding user interactions, feedback, and insights.
- [Introduction](https://docs.vistaly.com/api-reference/introduction.md): Welcome to Vistaly's API Documentation
- [Auth info endpoint](https://docs.vistaly.com/api-reference/system/auth-info-endpoint.md): Returns the information related to the api key.
- [Health check endpoint](https://docs.vistaly.com/api-reference/system/health-check-endpoint.md): Returns the health status of the API. This is used to verify if the API is operating normally.
- [Get more out of your discovery work (OSTs)](https://docs.vistaly.com/blog/getting-more-out-of-osts.md): How can you maximize the value of your discovery work using OSTs?
- [Using OKRs to Align Product Teams with Jeff Gothelf](https://docs.vistaly.com/blog/okrs-for-product-team-alignment-with-jeff-gothelf.md): Recap of our event with Jeff Gothelf on using OKRs to align your Product teams: moving away from planning "seasons", clarifying strategy before setting OKRs, Key Results that measure change in behavior, and changing the plan as you learn more.
- [Opportunity Solution Tree (OST) Patterns](https://docs.vistaly.com/blog/ost-patterns.md): This article is a collection of Opportunity Solution Tree (OST) patterns we at [Vistaly](https://vistaly.com) have observed teams use in their day-to-day work. Taking advantage of the patterns below does not require Vistaly to get started. While some can easily be applied using free-form tools like…
- [Product Analytics (From Zero To Basic To Best-In-Class) Live Event with Busra Coskuner](https://docs.vistaly.com/blog/product-analytics-with-busra-coskuner.md): Recap of the live event we did with Büşra Coşkuner about how product teams can move from a basic metrics foundation to focusing on outcomes that drive real business impact.
- [Breaking Business Outcomes down into Product Outcomes with Ant Murphy](https://docs.vistaly.com/blog/product-outcomes-with-ant-murphy.md): Recap of the live event we did with Ant Murphy on how to break Business Outcomes down into Product Outcomes so your team can run more effective discovery.
- [Project Learning Tax](https://docs.vistaly.com/blog/project-learning-tax.md): Is there a tax that we pay when starting a new project or begin solving a new problem?
- [Jon Harmer & Scott Sehlhorst - Bridging day-to-day product work with business impact](https://docs.vistaly.com/blog/solution-hypothesis-and-outcome-hypothesis.md): Recap of our live event with Jon and Scott on how product teams should explicitly state your Solution Hypothesis and Outcome Hypothesis to connect day-to-day product work to business impact
- [Strategic Prioritization](https://docs.vistaly.com/blog/strategic-prioritization.md): Strategic prioritization helps answer the question - "What should we focus on now vs next?" But what does this look like in practice?.
- [Taming Opportunity Solution Trees (Part One)](https://docs.vistaly.com/blog/taming-osts-part-one.md): It's not difficult to become overwhelmed by evaluating a large number of opportunities in your Opportunity Solution Trees. This post looks at several scenarios teams find themselves in and offers tips for getting unstuck.
- [Taming Opportunity Solution Trees (Part Two)](https://docs.vistaly.com/blog/taming-osts-part-two.md): This is part two of a series on taking control of your Opportunity Solution Trees. In this post, we interview Dr. Else van der Berg (product management, discovery & validation enthusiast) on tactics she uses within her trios to keep noise down and signal high.
- [Keep all your discovery interviews and customer feedback in Vistaly](https://docs.vistaly.com/blog/voice-of-customer-in-vistaly.md): You have so many tools you can work with to capture the voice of the customer, but they only add value when insights are used to make decisions. See how Vistaly's interview and feedback Opportunity Solution Tree integration helps you get the most out of what you hear from your customers.
- [2023](https://docs.vistaly.com/changelog/2023.md)
- [2024](https://docs.vistaly.com/changelog/2024.md)
- [2025](https://docs.vistaly.com/changelog/2025.md)
- [Latest Changelog](https://docs.vistaly.com/changelog/latest.md)
- [Drafting Documents](https://docs.vistaly.com/documentation/ai-document-drafting/drafting-workflow.md): Step-by-step guide to generating AI-powered documentation
- [Document Drafting Overview](https://docs.vistaly.com/documentation/ai-document-drafting/overview.md): Generate evidence-based documentation for opportunities, solutions, experiments, and any other card type using AI and templates
- [Template Management](https://docs.vistaly.com/documentation/ai-document-drafting/template-management.md): Create and manage templates for AI-powered document drafting
- [Archiving](https://docs.vistaly.com/documentation/core-concepts/archiving.md): Archiving work is a great way to keep a workspace clean and focused without losing historical data.
- [Assumption](https://docs.vistaly.com/documentation/core-concepts/card-types/assumption.md): Assumptions are one of the supported [Discovery Space](/guides/getting-started/the-discovery-space) card types.
- [KPI/Metric](https://docs.vistaly.com/documentation/core-concepts/card-types/kpi.md): KPIs *(Key Performance Indicators)* are for quantitative measures of business performance, product usage, or user sentiment.
- [Objective](https://docs.vistaly.com/documentation/core-concepts/card-types/objective.md): Objectives are **Near-term Goal cards** that qualitatively describe the progress you want to make in the coming months/quarters/year.
- [Opportunity](https://docs.vistaly.com/documentation/core-concepts/card-types/opportunity.md): Opportunities are one of the supported [Discovery Space](/guides/getting-started/the-discovery-space) card types.
- [Outcome](https://docs.vistaly.com/documentation/core-concepts/card-types/outcome.md): Outcomes are Near-term Goal cards that quantitatively measure the progress you want to make in the coming months/quarters/year.
- [Card Type Overview](https://docs.vistaly.com/documentation/core-concepts/card-types/overview.md): Configure Vistaly Cards to match your business' language.
- [Solution](https://docs.vistaly.com/documentation/core-concepts/card-types/solution.md): Solutions are one of the supported [Discovery Space](/guides/getting-started/the-discovery-space) card types.
- [Experiment](https://docs.vistaly.com/documentation/core-concepts/card-types/test.md): Experiments (Assumption Tests) are one of the supported [Discovery Space](/guides/getting-started/the-discovery-space) card types.
- [Vision/Mission](https://docs.vistaly.com/documentation/core-concepts/card-types/vision-statement.md): Vision (Mission) Cards are part of the [Strategy Space](/guides/getting-started/the-strategy-space).
- [Commenting](https://docs.vistaly.com/documentation/core-concepts/commenting.md): Commenting supports documenting learning, and collaboration across one or more teams.
- [Custom Fields](https://docs.vistaly.com/documentation/core-concepts/custom-fields.md): Custom fields in Vistaly support your team's unique needs.
- [External Links](https://docs.vistaly.com/documentation/core-concepts/external-links.md): Add links to external resources like Figma, Notion, Google Docs, etc.
- [Filters](https://docs.vistaly.com/documentation/core-concepts/filters.md): Filters are a great tool for creating custom views of your data.
- [Inviting Team Members](https://docs.vistaly.com/documentation/core-concepts/inviting-team-members.md): Inviting members of your team to collaborate in vistaly.
- [Labels](https://docs.vistaly.com/documentation/core-concepts/labels.md): Labels are designed to be a flexible tagging system for your data. Use them to annotate and filter data.
- [Notifications](https://docs.vistaly.com/documentation/core-concepts/notifications.md): Get notified when important conversations happen
- [Statuses](https://docs.vistaly.com/documentation/core-concepts/statuses.md): Statuses are used to communicate risk, commitment, and progress across all card types.
- [Unmapped Cards](https://docs.vistaly.com/documentation/core-concepts/unmapped-cards.md): Unmapped cards where cards go that don't have a clear space on the tree or are not ready to be placed there.
- [Workspaces](https://docs.vistaly.com/documentation/core-concepts/workspaces.md): Vistaly workspaces contain strategy and discovery cards.
- [Browser Extension](https://docs.vistaly.com/documentation/integrations/browser-extension.md): Send feedback to Vistaly using the browser extension
- [Google Sheets](https://docs.vistaly.com/documentation/integrations/google-sheets.md): Create a simple Google Sheets integration using App Script
- [Jira](https://docs.vistaly.com/documentation/integrations/jira.md): Integrate Jira with Vistaly
- [Linear](https://docs.vistaly.com/documentation/integrations/linear.md): Integrate Linear with Vistaly
- [Microsoft Single Sign-On](https://docs.vistaly.com/documentation/integrations/microsoft-sso.md): Using Microsoft accounts to sign in to Vistaly
- [Model Context Protocol (MCP)](https://docs.vistaly.com/documentation/integrations/model-context-protocol.md): Connect AI assistants like Claude Desktop to your Vistaly workspace
- [Slack Integration](https://docs.vistaly.com/documentation/integrations/slack.md): Using Slack and Vistaly together
- [Vistaly API](https://docs.vistaly.com/documentation/integrations/vistaly-api.md): Integrate your workflows directly with Vistaly
- [Zapier](https://docs.vistaly.com/documentation/integrations/zapier.md): Leverage Zapier to automate analytics
- [CSV Feedback Import](https://docs.vistaly.com/documentation/migration-support/insights-importer.md): Bulk import your feedback
- [Productboard Feedback](https://docs.vistaly.com/documentation/migration-support/productboard.md): This guide will walk you through the process of migrating customer feedback from Productboard into Vistaly.
- [Insights](https://docs.vistaly.com/documentation/views/insights.md): Embed the voice of the customer directly in your Opportunity Solution Tree
- [Reports](https://docs.vistaly.com/documentation/views/reports.md): Reports in Vistaly provide a streamlined view of your work’s impact without overwhelming detail. They allow you to showcase key metrics and outcomes in an easily shareable format.
- [Roadmap](https://docs.vistaly.com/documentation/views/roadmap.md): Now / Next / Later view of commitments
- [Settings](https://docs.vistaly.com/documentation/views/settings.md): Configure your organization, team, and workspace settings.
- [Test Tracker](https://docs.vistaly.com/documentation/views/test-tracker.md)
- [Tree](https://docs.vistaly.com/documentation/views/tree.md): The Tree View unites the [Strategy Space](/guides/getting-started/the-strategy-space) and the [Discovery Space](/guides/getting-started/the-discovery-space), and drives everything that happens in Vistaly.
- [Introduction](https://docs.vistaly.com/guides/getting-started/introduction.md): Welcome to Vistaly's Knowledge Base – Find everything you need to build a world class operating system for your product organization.
- [Team Onboarding](https://docs.vistaly.com/guides/getting-started/team-onboarding.md): Vistaly is designed as a collaborative platform where teams align on strategy, discover opportunities, and track progress. While you can use Vistaly individually, its true power comes form teams collaborating within the platform.
- [The Discovery Space](https://docs.vistaly.com/guides/getting-started/the-discovery-space.md): The Discovery Space in Vistaly is where product teams explore customer needs, generate solution ideas, and validate assumptions with testing.
- [The Strategy Space](https://docs.vistaly.com/guides/getting-started/the-strategy-space.md): The Strategy Space in Vistaly is how you align the whole product organization from \"Where do we want to be in 10 years?\" to \"Where do we want to be in 3 months?\".
- [Workspace Planning](https://docs.vistaly.com/guides/getting-started/workspace-planning.md): A workspace is where teams collaborate. This guide will help you figure out how many you need.
- [KPI Trees – Visualizing Metrics](https://docs.vistaly.com/guides/metrics/kpi-trees.md): Deep dive into KPI Trees and how to improve metric and goal execution.
- [Overview](https://docs.vistaly.com/mcp-cookbook/index.md): Practical recipes for using AI assistants with Vistaly's Model Context Protocol integration
- [Run an Ideation Session](https://docs.vistaly.com/mcp-cookbook/opportunity-space/ideation.md): Brainstorm solutions for an opportunity with AI as your collaborator
- [Evaluate and Improve Your Opportunity Space](https://docs.vistaly.com/mcp-cookbook/opportunity-space/restructuring-ost.md): Go wide across opportunities, deep into evidence, and reorganize your tree with an AI collaborator
- [Generate a Workspace Summary](https://docs.vistaly.com/mcp-cookbook/reporting/workspace-summary.md): Get a 20,000 foot view of your workspace for executive updates and status reports

## OpenAPI Specs

- [swagger](https://api.vistaly.com/v1/swagger.json)
- [openapi](https://docs.vistaly.com/api-reference/openapi.json)

## Optional

- [Book Onboarding Session](https://vistaly.com/request-a-trial)