# Okto Pulse Documentation

> Okto Pulse — open-source control plane for AI-assisted software development. Spec-driven, MCP-native, with a knowledge graph that survives delivery. Free, local-first.

## Docs

- [Create Agent](https://docs.oktolabs.ai/api-reference/agents/create-agent.md): Create a new global agent (not tied to any board).
- [Delete Agent](https://docs.oktolabs.ai/api-reference/agents/delete-agent.md): Delete an agent (owner only).
- [Get Agent](https://docs.oktolabs.ai/api-reference/agents/get-agent.md): Get an agent by ID (owner only).
- [Grant Board Access](https://docs.oktolabs.ai/api-reference/agents/grant-board-access.md): Grant an agent access to a board. Requires owning both the agent and the board.
- [List Agents For Board](https://docs.oktolabs.ai/api-reference/agents/list-agents-for-board.md): List all agents with access to a board.
- [List My Agents](https://docs.oktolabs.ai/api-reference/agents/list-my-agents.md): List all agents owned by the current user (with api_key).
- [Regenerate Agent Key](https://docs.oktolabs.ai/api-reference/agents/regenerate-agent-key.md): Regenerate an agent's API key (owner only).
- [Revoke Board Access](https://docs.oktolabs.ai/api-reference/agents/revoke-board-access.md): Revoke an agent's access to a board. Requires owning the agent or the board.
- [Update Agent](https://docs.oktolabs.ai/api-reference/agents/update-agent.md): Update an agent (owner only).
- [Update Board Overrides](https://docs.oktolabs.ai/api-reference/agents/update-board-overrides.md): Update permission overrides for an agent on a board (ceiling model).
- [Analytics Overview](https://docs.oktolabs.ai/api-reference/analytics/analytics-overview.md): Cross-board KPIs: totals, lifecycle status breakdowns, validation gates, sprint summary, funnel, velocity, board list.
- [Analytics Overview Export](https://docs.oktolabs.ai/api-reference/analytics/analytics-overview-export.md): Export cross-board overview KPIs as CSV.
- [Board Agents](https://docs.oktolabs.ai/api-reference/analytics/board-agents.md): Agent activity ranking with role-aware metrics.
- [Board Analytics Export](https://docs.oktolabs.ai/api-reference/analytics/board-analytics-export.md): Export board analytics (funnel, quality, velocity) as CSV.
- [Board Blockers](https://docs.oktolabs.ai/api-reference/analytics/board-blockers.md): Triage endpoint: every artifact blocking the funnel, classified by root cause so an agent can act directly instead of scanning each level.
- [Board Coverage](https://docs.oktolabs.ai/api-reference/analytics/board-coverage.md): Test coverage per spec: AC count, covered ACs, test scenario status counts.
- [Board Entities](https://docs.oktolabs.ai/api-reference/analytics/board-entities.md): Paginated entity list with relevant metrics. When search is provided, date filters are ignored to search the entire base.
- [Board Entity Detail](https://docs.oktolabs.ai/api-reference/analytics/board-entity-detail.md): Detailed analytics for a single entity.
- [Board Entity Detail Export](https://docs.oktolabs.ai/api-reference/analytics/board-entity-detail-export.md): Export entity detail analytics as CSV.
- [Board Funnel](https://docs.oktolabs.ai/api-reference/analytics/board-funnel.md): Funnel for a single board: ideations -> refinements -> specs -> cards -> done.
- [Board Quality](https://docs.oktolabs.ai/api-reference/analytics/board-quality.md): Quality scatters with dual sources: - conclusion_reported: self-reported from card.conclusions (implementer) - validation_reported: reviewer-reported from card.validations (validator)
- [Board Spec Analytics](https://docs.oktolabs.ai/api-reference/analytics/board-spec-analytics.md): Per-spec analytics: validation timeline, task gate summary, coverage.
- [Board Sprint Analytics](https://docs.oktolabs.ai/api-reference/analytics/board-sprint-analytics.md): Per-sprint analytics: kanban distribution, task gate, evaluation timeline.
- [Board Sprints Analytics](https://docs.oktolabs.ai/api-reference/analytics/board-sprints-analytics.md): Sprint panel for a board.
- [Board Validations](https://docs.oktolabs.ai/api-reference/analytics/board-validations.md): Validation Gate panel for a board.
- [Board Velocity](https://docs.oktolabs.ai/api-reference/analytics/board-velocity.md): Velocity stacked by impl/test/bug with validation_bounce + spec_done/sprint_done overlays. Supports week or day granularity.
- [Copy Architecture From Spec To Card](https://docs.oktolabs.ai/api-reference/architecture/copy-architecture-from-spec-to-card.md)
- [Create Card Architecture](https://docs.oktolabs.ai/api-reference/architecture/create-card-architecture.md)
- [Create Ideation Architecture](https://docs.oktolabs.ai/api-reference/architecture/create-ideation-architecture.md)
- [Create Refinement Architecture](https://docs.oktolabs.ai/api-reference/architecture/create-refinement-architecture.md)
- [Create Spec Architecture](https://docs.oktolabs.ai/api-reference/architecture/create-spec-architecture.md)
- [Delete Architecture Design](https://docs.oktolabs.ai/api-reference/architecture/delete-architecture-design.md)
- [Get Architecture Design](https://docs.oktolabs.ai/api-reference/architecture/get-architecture-design.md)
- [Get Architecture Diagram Payload](https://docs.oktolabs.ai/api-reference/architecture/get-architecture-diagram-payload.md)
- [Get Architecture Diff](https://docs.oktolabs.ai/api-reference/architecture/get-architecture-diff.md)
- [Import Excalidraw Architecture Diagram](https://docs.oktolabs.ai/api-reference/architecture/import-excalidraw-architecture-diagram.md)
- [List Card Architecture](https://docs.oktolabs.ai/api-reference/architecture/list-card-architecture.md)
- [List Ideation Architecture](https://docs.oktolabs.ai/api-reference/architecture/list-ideation-architecture.md)
- [List Refinement Architecture](https://docs.oktolabs.ai/api-reference/architecture/list-refinement-architecture.md)
- [List Spec Architecture](https://docs.oktolabs.ai/api-reference/architecture/list-spec-architecture.md)
- [Update Architecture Design](https://docs.oktolabs.ai/api-reference/architecture/update-architecture-design.md)
- [Update Architecture Diagram Payload](https://docs.oktolabs.ai/api-reference/architecture/update-architecture-diagram-payload.md)
- [Validate Architecture Payload](https://docs.oktolabs.ai/api-reference/architecture/validate-architecture-payload.md): Return the same Architecture Design critique exposed to MCP agents.
- [Delete Attachment](https://docs.oktolabs.ai/api-reference/attachments/delete-attachment.md): Delete an attachment.
- [Download Attachment](https://docs.oktolabs.ai/api-reference/attachments/download-attachment.md): Download an attachment.
- [Upload Attachment](https://docs.oktolabs.ai/api-reference/attachments/upload-attachment.md): Upload a file attachment to a card.
- [Archive Tree](https://docs.oktolabs.ai/api-reference/boards/archive-tree.md): Archive an entity and all its descendants in cascade.
- [Create Board](https://docs.oktolabs.ai/api-reference/boards/create-board.md): Create a new board.
- [Create Card](https://docs.oktolabs.ai/api-reference/boards/create-card.md): Create a new card in a board.
- [Delete Board](https://docs.oktolabs.ai/api-reference/boards/delete-board.md): Delete a board and all its cards.
- [Get Board](https://docs.oktolabs.ai/api-reference/boards/get-board.md): Get a board by ID with all cards and agents.
- [Get Board Columns](https://docs.oktolabs.ai/api-reference/boards/get-board-columns.md): Get board cards grouped by status/column.
- [List Board Shares](https://docs.oktolabs.ai/api-reference/boards/list-board-shares.md): List all shares for a board.
- [List Boards](https://docs.oktolabs.ai/api-reference/boards/list-boards.md): List boards for the current user. view: my|shared|all.
- [Restore Tree](https://docs.oktolabs.ai/api-reference/boards/restore-tree.md): Restore an archived entity and all its descendants.
- [Revoke Board Share](https://docs.oktolabs.ai/api-reference/boards/revoke-board-share.md): Revoke a share (owner/admin can revoke, shared user can leave).
- [Share Board](https://docs.oktolabs.ai/api-reference/boards/share-board.md): Share a board with another user (owner/admin only).
- [Update Board](https://docs.oktolabs.ai/api-reference/boards/update-board.md): Update a board.
- [Update Board Share](https://docs.oktolabs.ai/api-reference/boards/update-board-share.md): Update a share's permission (owner/admin only).
- [Add Dependency](https://docs.oktolabs.ai/api-reference/cards/add-dependency.md): Add a dependency: card_id depends on depends_on_id.
- [Create Card Knowledge](https://docs.oktolabs.ai/api-reference/cards/create-card-knowledge.md): Attach a KE to a card.
- [Delete Card](https://docs.oktolabs.ai/api-reference/cards/delete-card.md): Delete a card.
- [Delete Card Knowledge](https://docs.oktolabs.ai/api-reference/cards/delete-card-knowledge.md): Delete a KE from a card.
- [Delete Task Validation](https://docs.oktolabs.ai/api-reference/cards/delete-task-validation.md): Delete a validation entry.
- [Download Card Knowledge](https://docs.oktolabs.ai/api-reference/cards/download-card-knowledge.md): Download a KE as a plain markdown file with Content-Disposition attachment.
- [Get Card](https://docs.oktolabs.ai/api-reference/cards/get-card.md): Get a card by ID with all attachments, Q&A, and comments.
- [Get Card Activity](https://docs.oktolabs.ai/api-reference/cards/get-card-activity.md): Get activity log for a specific card.
- [Get Card Knowledge](https://docs.oktolabs.ai/api-reference/cards/get-card-knowledge.md): Get a single KE.
- [Get Card Seen Status](https://docs.oktolabs.ai/api-reference/cards/get-card-seen-status.md): Get seen status for all items in a card (comments, QA) by agents.
- [Get Dependencies](https://docs.oktolabs.ai/api-reference/cards/get-dependencies.md): Get cards this card depends on.
- [Get Dependents](https://docs.oktolabs.ai/api-reference/cards/get-dependents.md): Get cards that depend on this card.
- [Get Task Validation](https://docs.oktolabs.ai/api-reference/cards/get-task-validation.md): Get a single validation by ID.
- [Link Test Task To Bug](https://docs.oktolabs.ai/api-reference/cards/link-test-task-to-bug.md): Link a test task to a bug card. Validates same spec and new scenario.
- [List Card Knowledge](https://docs.oktolabs.ai/api-reference/cards/list-card-knowledge.md): List all KE attached to a card.
- [List Task Validations](https://docs.oktolabs.ai/api-reference/cards/list-task-validations.md): List all validations for a card (reverse chronological).
- [Move Card](https://docs.oktolabs.ai/api-reference/cards/move-card.md): Move a card to a different column/position.
- [Remove Dependency](https://docs.oktolabs.ai/api-reference/cards/remove-dependency.md): Remove a dependency.
- [Submit Task Validation](https://docs.oktolabs.ai/api-reference/cards/submit-task-validation.md): Submit a task validation for a card in 'validation' status.
- [Unlink Test Task From Bug](https://docs.oktolabs.ai/api-reference/cards/unlink-test-task-from-bug.md): Unlink a test task from a bug card.
- [Update Card](https://docs.oktolabs.ai/api-reference/cards/update-card.md): Update a card.
- [Update Card Knowledge](https://docs.oktolabs.ai/api-reference/cards/update-card-knowledge.md): Update a KE in place.
- [Create Comment](https://docs.oktolabs.ai/api-reference/comments/create-comment.md): Create a new comment on a card.
- [Delete Comment](https://docs.oktolabs.ai/api-reference/comments/delete-comment.md): Delete a comment.
- [Respond To Choice](https://docs.oktolabs.ai/api-reference/comments/respond-to-choice.md): Respond to a choice board comment.
- [Update Comment](https://docs.oktolabs.ai/api-reference/comments/update-comment.md): Update a comment.
- [Get Dead Letter](https://docs.oktolabs.ai/api-reference/dead-letter/get-dead-letter.md): List dead-lettered consolidation rows for a board.
- [Execute Discovery Intent](https://docs.oktolabs.ai/api-reference/discovery/execute-discovery-intent.md): Execute the real tool bound to an intent and return a normalized payload.
- [List Discovery Intents](https://docs.oktolabs.ai/api-reference/discovery/list-discovery-intents.md): Return the active catalog of user-facing Discovery intents.
- [List Saved Searches](https://docs.oktolabs.ai/api-reference/discovery/list-saved-searches.md): Return the saved searches for a board (shared with all members).
- [List Search History](https://docs.oktolabs.ai/api-reference/discovery/list-search-history.md): Return the current user's last 50 search entries on this board.
- [Create Guideline](https://docs.oktolabs.ai/api-reference/guidelines/create-guideline.md): Create a new guideline.
- [Delete Guideline](https://docs.oktolabs.ai/api-reference/guidelines/delete-guideline.md): Delete a guideline.
- [Get Board Guidelines](https://docs.oktolabs.ai/api-reference/guidelines/get-board-guidelines.md): Get all guidelines for a board (linked globals + inline), sorted by priority.
- [Get Guideline](https://docs.oktolabs.ai/api-reference/guidelines/get-guideline.md): Get a guideline by ID.
- [Link Or Create Board Guideline](https://docs.oktolabs.ai/api-reference/guidelines/link-or-create-board-guideline.md): Link an existing guideline to a board.
- [List Guidelines](https://docs.oktolabs.ai/api-reference/guidelines/list-guidelines.md): List global guidelines for the current user.
- [Unlink Board Guideline](https://docs.oktolabs.ai/api-reference/guidelines/unlink-board-guideline.md): Unlink a guideline from a board.
- [Update Board Guideline Priority](https://docs.oktolabs.ai/api-reference/guidelines/update-board-guideline-priority.md): Update the priority of a linked guideline on a board.
- [Update Guideline](https://docs.oktolabs.ai/api-reference/guidelines/update-guideline.md): Update a guideline.
- [Health Check](https://docs.oktolabs.ai/api-reference/health-check.md)
- [Answer Ideation Question](https://docs.oktolabs.ai/api-reference/ideations/answer-ideation-question.md): Answer an ideation Q&A question.
- [Create Ideation](https://docs.oktolabs.ai/api-reference/ideations/create-ideation.md): Create a new ideation in a board.
- [Create Ideation Question](https://docs.oktolabs.ai/api-reference/ideations/create-ideation-question.md): Ask a question on an ideation.
- [Delete Ideation](https://docs.oktolabs.ai/api-reference/ideations/delete-ideation.md): Delete an ideation.
- [Delete Ideation Question](https://docs.oktolabs.ai/api-reference/ideations/delete-ideation-question.md): Delete an ideation Q&A item.
- [Derive Spec](https://docs.oktolabs.ai/api-reference/ideations/derive-spec.md): Create a spec draft from a done ideation.
- [Evaluate Complexity](https://docs.oktolabs.ai/api-reference/ideations/evaluate-complexity.md): Evaluate ideation complexity. Accepts scores + justifications in body.
- [Get Ideation](https://docs.oktolabs.ai/api-reference/ideations/get-ideation.md): Get an ideation by ID with nested data.
- [Get Ideation Snapshot](https://docs.oktolabs.ai/api-reference/ideations/get-ideation-snapshot.md): Get a specific version snapshot of an ideation.
- [List Ideation History](https://docs.oktolabs.ai/api-reference/ideations/list-ideation-history.md): Get detailed change history for an ideation.
- [List Ideation Qa](https://docs.oktolabs.ai/api-reference/ideations/list-ideation-qa.md): List all Q&A items for an ideation.
- [List Ideation Snapshots](https://docs.oktolabs.ai/api-reference/ideations/list-ideation-snapshots.md): List all version snapshots for an ideation.
- [List Ideations](https://docs.oktolabs.ai/api-reference/ideations/list-ideations.md): List ideations for a board, optionally filtered by status.
- [Move Ideation](https://docs.oktolabs.ai/api-reference/ideations/move-ideation.md): Change ideation status.
- [Update Ideation](https://docs.oktolabs.ai/api-reference/ideations/update-ideation.md): Update an ideation. Bumps version when content fields change.
- [Get Kg Health Endpoint](https://docs.oktolabs.ai/api-reference/kg-health/get-kg-health-endpoint.md): Return the live KG health snapshot for ``board_id``.
- [Run Tick Now](https://docs.oktolabs.ai/api-reference/kg-tick/run-tick-now.md): Trigger the KG decay tick manually (idempotent — concurrent calls return 409 until the in-flight tick releases the advisory lock).
- [Boost Node](https://docs.oktolabs.ai/api-reference/knowledge-graph/boost-node.md): Increment a node's ``relevance_score`` by a fixed +0.3 with clamp [0, 1.5].
- [Cancel Historical Endpoint](https://docs.oktolabs.ai/api-reference/knowledge-graph/cancel-historical-endpoint.md): Cancel historical backfill.
- [Cypher Query](https://docs.oktolabs.ai/api-reference/knowledge-graph/cypher-query.md): Delegate to tier power query_cypher.
- [Delete Board Kg](https://docs.oktolabs.ai/api-reference/knowledge-graph/delete-board-kg.md): Wipe KG data for a board (right-to-erasure).
- [Export Audit](https://docs.oktolabs.ai/api-reference/knowledge-graph/export-audit.md): Streaming audit export as JSONL or CSV.
- [Find Contradictions](https://docs.oktolabs.ai/api-reference/knowledge-graph/find-contradictions.md): Find contradictions, optionally filtered by node_id.
- [Find Similar](https://docs.oktolabs.ai/api-reference/knowledge-graph/find-similar.md): Find similar decisions via semantic search.
- [Get Global Kg Settings](https://docs.oktolabs.ai/api-reference/knowledge-graph/get-global-kg-settings.md): Return process-global KG settings (no board context required).
- [Get Kg Metrics](https://docs.oktolabs.ai/api-reference/knowledge-graph/get-kg-metrics.md): Provenance metrics for the KG v0.2.0 pipeline — grouped by `layer`.
- [Get Node Detail](https://docs.oktolabs.ai/api-reference/knowledge-graph/get-node-detail.md): Get node detail across any node type in the board graph.
- [Get Settings](https://docs.oktolabs.ai/api-reference/knowledge-graph/get-settings.md): Get KG settings for a board.
- [Get Stats](https://docs.oktolabs.ai/api-reference/knowledge-graph/get-stats.md): Board KG stats: counts, confidence, pending.
- [Get Subgraph](https://docs.oktolabs.ai/api-reference/knowledge-graph/get-subgraph.md): Return subgraph for visualization — Spec 8 / S1.1, S1.4, S1.5.
- [Get Supersedence](https://docs.oktolabs.ai/api-reference/knowledge-graph/get-supersedence.md): Get supersedence chain for a decision node.
- [Global Search](https://docs.oktolabs.ai/api-reference/knowledge-graph/global-search.md): Cross-board global discovery search.
- [Historical Progress Endpoint](https://docs.oktolabs.ai/api-reference/knowledge-graph/historical-progress-endpoint.md): Historical consolidation progress.
- [List Audit](https://docs.oktolabs.ai/api-reference/knowledge-graph/list-audit.md): List consolidation audit entries.
- [List Nodes](https://docs.oktolabs.ai/api-reference/knowledge-graph/list-nodes.md): List KG nodes with filters and cursor pagination.
- [List Pending](https://docs.oktolabs.ai/api-reference/knowledge-graph/list-pending.md): List pending consolidation queue entries.
- [List Pending Tree](https://docs.oktolabs.ai/api-reference/knowledge-graph/list-pending-tree.md): Hierarchical pending-queue view (spec f33eb9ca — Layer 4 Pending Queue UI).
- [Openapi Spec](https://docs.oktolabs.ai/api-reference/knowledge-graph/openapi-spec.md): Auto-generated OpenAPI 3.1 spec.
- [Post Migrate Schema](https://docs.oktolabs.ai/api-reference/knowledge-graph/post-migrate-schema.md): Force-apply schema migrations for a board (idempotent).
- [Retry Pending Entry](https://docs.oktolabs.ai/api-reference/knowledge-graph/retry-pending-entry.md): Re-queue a failed/done ConsolidationQueue entry so the worker reprocesses it. `recursive=true` also re-enqueues descendants below the artifact in the Ideation→Refinement→Spec→Sprint→Card hierarchy.
- [Schema Info](https://docs.oktolabs.ai/api-reference/knowledge-graph/schema-info.md): Schema introspection.
- [Start Historical](https://docs.oktolabs.ai/api-reference/knowledge-graph/start-historical.md): Start historical backfill.
- [Stream Kg Events](https://docs.oktolabs.ai/api-reference/knowledge-graph/stream-kg-events.md): Server-Sent Events stream of `kg.session.committed` / `kg.board.cleared` events for the given board.
- [Undo Session](https://docs.oktolabs.ai/api-reference/knowledge-graph/undo-session.md): Undo a consolidation session.
- [Update Settings](https://docs.oktolabs.ai/api-reference/knowledge-graph/update-settings.md): Update KG settings for a board.
- [Get My Permissions](https://docs.oktolabs.ai/api-reference/me/get-my-permissions.md): Return the authenticated user's effective permission flags for a board.
- [Clone Preset](https://docs.oktolabs.ai/api-reference/presets/clone-preset.md): Clone an existing preset (built-in or custom) as a new custom preset.
- [Create Preset](https://docs.oktolabs.ai/api-reference/presets/create-preset.md): Create a custom preset.
- [Delete Preset](https://docs.oktolabs.ai/api-reference/presets/delete-preset.md): Delete a custom preset. Built-in presets cannot be deleted.
- [List Presets](https://docs.oktolabs.ai/api-reference/presets/list-presets.md): List all presets: built-in + custom owned by the user.
- [Update Preset](https://docs.oktolabs.ai/api-reference/presets/update-preset.md): Update a custom preset. Built-in presets cannot be modified.
- [Answer Question](https://docs.oktolabs.ai/api-reference/qa/answer-question.md): Answer a question.
- [Create Question](https://docs.oktolabs.ai/api-reference/qa/create-question.md): Create a new question on a card.
- [Delete Question](https://docs.oktolabs.ai/api-reference/qa/delete-question.md): Delete a Q&A item.
- [Get Kg Queue Health](https://docs.oktolabs.ai/api-reference/queue-health/get-kg-queue-health.md): Return the live snapshot of consolidation queue health.
- [Answer Refinement Question](https://docs.oktolabs.ai/api-reference/refinements/answer-refinement-question.md): Answer a refinement Q&A question.
- [Create Refinement](https://docs.oktolabs.ai/api-reference/refinements/create-refinement.md): Create a new refinement for a done ideation.
- [Create Refinement Knowledge](https://docs.oktolabs.ai/api-reference/refinements/create-refinement-knowledge.md): Create a knowledge base item on a refinement.
- [Create Refinement Question](https://docs.oktolabs.ai/api-reference/refinements/create-refinement-question.md): Ask a question on a refinement.
- [Delete Refinement](https://docs.oktolabs.ai/api-reference/refinements/delete-refinement.md): Delete a refinement.
- [Delete Refinement Knowledge](https://docs.oktolabs.ai/api-reference/refinements/delete-refinement-knowledge.md): Delete a knowledge base item from a refinement.
- [Delete Refinement Question](https://docs.oktolabs.ai/api-reference/refinements/delete-refinement-question.md): Delete a refinement Q&A item.
- [Derive Spec](https://docs.oktolabs.ai/api-reference/refinements/derive-spec.md): Derive a spec from a refinement.
- [Get Refinement](https://docs.oktolabs.ai/api-reference/refinements/get-refinement.md): Get a refinement by ID with nested data.
- [Get Refinement Knowledge](https://docs.oktolabs.ai/api-reference/refinements/get-refinement-knowledge.md): Get a knowledge base item with full content.
- [Get Refinement Snapshot](https://docs.oktolabs.ai/api-reference/refinements/get-refinement-snapshot.md): Get a specific version snapshot of a refinement.
- [List Refinement History](https://docs.oktolabs.ai/api-reference/refinements/list-refinement-history.md): Get detailed change history for a refinement.
- [List Refinement Knowledge](https://docs.oktolabs.ai/api-reference/refinements/list-refinement-knowledge.md): List all knowledge base items for a refinement.
- [List Refinement Qa](https://docs.oktolabs.ai/api-reference/refinements/list-refinement-qa.md): List all Q&A items for a refinement.
- [List Refinement Snapshots](https://docs.oktolabs.ai/api-reference/refinements/list-refinement-snapshots.md): List all version snapshots for a refinement.
- [List Refinements](https://docs.oktolabs.ai/api-reference/refinements/list-refinements.md): List refinements for an ideation, optionally filtered by status.
- [Move Refinement](https://docs.oktolabs.ai/api-reference/refinements/move-refinement.md): Change refinement status.
- [Update Refinement](https://docs.oktolabs.ai/api-reference/refinements/update-refinement.md): Update a refinement. Bumps version when content fields change.
- [Get Runtime](https://docs.oktolabs.ai/api-reference/settings/get-runtime.md): Return the currently effective runtime settings + restart flag.
- [Put Runtime](https://docs.oktolabs.ai/api-reference/settings/put-runtime.md): Persist new runtime settings. Values only take effect after restart.
- [Answer Spec Question](https://docs.oktolabs.ai/api-reference/specs/answer-spec-question.md): Answer a spec Q&A question.
- [Create Spec](https://docs.oktolabs.ai/api-reference/specs/create-spec.md): Create a new spec in a board.
- [Create Spec Knowledge](https://docs.oktolabs.ai/api-reference/specs/create-spec-knowledge.md): Add a knowledge base item to a spec.
- [Create Spec Question](https://docs.oktolabs.ai/api-reference/specs/create-spec-question.md): Ask a question on a spec.
- [Delete Spec](https://docs.oktolabs.ai/api-reference/specs/delete-spec.md): Delete a spec. Unlinks derived cards but doesn't delete them.
- [Delete Spec Knowledge](https://docs.oktolabs.ai/api-reference/specs/delete-spec-knowledge.md): Delete a knowledge base item.
- [Delete Spec Question](https://docs.oktolabs.ai/api-reference/specs/delete-spec-question.md): Delete a spec Q&A item.
- [Get Spec](https://docs.oktolabs.ai/api-reference/specs/get-spec.md): Get a spec by ID with its derived cards.
- [Get Spec Knowledge](https://docs.oktolabs.ai/api-reference/specs/get-spec-knowledge.md): Get a knowledge base item with full content.
- [Link Card To Spec](https://docs.oktolabs.ai/api-reference/specs/link-card-to-spec.md): Link an existing card to a spec.
- [Link Task To Scenario](https://docs.oktolabs.ai/api-reference/specs/link-task-to-scenario.md): Link a task card to a test scenario (bidirectional). Validates upfront that both scenario and card exist before mutating either side, so a typo in card_id no longer leaves an orphan link.
- [List Spec History](https://docs.oktolabs.ai/api-reference/specs/list-spec-history.md): Get detailed change history for a spec.
- [List Spec Knowledge](https://docs.oktolabs.ai/api-reference/specs/list-spec-knowledge.md): List all knowledge base items for a spec (without content).
- [List Spec Qa](https://docs.oktolabs.ai/api-reference/specs/list-spec-qa.md): List all Q&A items for a spec.
- [List Spec Validations](https://docs.oktolabs.ai/api-reference/specs/list-spec-validations.md): List all Spec Validation Gate records in reverse chronological order.
- [List Specs](https://docs.oktolabs.ai/api-reference/specs/list-specs.md): List specs for a board, optionally filtered by status.
- [Move Spec](https://docs.oktolabs.ai/api-reference/specs/move-spec.md): Change spec status.
- [Submit Spec Validation](https://docs.oktolabs.ai/api-reference/specs/submit-spec-validation.md): Submit a Spec Validation Gate record for a spec in 'approved' status.
- [Unlink Card From Spec](https://docs.oktolabs.ai/api-reference/specs/unlink-card-from-spec.md): Unlink a card from a spec.
- [Unlink Task From Scenario](https://docs.oktolabs.ai/api-reference/specs/unlink-task-from-scenario.md): Unlink a task card from a test scenario (bidirectional).
- [Update Spec](https://docs.oktolabs.ai/api-reference/specs/update-spec.md): Update a spec. Bumps version when content fields change. Rejects orphan `linked_*` references with 422 — see `_validate_spec_linked_refs` in services/main.py for the exact rules.
- [Assign Tasks](https://docs.oktolabs.ai/api-reference/sprints/assign-tasks.md): Assign cards to a sprint. Cards must belong to the same spec.
- [Create Sprint](https://docs.oktolabs.ai/api-reference/sprints/create-sprint.md): Create a new sprint for a spec.
- [Delete Sprint](https://docs.oktolabs.ai/api-reference/sprints/delete-sprint.md): Delete a sprint.
- [Get Sprint](https://docs.oktolabs.ai/api-reference/sprints/get-sprint.md): Get a sprint by ID with full details.
- [List Board Sprints](https://docs.oktolabs.ai/api-reference/sprints/list-board-sprints.md): List all sprints for a board, optionally filtered by status and/or spec.
- [List History](https://docs.oktolabs.ai/api-reference/sprints/list-history.md): List sprint history.
- [List Sprints](https://docs.oktolabs.ai/api-reference/sprints/list-sprints.md): List sprints for a spec.
- [Move Sprint](https://docs.oktolabs.ai/api-reference/sprints/move-sprint.md): Move a sprint to a different status.
- [Submit Evaluation](https://docs.oktolabs.ai/api-reference/sprints/submit-evaluation.md): Submit an evaluation for a sprint.
- [Suggest Sprints](https://docs.oktolabs.ai/api-reference/sprints/suggest-sprints.md): Suggest sprint breakdown for a spec.
- [Unassign Tasks](https://docs.oktolabs.ai/api-reference/sprints/unassign-tasks.md): Remove cards from a sprint (set sprint_id to null).
- [Update Sprint](https://docs.oktolabs.ai/api-reference/sprints/update-sprint.md): Update a sprint.
- [Get Lineage Graph](https://docs.oktolabs.ai/api-reference/traceability/get-lineage-graph.md): Return a UI-only SDLC lineage graph rooted at the selected entity.
- [Agents and permissions](https://docs.oktolabs.ai/concepts/agents.md): How Pulse agents, board roles, and granular permissions fit together.
- [Cards](https://docs.oktolabs.ai/concepts/card.md): The Pulse work unit: implementation, bug, and test cards with validation evidence.
- [Decisions](https://docs.oktolabs.ai/concepts/decisions.md): How Pulse records design choices and keeps their history queryable.
- [Ideation](https://docs.oktolabs.ai/concepts/ideation.md): How Pulse turns an early idea into a scored, refined input for specs.
- [Knowledge Graph](https://docs.oktolabs.ai/concepts/knowledge-graph.md): How Pulse persists decisions, constraints, and learnings across sessions, sprints, and agent changes — so the agent remembers what you decided, even after the chat ends.
- [The ADLC pipeline](https://docs.oktolabs.ai/concepts/pipeline.md): The six stages Pulse enforces: Ideation → Refinement → Spec → Sprint → Tasks → Validation.
- [Refinement](https://docs.oktolabs.ai/concepts/refinement.md): When and how to use Pulse refinement before a spec is locked.
- [The SDLC Pipeline](https://docs.oktolabs.ai/concepts/sdlc-flow.md): How Pulse moves work from raw idea to validated card — and why each gate exists
- [Spec](https://docs.oktolabs.ai/concepts/spec.md): The contract artifact that turns refined intent into gated implementation work.
- [Sprint](https://docs.oktolabs.ai/concepts/sprint.md): How Pulse groups spec-derived work into an executable sprint.
- [Validation gates](https://docs.oktolabs.ai/concepts/validation.md): The Pulse gates that keep specs, sprints, tests, and cards evidence-based.
- [Configuration overview](https://docs.oktolabs.ai/configuration.md): How Pulse reads server, MCP, storage, and Knowledge Graph settings.
- [Environment variables](https://docs.oktolabs.ai/configuration/environment-variables.md): Complete reference for every environment variable Pulse reads — server, storage, knowledge-graph runtime, MCP tracing, Docker-only — with defaults, ranges, and the field on CoreSettings each one maps to.
- [Server configuration](https://docs.oktolabs.ai/configuration/server-config.md): Tune the Pulse runtime: API and MCP ports, bind hosts, CORS, logging, and uvicorn workers. Single Python process, two listeners, defaults that work locally and in containers.
- [Storage paths](https://docs.oktolabs.ai/configuration/storage-paths.md): Where Pulse keeps its database, attachments, per-board knowledge graphs, and traces — plus how to relocate, back up, and migrate the data directory between machines.
- [Connect an agent](https://docs.oktolabs.ai/connect-agent.md): Connect Claude Code, Cursor, Cline, Windsurf, Goose, or Codex to your Pulse board via MCP — one command to generate the config, then start your agent.
- [Contributing](https://docs.oktolabs.ai/contributing.md): How to set up a development environment, run checks, and submit Pulse changes.
- [Your first board](https://docs.oktolabs.ai/first-board.md): Walk a feature from raw idea to validated card using the full Pulse pipeline — Ideation, Spec, Sprint, Tasks, and Validation.
- [Bug fix workflow](https://docs.oktolabs.ai/guides/bug-fix-flow.md): An end-to-end Pulse workflow for diagnosing, fixing, validating, and remembering a bug.
- [KG decision history](https://docs.oktolabs.ai/guides/kg-decisions.md): How to retrieve old architecture decisions before writing new work.
- [Multi-agent development](https://docs.oktolabs.ai/guides/multi-agent.md): How to run a Spec, Executor, and Validator team on one Pulse board.
- [Introduction](https://docs.oktolabs.ai/index.md): The control plane for AI-assisted software development.
- [Install](https://docs.oktolabs.ai/install.md): Get Okto Pulse running locally in under two minutes. Python 3.11+, no account required.
- [Docker](https://docs.oktolabs.ai/install/docker.md): Run Okto Pulse in a container. Signed image, pre-baked model, persistent volume. MCP server reachable from the host out of the box.
- [KG operations overview](https://docs.oktolabs.ai/kg-operations.md): Operational entry point for querying, consolidating, monitoring, repairing, and backfilling the Pulse Knowledge Graph.
- [Backfill and dedup](https://docs.oktolabs.ai/kg-operations/backfill.md): Populate the Knowledge Graph from existing artifacts and deduplicate entities.
- [Consolidation](https://docs.oktolabs.ai/kg-operations/consolidation.md): How Pulse turns specs, sprints, and cards into Knowledge Graph nodes and edges.
- [Dead-letter queue](https://docs.oktolabs.ai/kg-operations/dead-letter.md): Inspect and reprocess Knowledge Graph consolidation work that exhausted retries.
- [KG health and monitoring](https://docs.oktolabs.ai/kg-operations/health.md): Monitor queue depth, dead letters, last tick freshness, schema drift, and relevance distribution.
- [Querying the graph](https://docs.oktolabs.ai/kg-operations/querying.md): Practical Knowledge Graph query patterns for decisions, contradictions, natural search, and global context.
- [MCP setup](https://docs.oktolabs.ai/mcp-setup.md): Connect Claude Code, Cursor, Cline, Windsurf, Codex, or any MCP-compatible agent to your Pulse board.
- [Docker operations](https://docs.oktolabs.ai/operations/docker.md): Run, persist, debug, and upgrade Pulse in Docker.
- [Local development](https://docs.oktolabs.ai/operations/local.md): Run Pulse from source for local development and contribution work.
- [Portainer](https://docs.oktolabs.ai/operations/portainer.md): Operate the OktoPulse Docker stack from the Portainer host.
- [Upgrade](https://docs.oktolabs.ai/operations/upgrade.md): Upgrade Pulse without losing SQLite data, uploads, or Knowledge Graph files.
- [Board and profile flags](https://docs.oktolabs.ai/permissions/board.md): Board, profile, and guideline permissions every agent setup should understand.
- [Card and KG flags](https://docs.oktolabs.ai/permissions/card-kg.md): All granular flags for cards, task validation, traceability, comments, attachments, and Knowledge Graph access.
- [Custom permissions](https://docs.oktolabs.ai/permissions/custom.md): How to create narrow Pulse agents with explicit granular flags.
- [Ideation flags](https://docs.oktolabs.ai/permissions/ideation.md): All granular flags for ideation entities, state moves, Q&A, knowledge, mockups, architecture, and spec derivation.
- [Permission model](https://docs.oktolabs.ai/permissions/model.md): How Pulse resolves granular flags, board overrides, state checks, and legacy permissions.
- [Built-in presets](https://docs.oktolabs.ai/permissions/presets.md): Role boundaries for Full Control, Spec, Executor, QA, Validator, Reporter, and Sprint Manager.
- [Refinement flags](https://docs.oktolabs.ai/permissions/refinement.md): All granular flags for refinement entities, state moves, Q&A, knowledge, mockups, architecture, and spec derivation.
- [Spec flags](https://docs.oktolabs.ai/permissions/spec.md): All granular flags for spec content, gates, evidence, decisions, and card derivation.
- [Sprint flags](https://docs.oktolabs.ai/permissions/sprint.md): All granular flags for sprint entities, lifecycle moves, Q&A, evaluation, and history.
- [Quickstart](https://docs.oktolabs.ai/quickstart.md): From idea to your first validated card in 5 minutes
- [CLI Reference](https://docs.oktolabs.ai/reference/cli.md): Complete reference for all okto-pulse CLI commands, flags, exit codes, and expected output.
- [Entities and states](https://docs.oktolabs.ai/reference/entities.md): Reference map of Pulse domain entities, persisted records, status enums, and where each surface is exposed.
- [MCP reference](https://docs.oktolabs.ai/reference/mcp.md): Overview of all 198 Pulse MCP tools: authentication, transport, 8 domain categories, and the 20 most-used tools in daily AI-assisted development workflows.
- [MCP - analytics and activity](https://docs.oktolabs.ai/reference/mcp/analytics.md): Reference for board analytics, activity, traceability, unseen summaries, and mentions through MCP.
- [Architecture & mockups](https://docs.oktolabs.ai/reference/mcp/architecture-mockups.md): Reference for the 17 MCP tools that capture system architecture (entities, interfaces, diagrams) and screen mockups across ideations, refinements, specs, and cards — including the validate-then-write authoring loop and the spec-to-card propagation snapshots.
- [MCP — Board management](https://docs.oktolabs.ai/reference/mcp/board-management.md): Reference for the 17 MCP tools that manage boards, members, activity, mentions, and guidelines. Of the 198 Pulse MCP tools, these are the first your agent should call at the start of every session.
- [Comments & questions](https://docs.oktolabs.ai/reference/mcp/comments-questions.md): Reference for the 29 MCP tools that capture structured Q&A and free-form comments across cards, ideations, refinements, specs, and sprints — including the choice-question pattern that powers Pulse's ambiguity-killer protocol.
- [Ideation & refinement](https://docs.oktolabs.ai/reference/mcp/ideation-refinement.md): Reference for the 23 MCP tools that drive the first two ADLC stages — capturing a raw idea, killing scope ambiguity with a structured Q&A, optionally running a deep-investigation refinement, and deriving a spec contract.
- [Archive & retention](https://docs.oktolabs.ai/reference/mcp/kg/archive.md): Reference for the 2 cascading entity-archive Pulse MCP tools (archive_tree, restore_tree), how archival interacts with the Knowledge Graph, and the KG's retention model — supersedence as soft-archive, decay tick, dead-letter TTL, and audit-row immutability.
- [Knowledge Graph consolidation](https://docs.oktolabs.ai/reference/mcp/kg/consolidation.md): Reference for the 7 transactional Pulse MCP tools that write to the Knowledge Graph: open a session, propose nodes and edges, reconcile against existing graph state, and atomically commit. Covers content-hash dedup, agent-allowed edge types, the ADD/UPDATE/SUPERSEDE/NOOP reconciliation hints, and pe…
- [Knowledge Graph health & migration](https://docs.oktolabs.ai/reference/mcp/kg/health.md): Reference for the 5 admin Pulse MCP tools that operate the KG consolidation pipeline: kg_health, dead-letter list & reprocess, decay tick, and schema migration. Plus the okto-pulse verify-pipeline / kg backfill / kg dedup-entities CLI fallbacks and the underlying REST endpoints.
- [Knowledge Graph operations — overview](https://docs.oktolabs.ai/reference/mcp/kg/overview.md): Reference for the 26 MCP tools that operate the Pulse Knowledge Graph: schema v0.3.3, the ladybug embedded graph store, and the four tool tiers (consolidation, query, power, admin).
- [Knowledge Graph queries](https://docs.oktolabs.ai/reference/mcp/kg/queries.md): Reference for the 14 read-only Pulse MCP tools that query the Knowledge Graph: 9 typed primary tools (decision history, related context, contradictions, supersedence, alternatives, learning, global) plus 5 power tools (Cypher, natural language, schema, grounding, reflective).
- [Knowledge & attachments](https://docs.oktolabs.ai/reference/mcp/knowledge-attachments.md): Reference for the 21 MCP tools that attach knowledge base entries and binary file attachments to ideations, refinements, specs, and cards — including the host-side file_path / file_url loaders that keep large documents out of LLM context.
- [Specs](https://docs.oktolabs.ai/reference/mcp/specs.md): Reference for the 24 MCP tools that build the spec contract — lifecycle, acceptance criteria, business rules, test scenarios, decisions, API contracts, and the task-traceability links that bind cards back to spec content.
- [Sprints & cards](https://docs.oktolabs.ai/reference/mcp/sprints-cards.md): Reference for the 26 MCP tools that turn a validated spec into reviewable execution: sprint scope and evaluation, card lifecycle, dependencies, blockers, traceability, and board analytics.
- [Validation gates](https://docs.oktolabs.ai/reference/mcp/validation.md): Reference for the 10 MCP tools that enforce Pulse's three quality gates — spec evaluation, spec validation, task validation — plus the test theater anti-pattern enforcement that keeps test_scenario.status honest.
- [REST API](https://docs.oktolabs.ai/reference/rest-api.md): Pulse exposes the same surface as its MCP tools over HTTP. OpenAPI is available from the running Pulse process and as the static docs schema — this page covers authentication, the major route clusters, and curated examples for the most common workflows.
- [REST route catalog](https://docs.oktolabs.ai/reference/rest-api-catalog.md): Source-derived catalog of every REST route exposed by okto-pulse-core and the community runtime.
- [UI workflow map](https://docs.oktolabs.ai/reference/ui-workflows.md): Map of the bundled Pulse web app screens, tabs, modals, and the backend surfaces they exercise.
- [Troubleshooting](https://docs.oktolabs.ai/troubleshooting.md): Symptom-first fixes for MCP, Docker, search, permissions, KG health, and local startup issues.

## OpenAPI Specs

- [openapi](https://docs.oktolabs.ai/openapi.json)