# Dacard.ai

> Knowledge base and API documentation for the Dacard.ai decision intelligence platform

## Docs

- [Get account](https://docs.dacard.ai/api-reference/account/get-account.md): Get the authenticated user's account. Auto-creates an account based on email domain if one does not exist.
- [List account members](https://docs.dacard.ai/api-reference/account/list-account-members.md): List all members of the authenticated user's account.
- [Remove a member](https://docs.dacard.ai/api-reference/account/remove-a-member.md): Remove a member from the account. Self-removal (leave org) is allowed for any authenticated member. Removing others requires manage_members permission. The last admin cannot leave without transferring ownership first.
- [Update account name](https://docs.dacard.ai/api-reference/account/update-account-name.md): Update the account display name.
- [Update member role](https://docs.dacard.ai/api-reference/account/update-member-role.md): Change a member's role. Cannot assign a role higher than your own. Cannot demote the last member with manage_members permission. Cannot modify a user who outranks you.
- [Create agent definition](https://docs.dacard.ai/api-reference/agents/create-agent.md): Create a new agent definition. The agent starts in paused status and must be explicitly activated.
- [Create agent trigger](https://docs.dacard.ai/api-reference/agents/create-trigger.md): Create a new trigger that fires an agent based on a schedule or event condition.
- [Delete agent definition](https://docs.dacard.ai/api-reference/agents/delete-agent.md): Permanently delete an agent definition and its trigger configurations. Artifacts generated by the agent are retained.
- [Delete agent trigger](https://docs.dacard.ai/api-reference/agents/delete-trigger.md): Permanently delete a trigger.
- [Get agent definition](https://docs.dacard.ai/api-reference/agents/get-agent.md): Retrieve a single agent definition with its 10 most recent runs.
- [List agent definitions](https://docs.dacard.ai/api-reference/agents/list-agents.md): List all agent definitions for the authenticated user's account. Includes run statistics (last run, tasks completed, success rate). Default agents are seeded automatically on first call if none exist.
- [List agent artifacts](https://docs.dacard.ai/api-reference/agents/list-artifacts.md): List artifacts produced by agent runs. Supports filtering by status, agent, product, and artifact type.
- [List agent runs](https://docs.dacard.ai/api-reference/agents/list-runs.md): List execution history for a specific agent with pagination.
- [List agent triggers](https://docs.dacard.ai/api-reference/agents/list-triggers.md): List all triggers for the authenticated user's account. Optionally filter by agent.
- [Manually trigger agent run](https://docs.dacard.ai/api-reference/agents/run-agent.md): Immediately execute an agent run outside its normal schedule. The agent must belong to the authenticated user's account.
- [Update agent definition](https://docs.dacard.ai/api-reference/agents/update-agent.md): Update an agent's name, description, status, or configuration.
- [Update agent trigger](https://docs.dacard.ai/api-reference/agents/update-trigger.md): Update a trigger's enabled state, name, condition, or action configuration.
- [Acknowledge an Anomaly](https://docs.dacard.ai/api-reference/anomalies/acknowledge-anomaly.md): Marks a signal anomaly as acknowledged. The anomaly must belong to the authenticated user's account.
- [Clear Sensitivity Override](https://docs.dacard.ai/api-reference/anomalies/clear-sensitivity-override.md): Removes the sensitivity override for a given event type, reverting to the default sigma of 2.5.
- [Convert Anomaly to Linear Issue](https://docs.dacard.ai/api-reference/anomalies/convert-to-linear.md): Converts a signal anomaly into a Linear issue using the account's existing Linear integration. Returns the created issue ID and URL.
- [List Anomalies](https://docs.dacard.ai/api-reference/anomalies/list-anomalies.md): Returns unacknowledged signal anomalies for the authenticated user's account. Results are paginated via cursor. Supports optional filtering by granularity and severity.
- [List Sensitivity Overrides](https://docs.dacard.ai/api-reference/anomalies/list-sensitivity-overrides.md): Returns all anomaly sensitivity overrides for the authenticated user's account.
- [Set Sensitivity Override](https://docs.dacard.ai/api-reference/anomalies/set-sensitivity-override.md): Creates or updates the anomaly detection sensitivity override for a given event type. Threshold must be between 1.0 and 5.0 (default sigma = 2.5).
- [Create API Key](https://docs.dacard.ai/api-reference/api-keys/create-api-key.md): Generate a new API key for the account. The full key value is returned once in `fullKey` and is never retrievable again.
- [List API Keys](https://docs.dacard.ai/api-reference/api-keys/list-api-keys.md): List all API keys for the account. Key values are never returned after initial creation.
- [Revoke API Key](https://docs.dacard.ai/api-reference/api-keys/revoke-api-key.md): Permanently revoke an API key. Any in-flight requests using the key will begin failing immediately.
- [Create billing portal session](https://docs.dacard.ai/api-reference/billing/create-billing-portal-session.md): Create a Stripe Billing Portal session for managing subscription.
- [Create checkout session](https://docs.dacard.ai/api-reference/billing/create-checkout-session.md): Create a Stripe Checkout session for upgrading to a paid plan. If user already has an active subscription, returns a Billing Portal URL.
- [Stripe webhook handler](https://docs.dacard.ai/api-reference/billing/stripe-webhook-handler.md): Handles Stripe webhook events for subscription lifecycle management. Authenticated via Stripe webhook signature verification (not user-callable).
- [Get dashboard data](https://docs.dacard.ai/api-reference/dashboard/get-dashboard-data.md): Aggregated dashboard analytics including all products with their latest scores, deltas, dimensions, portfolio average, and score timeline.
- [Get suite intelligence](https://docs.dacard.ai/api-reference/dashboard/get-suite-intelligence.md): Cross-product suite analytics including dimension heatmap, systemic strengths/weaknesses, cluster analysis, and computed insights.
- [Connect Integration](https://docs.dacard.ai/api-reference/integrations/connect-integration.md)
- [Disconnect Integration](https://docs.dacard.ai/api-reference/integrations/disconnect-integration.md)
- [Get Integration Status](https://docs.dacard.ai/api-reference/integrations/get-integration-status.md)
- [List Integrations](https://docs.dacard.ai/api-reference/integrations/list-integrations.md)
- [Sync Integration](https://docs.dacard.ai/api-reference/integrations/sync-integration.md)
- [Get Alerts](https://docs.dacard.ai/api-reference/intelligence/get-alerts.md): Returns alerts for the authenticated user's account. Alerts are generated by the intelligence engine when significant score changes, anomalies, or coaching opportunities are detected.
- [Get Compound Score](https://docs.dacard.ai/api-reference/intelligence/get-compound-score.md)
- [Get Tensions](https://docs.dacard.ai/api-reference/intelligence/get-tensions.md)
- [Clear demo data](https://docs.dacard.ai/api-reference/internal/clear-demo-data.md): Delete all products and scoring results for the current user's account. Used to reset demo/seed data.
- [Get PQL score](https://docs.dacard.ai/api-reference/internal/get-pql-score.md): Compute and return the Product Qualified Lead score for the current user. Internal/admin endpoint for tracking user engagement signals.
- [Seed suite with sample data](https://docs.dacard.ai/api-reference/internal/seed-suite-with-sample-data.md): Populate the current user's account with sample products and scoring data for demo purposes. Skips products whose URLs already exist.
- [Track a PQL event](https://docs.dacard.ai/api-reference/internal/track-a-pql-event.md): Track a Product Qualified Lead event from the client. Silently succeeds for anonymous users (no-op).
- [Get latest lifecycle assessment](https://docs.dacard.ai/api-reference/lifecycle/get-lifecycle-assessment.md): Retrieve the most recent lifecycle assessment for a product, including answers and computed score.
- [Get lifecycle stage definitions](https://docs.dacard.ai/api-reference/lifecycle/get-lifecycle-stages.md): Return all six AI-Native Lifecycle stage definitions with their associated tasks and criteria. This endpoint is public and does not require authentication.
- [Submit lifecycle self-assessment](https://docs.dacard.ai/api-reference/lifecycle/submit-lifecycle-assessment.md): Submit a lifecycle self-assessment for a product. Each answer maps a task ID to a completion status (not_started, in_progress, completed). The system computes a lifecycle score and persists the assessment.
- [Ingest Outcome Observation](https://docs.dacard.ai/api-reference/outcomes/create-outcome.md): Ingests a manual outcome observation. Used by design-partner teams to record real business metric values that can be correlated with DAC scores over time.
- [Delete Outcome Observation](https://docs.dacard.ai/api-reference/outcomes/delete-outcome.md): Removes an outcome observation by ID. Only the owning account can delete.
- [List Outcome Observations](https://docs.dacard.ai/api-reference/outcomes/list-outcomes.md): Returns outcome observations for the authenticated user's products. Used by the longitudinal validation study (E2.2) to correlate score movements with real business outcomes.
- [Create a product](https://docs.dacard.ai/api-reference/products/create-a-product.md): Create a new product for the account. Products are unique by (account_id, url). Returns 409 if a product with the URL already exists.
- [Delete a product](https://docs.dacard.ai/api-reference/products/delete-a-product.md): Delete a product and all its scoring results.
- [Get a product](https://docs.dacard.ai/api-reference/products/get-a-product.md): Get product details with all scoring results. Scoped to the authenticated user's account.
- [List products](https://docs.dacard.ai/api-reference/products/list-products.md): List all products for the authenticated user's account.
- [Update a product](https://docs.dacard.ai/api-reference/products/update-a-product.md): Update product name or URL. At least one field required.
- [AI coaching chat](https://docs.dacard.ai/api-reference/scoring/ai-coaching-chat.md): Send messages to DAC (Dacard Agentic Coach) for context-aware AI coaching. Returns a Server-Sent Events stream. Optionally include a scoring result for context-aware conversation. Costs 1 credit per message.
- [Anonymous product score](https://docs.dacard.ai/api-reference/scoring/anonymous-product-score.md): Score a URL without authentication. Rate-limited to 1 score per IP per hour. Returns the full scoring result with an `isAnonymous` flag and a prompt to create an account to save the result.
- [F3 AI Product Assessment scoring](https://docs.dacard.ai/api-reference/scoring/f3-ai-product-assessment.md): Crawl a URL and produce an AI Product Assessment (F3 framework) across 27 dimensions. Evaluates how AI-native a product is, covering areas such as AI integration depth, personalization, automation, and intelligent workflows. Costs 10 credits. Subject to plan-based monthly quotas.
- [Generate a Signal Card](https://docs.dacard.ai/api-reference/scoring/generate-signal-card.md): Anonymous endpoint that accepts a self-reported IC Signal Assessment and returns a scored Signal Card with dimension breakdowns, a narrative, peer percentile, and a shareable link.
- [Get a scoring result](https://docs.dacard.ai/api-reference/scoring/get-a-scoring-result.md): Retrieve a scoring result by ID. This endpoint is public (no auth required) to support shareable result URLs.
- [Link anonymous score to account](https://docs.dacard.ai/api-reference/scoring/link-anonymous-score.md): After a user signs up or logs in, link a previously anonymous score result to their authenticated account. This is the PLG activation bridge: a visitor scores a product anonymously, then signs up and claims ownership of that result.
- [List score history](https://docs.dacard.ai/api-reference/scoring/list-score-history.md): List scoring history for the authenticated user. Free plan returns up to 9 results; Pro plan returns up to 100.
- [Public Quickscore](https://docs.dacard.ai/api-reference/scoring/quickscore-url.md): Public endpoint used by the homepage Quickscore form and the `/quickscore` page. No authentication required. Returns a synthesized maturity snapshot for any product URL.
- [Score a URL](https://docs.dacard.ai/api-reference/scoring/score-a-url.md): Crawl a URL (up to 6 pages) and produce an AI maturity assessment across 27 dimensions. Each dimension is scored 1-5 with evidence, confidence bands, and reasoning. Costs 1 credit. Subject to plan-based monthly quotas.
- [Get Notification Preferences](https://docs.dacard.ai/api-reference/settings/get-notifications.md): Returns all anomaly notification preferences for the authenticated user's account.
- [Update Notification Preferences](https://docs.dacard.ai/api-reference/settings/update-notifications.md): Creates or updates the notification preference for a given channel (email or Slack). When enabling Slack notifications, a valid Slack incoming webhook URL is required.
- [Health Check](https://docs.dacard.ai/api-reference/system/health-check.md): Enhanced health check endpoint that validates database connectivity, authentication configuration, billing integration, scoring engine availability, and required environment variables. Returns a status of "healthy" or "degraded" with per-component check results.
- [Complete onboarding](https://docs.dacard.ai/api-reference/user/complete-onboarding.md): Save user onboarding data (name, company, role, goals). Auto-provisions an account based on email domain. Syncs RBAC role to Clerk publicMetadata.
- [Get usage and quota](https://docs.dacard.ai/api-reference/user/get-usage-and-quota.md): Get current month's scoring usage, plan limits, and subscription status.
- [Get user preferences](https://docs.dacard.ai/api-reference/user/get-user-preferences.md): Retrieve the authenticated user's UI and notification preferences. Returns a JSON object with namespaced keys (e.g. `appearance`, `privacy`).
- [Update user preferences](https://docs.dacard.ai/api-reference/user/update-user-preferences.md): Merge incoming JSON into the user's existing preferences. Request body must be a JSON object (not array or primitive).
- [Create Webhook](https://docs.dacard.ai/api-reference/webhooks/create-webhook.md): Register a new outbound webhook endpoint. The response includes the signing secret; this is the only time the secret is returned in plain text. Store it securely and use it to verify webhook signatures.
- [GitHub Webhook Handler](https://docs.dacard.ai/api-reference/webhooks/github-webhook-handler.md)
- [Linear Webhook Handler](https://docs.dacard.ai/api-reference/webhooks/linear-webhook-handler.md)
- [List Webhooks](https://docs.dacard.ai/api-reference/webhooks/list-webhooks.md): List all outbound webhooks configured for the account. Signing secrets are never returned in list responses.
- [Authentication](https://docs.dacard.ai/authentication.md): How to authenticate with the Dacard.ai API
- [Product updates](https://docs.dacard.ai/changelog/product-updates.md): New features, improvements, and fixes to the Dacard.ai platform.
- [Scoring Frameworks](https://docs.dacard.ai/frameworks.md): The three original frameworks that power Dacard.ai scoring
- [Introduction](https://docs.dacard.ai/introduction.md): Decision intelligence platform for AI-native product teams
- [Agent Studio](https://docs.dacard.ai/knowledge-base/agent-studio.md): Configure and monitor autonomous AI agents that take real actions to improve your product maturity
- [Alerts](https://docs.dacard.ai/knowledge-base/alerts.md): Monitor intelligence signals and anomalies across your products in real time
- [API Quick Start](https://docs.dacard.ai/knowledge-base/api-quickstart.md): Score products programmatically using the Dacard.ai API
- [Audit Log](https://docs.dacard.ai/knowledge-base/audit-log.md): Security audit trail of key actions taken in your organization
- [Bring Your Own Model (BYOM)](https://docs.dacard.ai/knowledge-base/custom-llm.md): Configure a custom Anthropic API key for AI-powered features
- [DAC Copilot](https://docs.dacard.ai/knowledge-base/dac-copilot.md): Your AI product operations copilot for scoring, coaching, and strategic guidance
- [API Quick Start](https://docs.dacard.ai/knowledge-base/dev-api-quickstart.md): Score products programmatically using the Dacard.ai API
- [Diagnostic Report](https://docs.dacard.ai/knowledge-base/diagnostic.md): Unified F1, F2, and F3 analysis in a single five-tab cross-framework view
- [FAQ](https://docs.dacard.ai/knowledge-base/faq.md): Frequently asked questions about Dacard.ai
- [Score Your First Product in 60 Seconds](https://docs.dacard.ai/knowledge-base/first-score.md): Get your first AI maturity score and understand what it means
- [Score Your Product for Investor Conversations](https://docs.dacard.ai/knowledge-base/founder-first-score.md): Get investor-ready metrics and AI maturity positioning in minutes
- [Share Your Scorecard with Stakeholders](https://docs.dacard.ai/knowledge-base/founder-share.md): Generate shareable links, export reports, and present scores to investors and board members
- [Understand People, Process, and Product Tensions](https://docs.dacard.ai/knowledge-base/founder-tensions.md): How the three-framework tension map reveals your biggest growth constraints
- [Product Lifecycle Framework](https://docs.dacard.ai/knowledge-base/framework-lifecycle.md): The six stages of building AI-native products
- [F1 Product Operations Maturity Framework](https://docs.dacard.ai/knowledge-base/framework-maturity.md): Deep dive into the 27-dimension, 5-stage F1 assessment framework
- [F1 Product Operations Framework (Function View)](https://docs.dacard.ai/knowledge-base/framework-operations.md): How the six operational functions and 27 dimensions measure team AI-nativeness
- [POM Overlay](https://docs.dacard.ai/knowledge-base/framework-pom.md): Product Operating Model principles mapped to your AI maturity scores
- [Introduction to Dacard.ai](https://docs.dacard.ai/knowledge-base/getting-started.md): Decision intelligence for product teams. Measure, understand, and improve your AI maturity.
- [Get AI Coaching Recommendations](https://docs.dacard.ai/knowledge-base/ic-coaching.md): Use DAC to turn your scores into personalized improvement plans
- [Map Your Team's AI-Native Lifecycle](https://docs.dacard.ai/knowledge-base/ic-lifecycle-checklist.md): Complete the lifecycle assessment to understand where your team is in the AI-native build process
- [Run a Quick Self-Assessment](https://docs.dacard.ai/knowledge-base/ic-quick-assessment.md): Evaluate your team's AI maturity in minutes and get personalized recommendations
- [Understand Your Maturity Report](https://docs.dacard.ai/knowledge-base/ic-understand-report.md): A guide to reading your Dacard.ai scoring report and turning insights into action
- [Integrations & Sources](https://docs.dacard.ai/knowledge-base/integrations.md): Connect your tools to pull real signals into Dacard.ai scoring across all 27 dimensions
- [OAuth Integration Setup](https://docs.dacard.ai/knowledge-base/integrations-oauth.md): Step-by-step guides for connecting Jira, Slack, and Figma via OAuth
- [Intelligence ROI](https://docs.dacard.ai/knowledge-base/intelligence-roi.md): How Dacard.ai measures decision quality, tracks compound intelligence, and proves operational ROI
- [Set Up Automated Intelligence Agents](https://docs.dacard.ai/knowledge-base/leader-agents.md): Configure AI agents to monitor your products and generate strategic intelligence automatically
- [Benchmark Against Industry](https://docs.dacard.ai/knowledge-base/leader-benchmarks.md): Compare your product scores to industry peers by stage, size, and sector
- [Run a Full Diagnostic Across Frameworks](https://docs.dacard.ai/knowledge-base/leader-diagnostic.md): Combine all three frameworks for a complete organizational assessment
- [Track Your Product Portfolio](https://docs.dacard.ai/knowledge-base/leader-portfolio.md): Monitor maturity across all your products with portfolio analytics and suite intelligence
- [Set Up Team Scoring](https://docs.dacard.ai/knowledge-base/leader-team-scoring.md): Configure your organization, invite members, and establish collaborative scoring practices
- [MCP Integration](https://docs.dacard.ai/knowledge-base/mcp.md): Connect DAC to Claude, Cursor, and other MCP-compatible AI assistants
- [Plans & Billing](https://docs.dacard.ai/knowledge-base/plans-billing.md): Understanding Dacard.ai pricing plans, scores, and billing
- [Referrals](https://docs.dacard.ai/knowledge-base/referral.md): Invite colleagues and earn bonus credits when they sign up
- [Reports & Views](https://docs.dacard.ai/knowledge-base/reports.md): Understanding the different report types available for scored products
- [Roadmap](https://docs.dacard.ai/knowledge-base/roadmap.md): A function-level view of your team's active work pulled from connected project management tools
- [SCIM Provisioning](https://docs.dacard.ai/knowledge-base/scim.md): Automate user provisioning and deprovisioning from your identity provider
- [How Scoring Works](https://docs.dacard.ai/knowledge-base/scoring.md): Understanding Dacard.ai's 27-dimension AI maturity scoring methodology
- [Single Sign-On (SSO)](https://docs.dacard.ai/knowledge-base/sso.md): Configure SAML or OIDC SSO for your organization via Clerk
- [Team Scoring](https://docs.dacard.ai/knowledge-base/team-scoring.md): Create teams, invite members, and track composite product maturity scores
- [Three Frameworks Explained](https://docs.dacard.ai/knowledge-base/three-frameworks.md): How F1 Product Operations Maturity, F2 AI-Native Lifecycle, and F3 AI Product Assessment work together
- [Troubleshooting](https://docs.dacard.ai/knowledge-base/troubleshooting.md): Common issues and how to resolve them
- [Rate Limits & Quotas](https://docs.dacard.ai/rate-limits.md): Credit system, plan limits, and rate limiting
- [Roles & Permissions](https://docs.dacard.ai/rbac.md): Role-based access control in Dacard.ai
- [SDKs & Integrations](https://docs.dacard.ai/sdks.md): Client libraries, MCP server, and integration options
- [Webhooks](https://docs.dacard.ai/webhooks.md): Stripe webhook integration for subscription lifecycle events

## OpenAPI Specs

- [openapi](https://docs.dacard.ai/openapi.yaml)