# Zentrik External REST API

Last reviewed: 2026-09-03

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

### 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: 6
- Operations: `list-signals`, `get-signal`, `create-signal`, `update-signal`, `delete-signal`, `process-signal`

### 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: 15
- Operations: `list-people`, `create-person`, `update-person`, `delete-person`, `list-accounts`, `find-duplicate-accounts`, `get-account`, `create-account`, `update-account`, `delete-account`, `merge-accounts`, `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`

### Studies

Inspect Study formats, accepted context, privacy-bounded findings, and freshness.

- Human reference: https://zentrik.ai/docs/api/studies
- Agent-readable Markdown: https://zentrik.ai/docs/api/studies.md
- Endpoints: 4
- Operations: `list-studies`, `get-study`, `get-study-evidence`, `generate-study-findings`

### 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: 8
- Operations: `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`