# Zentrik External REST API Last reviewed: 2026-10-05 Workspace-scoped REST operations for Zentrik product context, discovery records, research, planning, and analytics. Use this index to select a resource. Use the resource Markdown for full request, response, scope, and example details. - Human reference: https://zentrik.ai/docs/api - Base URL: `https://zentrik.ai/api` - Authentication: `Authorization: Bearer YOUR_API_KEY` ## Shared conventions - Access boundary: REST API keys are workspace-wide integration principals. MCP connections use the signed-in person and current team memberships. - Pagination: Start with offset=0. Advance by X-Limit while X-Has-More is true. - Pagination headers: `X-Total-Count`, `X-Limit`, `X-Offset`, `X-Has-More` - Standard rate-limit policy: 10 requests per 1 seconds; 100 requests per 60 seconds; 1000 requests per 3600 seconds - Rate-limit headers: `RateLimit-Policy`, `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` - Retry rate-limited requests after the seconds in `Retry-After`. - Errors: Use the HTTP status as the primary contract. Fix validation and permission errors before retrying. Retry transient failures with bounded exponential backoff. ## Resources ### Workspace access Verify workspace access or provision a prospect workspace. - Human reference: https://zentrik.ai/docs/api/auth - Agent-readable Markdown: https://zentrik.ai/docs/api/auth.md - Endpoints: 2 - Operations: `get-auth-context`, `provision-workspace` ### Tasks Find sprint work, update tasks and attach pull requests. - Human reference: https://zentrik.ai/docs/api/tasks - Agent-readable Markdown: https://zentrik.ai/docs/api/tasks.md - Endpoints: 8 - Operations: `list-execution-tasks`, `get-execution-task`, `create-execution-task`, `update-execution-task`, `set-execution-task-status`, `list-task-pull-requests`, `attach-task-pull-request`, `detach-task-pull-request` ### Sprints Read team sprints and resolve the current sprint. - Human reference: https://zentrik.ai/docs/api/sprints - Agent-readable Markdown: https://zentrik.ai/docs/api/sprints.md - Endpoints: 3 - Operations: `list-execution-sprints`, `get-current-sprint`, `get-execution-sprint` ### Signal evidence Read exact evidence, create or correct claims and their connections, and mark delivered work as addressed. - Human reference: https://zentrik.ai/docs/api/signal-evidence - Agent-readable Markdown: https://zentrik.ai/docs/api/signal-evidence.md - Endpoints: 7 - Operations: `list-signal-evidence`, `get-signal-evidence`, `list-signal-evidence-links`, `update-signal-evidence`, `link-signal-evidence`, `unlink-signal-evidence`, `set-signal-evidence-resolution` ### Analytics Compute bounded workspace aggregates without downloading raw records. - Human reference: https://zentrik.ai/docs/api/analytics - Agent-readable Markdown: https://zentrik.ai/docs/api/analytics.md - Endpoints: 1 - Operations: `aggregate-entities-by-taxonomy` ### Signals Import and manage transcripts, tickets, reviews, and research evidence. - Human reference: https://zentrik.ai/docs/api/signals - Agent-readable Markdown: https://zentrik.ai/docs/api/signals.md - Endpoints: 12 - Operations: `list-signals`, `get-signal`, `create-signal`, `create-signal-evidence`, `update-signal`, `delete-signal`, `process-signal`, `preview-signal-source-revision`, `get-signal-source-text`, `revise-signal-source`, `get-signal-source-revision`, `process-signal-source-revision` ### Accounts Resolve customer organizations, people, activity, and external identities. - Human reference: https://zentrik.ai/docs/api/accounts - Agent-readable Markdown: https://zentrik.ai/docs/api/accounts.md - Endpoints: 27 - Operations: `list-people`, `create-person`, `update-person`, `delete-person`, `list-accounts`, `find-duplicate-accounts`, `get-account`, `create-account`, `update-account`, `delete-account`, `merge-accounts`, `get-account-company-context`, `set-account-parent`, `get-account-measures`, `upsert-account-measure`, `inspect-salesforce-account`, `apply-salesforce-account-import`, `preview-pendo-account-correction`, `apply-pendo-account-correction`, `retry-pendo-account-correction-processing`, `list-account-merge-operations`, `preview-account-merge-undo`, `undo-account-merge`, `list-account-contacts`, `create-account-contact`, `update-account-contact`, `delete-account-contact` ### Products Read and maintain product context, features, personas, and questions. - Human reference: https://zentrik.ai/docs/api/products - Agent-readable Markdown: https://zentrik.ai/docs/api/products.md - Endpoints: 18 - Operations: `list-products`, `get-product`, `create-product`, `update-product`, `delete-product`, `get-products-portfolio-summary`, `get-product-metrics`, `list-product-features`, `create-product-feature`, `update-product-feature`, `delete-product-feature`, `attach-product-feature-image`, `list-product-personas`, `create-product-persona`, `update-product-persona`, `delete-product-persona`, `list-product-questions`, `get-product-question` ### Initiatives Read Initiatives, then maintain lifecycle fields, team ownership, and generated documents. - Human reference: https://zentrik.ai/docs/api/initiatives - Agent-readable Markdown: https://zentrik.ai/docs/api/initiatives.md - Endpoints: 6 - Operations: `list-initiatives`, `get-initiative`, `list-initiative-teams`, `update-initiative`, `regenerate-initiative-document`, `get-initiative-document-regeneration` ### Research Review public research, add saved evidence, and manage updates. - Human reference: https://zentrik.ai/docs/api/research - Agent-readable Markdown: https://zentrik.ai/docs/api/research.md - Endpoints: 4 - Operations: `list-research`, `get-research`, `run-research`, `update-research` ### Studies Read Study responses, participant details, submission times, work context, and findings. - Human reference: https://zentrik.ai/docs/api/studies - Agent-readable Markdown: https://zentrik.ai/docs/api/studies.md - Endpoints: 8 - Operations: `list-studies`, `get-study`, `list-study-responses`, `update-study`, `link-study-context`, `unlink-study-context`, `get-study-evidence`, `generate-study-findings` ### Team Huddles Retrieve daily team history, saved snapshots, artifacts, and conversation transcripts. - Human reference: https://zentrik.ai/docs/api/huddles - Agent-readable Markdown: https://zentrik.ai/docs/api/huddles.md - Endpoints: 3 - Operations: `list-team-huddles`, `get-team-huddle`, `get-team-huddle-transcript` ### Feedback Reconcile rating events and calculate transparent fixed-window rollups. - Human reference: https://zentrik.ai/docs/api/feedback - Agent-readable Markdown: https://zentrik.ai/docs/api/feedback.md - Endpoints: 2 - Operations: `list-study-feedback`, `summarize-feedback` ### Insights Read and maintain evidence-backed customer and market learnings. - Human reference: https://zentrik.ai/docs/api/insights - Agent-readable Markdown: https://zentrik.ai/docs/api/insights.md - Endpoints: 6 - Operations: `list-insights`, `get-insight`, `create-insight`, `update-insight`, `delete-insight`, `ai-extract-insights` ### Opportunities Maintain evidence-backed product problems and opportunity records. - Human reference: https://zentrik.ai/docs/api/opportunities - Agent-readable Markdown: https://zentrik.ai/docs/api/opportunities.md - Endpoints: 5 - Operations: `list-opportunities`, `get-opportunity`, `create-opportunity`, `update-opportunity`, `delete-opportunity` ### Ideas Maintain solution candidates, questions, votes, and product links. - Human reference: https://zentrik.ai/docs/api/ideas - Agent-readable Markdown: https://zentrik.ai/docs/api/ideas.md - Endpoints: 10 - Operations: `get-idea-evidence`, `set-idea-status`, `list-ideas`, `get-idea`, `list-idea-questions`, `answer-idea-question`, `create-idea`, `update-idea`, `delete-idea`, `delete-idea-comment` ### Taxonomies Read, publish, and apply the workspace classification system. - Human reference: https://zentrik.ai/docs/api/taxonomies - Agent-readable Markdown: https://zentrik.ai/docs/api/taxonomies.md - Endpoints: 18 - Operations: `list-taxonomies`, `get-current-taxonomy`, `get-taxonomy`, `validate-taxonomy`, `create-taxonomy`, `update-taxonomy-draft`, `upsert-taxonomy-group`, `patch-taxonomy-group`, `delete-taxonomy-group`, `upsert-taxonomy-option`, `patch-taxonomy-option`, `delete-taxonomy-option`, `preview-taxonomy`, `impact-preview-taxonomy`, `publish-taxonomy`, `reclassify-taxonomy`, `get-classification-run`, `list-classification-queue` ### OKRs Read and maintain objectives and key results. - Human reference: https://zentrik.ai/docs/api/okrs - Agent-readable Markdown: https://zentrik.ai/docs/api/okrs.md - Endpoints: 5 - Operations: `list-okrs`, `get-okr`, `create-okr`, `update-okr`, `delete-okr` ### Context Units Maintain reusable, structured workspace context. - Human reference: https://zentrik.ai/docs/api/context-units - Agent-readable Markdown: https://zentrik.ai/docs/api/context-units.md - Endpoints: 5 - Operations: `list-context-units`, `get-context-unit`, `create-context-unit`, `update-context-unit`, `delete-context-unit` ### Context Documents Maintain long-form workspace context documents. - Human reference: https://zentrik.ai/docs/api/context-documents - Agent-readable Markdown: https://zentrik.ai/docs/api/context-documents.md - Endpoints: 7 - Operations: `list-context-documents`, `get-context-document`, `get-context-document-content`, `create-context-document`, `upload-context-document`, `update-context-document`, `delete-context-document`