From a3b7c5cd35ea642a4914ecb533980c4bde1d6106 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Mon, 29 Jun 2026 16:19:26 +0000
Subject: [PATCH] docs: apply SEO and metadata best practices across docs
---
ai/agent-comments.mdx | 2 +-
ai/approval-engine/customize-behavior.mdx | 4 ++--
ai/approval-engine/overview.mdx | 2 +-
ai/approval-engine/setup.mdx | 4 ++--
ai/chat-sdk-adapter.mdx | 2 +-
ai/memory/setup.mdx | 4 ++--
ai/rewriter/customize-behavior.mdx | 3 ++-
ai/rewriter/overview.mdx | 2 +-
ai/rewriter/setup.mdx | 3 ++-
api-reference/rest-apis/v1/auth/generate-token.mdx | 3 ++-
.../comment-annotations/add-comment-annotations.mdx | 3 ++-
.../comment-annotations/delete-comment-annotations.mdx | 3 ++-
.../comment-annotations/get-comment-annotations-count.mdx | 3 ++-
.../comment-annotations/get-comment-annotations.mdx | 3 ++-
.../comment-annotations/update-comment-annotations.mdx | 3 ++-
.../rest-apis/v1/comments-feature/comments/add-comments.mdx | 3 ++-
.../v1/comments-feature/comments/delete-comments.mdx | 3 ++-
.../rest-apis/v1/comments-feature/comments/get-comments.mdx | 3 ++-
.../v1/comments-feature/comments/update-comments.mdx | 3 ++-
api-reference/rest-apis/v1/documents/add-documents.mdx | 3 ++-
api-reference/rest-apis/v1/documents/delete-documents.mdx | 3 ++-
api-reference/rest-apis/v1/documents/get-documents.mdx | 3 ++-
api-reference/rest-apis/v1/documents/move-documents.mdx | 3 ++-
.../rest-apis/v1/documents/update-document-access.mdx | 3 ++-
.../rest-apis/v1/documents/update-document-disable-state.mdx | 3 ++-
api-reference/rest-apis/v1/documents/update-documents.mdx | 3 ++-
api-reference/rest-apis/v1/folders/add-folder.mdx | 3 ++-
api-reference/rest-apis/v1/folders/get-folders.mdx | 3 ++-
api-reference/rest-apis/v1/folders/update-folder-access.mdx | 3 ++-
api-reference/rest-apis/v1/folders/update-folder.mdx | 3 ++-
.../rest-apis/v1/gdpr/delete-all-user-data-gdpr.mdx | 4 ++--
api-reference/rest-apis/v1/gdpr/get-all-user-data-gdpr.mdx | 4 ++--
.../rest-apis/v1/gdpr/get-delete-user-data-status-gdpr.mdx | 4 ++--
api-reference/rest-apis/v1/livestate/broadcast-event.mdx | 3 ++-
.../rest-apis/v1/locations/delete-data-by-location.mdx | 4 ++--
api-reference/rest-apis/v1/locations/update-location.mdx | 4 ++--
.../rest-apis/v1/notifications/add-notifications.mdx | 3 ++-
.../rest-apis/v1/notifications/delete-notifications.mdx | 3 ++-
api-reference/rest-apis/v1/notifications/get-config.mdx | 3 ++-
.../rest-apis/v1/notifications/get-notifications.mdx | 3 ++-
api-reference/rest-apis/v1/notifications/set-config.mdx | 3 ++-
.../rest-apis/v1/notifications/update-notifications.mdx | 3 ++-
.../rest-apis/v1/organizations/add-organizations.mdx | 3 ++-
.../rest-apis/v1/organizations/delete-organizations.mdx | 3 ++-
.../rest-apis/v1/organizations/get-organizations.mdx | 3 ++-
.../v1/organizations/update-organization-disable-state.mdx | 3 ++-
.../rest-apis/v1/organizations/update-organizations.mdx | 3 ++-
api-reference/rest-apis/v1/user-groups/add-groups.mdx | 3 ++-
.../rest-apis/v1/user-groups/add-users-to-group.mdx | 3 ++-
.../rest-apis/v1/user-groups/delete-users-from-group.mdx | 3 ++-
api-reference/rest-apis/v1/users/add-users.mdx | 3 ++-
api-reference/rest-apis/v1/users/delete-users.mdx | 4 ++--
api-reference/rest-apis/v1/users/get-users.mdx | 3 ++-
api-reference/rest-apis/v1/users/update-users.mdx | 3 ++-
api-reference/rest-apis/v1/workspace/add-domain.mdx | 3 ++-
api-reference/rest-apis/v1/workspace/delete-domain.mdx | 3 ++-
api-reference/rest-apis/v2/activities/add-activities.mdx | 3 ++-
api-reference/rest-apis/v2/activities/delete-activities.mdx | 3 ++-
api-reference/rest-apis/v2/activities/get-activities.mdx | 3 ++-
api-reference/rest-apis/v2/activities/update-activities.mdx | 3 ++-
api-reference/rest-apis/v2/agents/list-agent-executions.mdx | 3 ++-
.../v2/approval-engine/definitions/create-definition.mdx | 3 ++-
.../v2/approval-engine/definitions/delete-definition.mdx | 3 ++-
.../v2/approval-engine/definitions/get-definition.mdx | 3 ++-
.../v2/approval-engine/definitions/list-definitions.mdx | 3 ++-
.../v2/approval-engine/definitions/update-definition.mdx | 3 ++-
.../v2/approval-engine/executions/cancel-execution.mdx | 3 ++-
.../v2/approval-engine/executions/dispatch-execution.mdx | 3 ++-
.../v2/approval-engine/executions/get-execution-events.mdx | 3 ++-
.../v2/approval-engine/executions/get-execution.mdx | 3 ++-
.../v2/approval-engine/executions/list-executions.mdx | 3 ++-
.../rest-apis/v2/approval-engine/steps/cancel-step.mdx | 3 ++-
.../v2/approval-engine/steps/record-agent-resolution.mdx | 3 ++-
.../v2/approval-engine/steps/record-reviewer-decision.mdx | 3 ++-
.../rest-apis/v2/approval-engine/steps/resolve-step.mdx | 3 ++-
api-reference/rest-apis/v2/auth/add-permissions.mdx | 3 ++-
api-reference/rest-apis/v2/auth/generate-signature.mdx | 3 ++-
api-reference/rest-apis/v2/auth/generate-token.mdx | 3 ++-
api-reference/rest-apis/v2/auth/get-permissions.mdx | 3 ++-
api-reference/rest-apis/v2/auth/remove-permissions.mdx | 3 ++-
.../comment-annotations/add-comment-annotations.mdx | 3 ++-
.../comment-annotations/delete-comment-annotations.mdx | 3 ++-
.../comment-annotations/get-comment-annotations-count.mdx | 3 ++-
.../comment-annotations/get-comment-annotations-v2.mdx | 3 ++-
.../comment-annotations/update-comment-annotations.mdx | 3 ++-
.../rest-apis/v2/comments-feature/comments/add-comments.mdx | 3 ++-
.../v2/comments-feature/comments/delete-comments.mdx | 3 ++-
.../rest-apis/v2/comments-feature/comments/get-comments.mdx | 3 ++-
.../v2/comments-feature/comments/update-comments.mdx | 3 ++-
api-reference/rest-apis/v2/crdt/add-crdt-data.mdx | 3 ++-
api-reference/rest-apis/v2/crdt/get-crdt-data.mdx | 3 ++-
api-reference/rest-apis/v2/crdt/update-crdt-data.mdx | 3 ++-
api-reference/rest-apis/v2/documents/add-documents.mdx | 3 ++-
api-reference/rest-apis/v2/documents/delete-documents.mdx | 3 ++-
api-reference/rest-apis/v2/documents/get-documents-v2.mdx | 3 ++-
.../rest-apis/v2/documents/migrate-documents-status.mdx | 3 ++-
api-reference/rest-apis/v2/documents/migrate-documents.mdx | 3 ++-
api-reference/rest-apis/v2/documents/move-documents.mdx | 3 ++-
.../rest-apis/v2/documents/update-document-access.mdx | 3 ++-
.../rest-apis/v2/documents/update-document-disable-state.mdx | 3 ++-
api-reference/rest-apis/v2/documents/update-documents.mdx | 3 ++-
api-reference/rest-apis/v2/folders/add-folder.mdx | 3 ++-
api-reference/rest-apis/v2/folders/delete-folder.mdx | 3 ++-
api-reference/rest-apis/v2/folders/get-folders.mdx | 3 ++-
api-reference/rest-apis/v2/folders/update-folder-access.mdx | 3 ++-
api-reference/rest-apis/v2/folders/update-folder.mdx | 3 ++-
.../rest-apis/v2/gdpr/delete-all-user-data-gdpr.mdx | 4 ++--
api-reference/rest-apis/v2/gdpr/get-all-user-data-gdpr.mdx | 4 ++--
.../rest-apis/v2/gdpr/get-delete-user-data-status-gdpr.mdx | 4 ++--
api-reference/rest-apis/v2/livestate/broadcast-event.mdx | 3 ++-
api-reference/rest-apis/v2/memory/alerts/action.mdx | 3 ++-
api-reference/rest-apis/v2/memory/alerts/config/get.mdx | 3 ++-
api-reference/rest-apis/v2/memory/alerts/config/update.mdx | 3 ++-
api-reference/rest-apis/v2/memory/alerts/dismiss.mdx | 3 ++-
api-reference/rest-apis/v2/memory/alerts/list.mdx | 3 ++-
api-reference/rest-apis/v2/memory/ask.mdx | 3 ++-
api-reference/rest-apis/v2/memory/judgments/query.mdx | 3 ++-
api-reference/rest-apis/v2/memory/knowledge/delete.mdx | 3 ++-
api-reference/rest-apis/v2/memory/knowledge/download.mdx | 3 ++-
.../rest-apis/v2/memory/knowledge/ingest-status.mdx | 3 ++-
api-reference/rest-apis/v2/memory/knowledge/ingest.mdx | 3 ++-
api-reference/rest-apis/v2/memory/knowledge/list.mdx | 1 +
api-reference/rest-apis/v2/memory/knowledge/rules.mdx | 1 +
api-reference/rest-apis/v2/memory/knowledge/search.mdx | 1 +
api-reference/rest-apis/v2/memory/knowledge/update.mdx | 3 ++-
api-reference/rest-apis/v2/memory/knowledge/upload-url.mdx | 3 ++-
api-reference/rest-apis/v2/memory/patterns/get.mdx | 3 ++-
api-reference/rest-apis/v2/memory/profiles/get.mdx | 1 +
api-reference/rest-apis/v2/memory/search.mdx | 1 +
api-reference/rest-apis/v2/memory/stats/get.mdx | 3 ++-
api-reference/rest-apis/v2/memory/suggest.mdx | 1 +
.../rest-apis/v2/notifications/add-notifications.mdx | 1 +
.../rest-apis/v2/notifications/delete-notifications.mdx | 1 +
api-reference/rest-apis/v2/notifications/get-config.mdx | 3 ++-
.../rest-apis/v2/notifications/get-notifications-v2.mdx | 1 +
api-reference/rest-apis/v2/notifications/set-config.mdx | 3 ++-
.../rest-apis/v2/notifications/update-notifications.mdx | 1 +
.../rest-apis/v2/organizations/add-organizations.mdx | 1 +
.../rest-apis/v2/organizations/delete-organizations.mdx | 1 +
.../rest-apis/v2/organizations/get-organizations-v2.mdx | 1 +
.../v2/organizations/update-organization-disable-state.mdx | 3 ++-
.../rest-apis/v2/organizations/update-organizations.mdx | 1 +
api-reference/rest-apis/v2/presence/add-presence.mdx | 1 +
api-reference/rest-apis/v2/presence/delete-presence.mdx | 1 +
api-reference/rest-apis/v2/presence/update-presence.mdx | 1 +
api-reference/rest-apis/v2/recordings/get-recordings.mdx | 1 +
api-reference/rest-apis/v2/rewriter/ask-ai.mdx | 3 ++-
api-reference/rest-apis/v2/user-groups/add-groups.mdx | 1 +
.../rest-apis/v2/user-groups/add-users-to-group.mdx | 1 +
.../rest-apis/v2/user-groups/delete-users-from-group.mdx | 1 +
api-reference/rest-apis/v2/users/add-users.mdx | 1 +
api-reference/rest-apis/v2/users/delete-users.mdx | 2 +-
api-reference/rest-apis/v2/users/get-users-v2.mdx | 1 +
api-reference/rest-apis/v2/users/update-users.mdx | 1 +
api-reference/rest-apis/v2/workspace/activityconfig-get.mdx | 1 +
.../rest-apis/v2/workspace/activityconfig-update.mdx | 1 +
api-reference/rest-apis/v2/workspace/add-domain.mdx | 3 ++-
.../v2/workspace/advancedwebhook-endpoints-create.mdx | 1 +
.../v2/workspace/advancedwebhook-endpoints-delete.mdx | 1 +
.../rest-apis/v2/workspace/advancedwebhook-endpoints-get.mdx | 1 +
.../v2/workspace/advancedwebhook-endpoints-secret-get.mdx | 1 +
.../v2/workspace/advancedwebhook-endpoints-update.mdx | 1 +
.../rest-apis/v2/workspace/advancedwebhookconfig-get.mdx | 1 +
.../rest-apis/v2/workspace/advancedwebhookconfig-update.mdx | 1 +
api-reference/rest-apis/v2/workspace/apikey-create.mdx | 1 +
api-reference/rest-apis/v2/workspace/apikey-update.mdx | 1 +
api-reference/rest-apis/v2/workspace/apikeyconfig-get.mdx | 1 +
api-reference/rest-apis/v2/workspace/apikeyconfig-update.mdx | 1 +
api-reference/rest-apis/v2/workspace/apikeys-get.mdx | 1 +
api-reference/rest-apis/v2/workspace/authtoken-reset.mdx | 1 +
api-reference/rest-apis/v2/workspace/authtokens-get.mdx | 1 +
api-reference/rest-apis/v2/workspace/create.mdx | 1 +
api-reference/rest-apis/v2/workspace/delete-domain.mdx | 3 ++-
api-reference/rest-apis/v2/workspace/domains-get.mdx | 3 ++-
api-reference/rest-apis/v2/workspace/email-status.mdx | 1 +
api-reference/rest-apis/v2/workspace/emailconfig-get.mdx | 1 +
api-reference/rest-apis/v2/workspace/emailconfig-update.mdx | 1 +
api-reference/rest-apis/v2/workspace/get.mdx | 1 +
.../rest-apis/v2/workspace/notificationconfig-get.mdx | 1 +
.../rest-apis/v2/workspace/notificationconfig-update.mdx | 1 +
.../rest-apis/v2/workspace/permissionproviderconfig-get.mdx | 1 +
.../v2/workspace/permissionproviderconfig-update.mdx | 1 +
api-reference/rest-apis/v2/workspace/send-login-link.mdx | 1 +
api-reference/rest-apis/v2/workspace/webhookconfig-get.mdx | 1 +
.../rest-apis/v2/workspace/webhookconfig-update.mdx | 1 +
api-reference/sdk/api/api-methods.mdx | 3 ++-
api-reference/sdk/api/react-hooks.mdx | 1 +
api-reference/sdk/models/data-models.mdx | 5 +++++
async-collaboration/activity/customize-behavior.mdx | 3 ++-
async-collaboration/activity/overview.mdx | 1 +
async-collaboration/activity/setup.mdx | 3 ++-
async-collaboration/arrows/customize-behavior.mdx | 3 ++-
async-collaboration/arrows/overview.mdx | 1 +
async-collaboration/arrows/setup.mdx | 3 ++-
async-collaboration/comments-sidebar/overview.mdx | 2 +-
.../comments-sidebar/v1/customize-behavior.mdx | 3 ++-
async-collaboration/comments-sidebar/v1/setup.mdx | 3 ++-
.../comments-sidebar/v2/customize-behavior.mdx | 3 ++-
async-collaboration/comments-sidebar/v2/setup.mdx | 3 ++-
async-collaboration/comments/customize-behavior.mdx | 3 ++-
async-collaboration/comments/notifications.mdx | 2 +-
async-collaboration/comments/overview.mdx | 2 +-
async-collaboration/comments/setup/ace.mdx | 3 ++-
async-collaboration/comments/setup/apryse.mdx | 3 ++-
.../comments/setup/canvas-comments/overview.mdx | 3 ++-
async-collaboration/comments/setup/canvas.mdx | 4 ++--
.../comments/setup/chart-comments-setup/chartjs.mdx | 3 ++-
.../comments/setup/chart-comments-setup/custom-charts.mdx | 3 ++-
.../comments/setup/chart-comments-setup/highcharts.mdx | 3 ++-
.../comments/setup/chart-comments-setup/nivo-charts.mdx | 3 ++-
async-collaboration/comments/setup/ckeditor.mdx | 2 +-
async-collaboration/comments/setup/codemirror.mdx | 3 ++-
async-collaboration/comments/setup/draftjs.mdx | 3 ++-
async-collaboration/comments/setup/freestyle.mdx | 3 ++-
async-collaboration/comments/setup/inline-comments.mdx | 3 ++-
async-collaboration/comments/setup/lexical.mdx | 3 ++-
async-collaboration/comments/setup/lottie-player-setup.mdx | 3 ++-
async-collaboration/comments/setup/monaco.mdx | 2 +-
async-collaboration/comments/setup/nutrient.mdx | 2 +-
async-collaboration/comments/setup/page.mdx | 3 ++-
async-collaboration/comments/setup/plate.mdx | 3 ++-
async-collaboration/comments/setup/popover.mdx | 3 ++-
async-collaboration/comments/setup/prosemirror.mdx | 3 ++-
async-collaboration/comments/setup/quill.mdx | 3 ++-
async-collaboration/comments/setup/slatejs.mdx | 3 ++-
async-collaboration/comments/setup/spreadjs.mdx | 2 +-
async-collaboration/comments/setup/stream.mdx | 3 ++-
async-collaboration/comments/setup/superdoc.mdx | 3 ++-
async-collaboration/comments/setup/text.mdx | 3 ++-
async-collaboration/comments/setup/tinymce.mdx | 2 +-
async-collaboration/comments/setup/tiptap.mdx | 3 ++-
.../setup/video-player-setup/custom-video-player-setup.mdx | 4 ++--
.../comments/setup/video-player-setup/video-player-setup.mdx | 4 ++--
.../comment-composer/customize-behavior.mdx | 3 ++-
.../standalone-components/comment-composer/overview.mdx | 3 ++-
.../standalone-components/comment-composer/setup.mdx | 3 ++-
.../standalone-components/comment-pin/customize-behavior.mdx | 3 ++-
.../comments/standalone-components/comment-pin/overview.mdx | 1 +
.../comments/standalone-components/comment-pin/setup.mdx | 3 ++-
.../comment-thread/customize-behavior.mdx | 3 ++-
.../standalone-components/comment-thread/overview.mdx | 1 +
.../comments/standalone-components/comment-thread/setup.mdx | 3 ++-
async-collaboration/notifications/customize-behavior.mdx | 3 ++-
async-collaboration/notifications/overview.mdx | 3 ++-
async-collaboration/notifications/setup.mdx | 3 ++-
async-collaboration/reactions/customize-behavior.mdx | 3 ++-
async-collaboration/reactions/overview.mdx | 3 ++-
async-collaboration/reactions/setup.mdx | 3 ++-
async-collaboration/recorder/customize-behavior.mdx | 3 ++-
async-collaboration/recorder/overview.mdx | 2 +-
async-collaboration/recorder/setup.mdx | 4 ++++
async-collaboration/suggestions/overview.mdx | 1 +
async-collaboration/view-analytics/customize-behavior.mdx | 3 ++-
async-collaboration/view-analytics/overview.mdx | 1 +
async-collaboration/view-analytics/setup.mdx | 3 ++-
get-started/advanced.mdx | 2 +-
get-started/cli.mdx | 2 +-
get-started/mcp-installer.mdx | 2 +-
get-started/quickstart-old.mdx | 4 ++--
get-started/quickstart.mdx | 2 +-
get-started/skills.mdx | 2 +-
global-styles/css-injection.mdx | 3 ++-
global-styles/dark-mode.mdx | 3 ++-
global-styles/global-styles.mdx | 3 ++-
in-app-user-feedback/customize-behavior.mdx | 3 ++-
in-app-user-feedback/overview.mdx | 5 +++++
in-app-user-feedback/setup.mdx | 3 ++-
integrations/ag-grid.mdx | 3 ++-
key-concepts/overview.mdx | 5 +++++
live-co-editing/customize-behavior.mdx | 3 ++-
live-co-editing/customize-ui.mdx | 3 ++-
live-co-editing/overview.mdx | 5 +++++
live-co-editing/setup.mdx | 4 ++++
mcp/mcp.mdx | 3 ++-
migration/environments.mdx | 2 +-
migration/migrate-from-cord-to-velt.mdx | 1 +
migration/migrate-from-liveblocks-to-velt.mdx | 1 +
.../share-and-invite/customize-ui/parts.mdx | 5 +++++
.../share-and-invite/customize-ui/slots.mdx | 3 ++-
.../share-and-invite/customize-ui/variables.mdx | 5 +++++
permission-management/share-and-invite/overview.mdx | 2 +-
permission-management/share-and-invite/setup.mdx | 3 ++-
realtime-collaboration/crdt/overview.mdx | 4 ++--
realtime-collaboration/crdt/setup/blocknote.mdx | 4 ++--
realtime-collaboration/crdt/setup/codemirror.mdx | 4 ++--
realtime-collaboration/crdt/setup/core-stores/array.mdx | 4 ++--
realtime-collaboration/crdt/setup/core-stores/map.mdx | 4 ++--
realtime-collaboration/crdt/setup/core-stores/text.mdx | 4 ++--
realtime-collaboration/crdt/setup/core-stores/xml.mdx | 4 ++--
realtime-collaboration/crdt/setup/core.mdx | 4 ++--
realtime-collaboration/crdt/setup/reactflow.mdx | 4 ++--
realtime-collaboration/crdt/setup/tiptap.mdx | 4 ++--
realtime-collaboration/cursors/customize-behavior.mdx | 3 ++-
realtime-collaboration/cursors/overview.mdx | 4 ++--
realtime-collaboration/cursors/setup.mdx | 4 ++++
realtime-collaboration/flock-mode/customize-behavior.mdx | 3 ++-
realtime-collaboration/flock-mode/overview.mdx | 4 ++--
realtime-collaboration/flock-mode/setup.mdx | 3 ++-
realtime-collaboration/huddle/customize-behavior.mdx | 3 ++-
realtime-collaboration/huddle/setup.mdx | 3 ++-
realtime-collaboration/huddle/webhooks.mdx | 5 +++++
realtime-collaboration/live-selection/customize-behavior.mdx | 3 ++-
realtime-collaboration/live-selection/overview.mdx | 4 ++--
realtime-collaboration/live-selection/setup.mdx | 5 +++++
realtime-collaboration/live-state-sync/overview.mdx | 4 ++--
realtime-collaboration/live-state-sync/redux-middleware.mdx | 3 ++-
realtime-collaboration/live-state-sync/setup.mdx | 3 ++-
realtime-collaboration/presence/customize-behavior.mdx | 3 ++-
realtime-collaboration/presence/overview.mdx | 4 ++--
realtime-collaboration/presence/setup.mdx | 3 ++-
.../single-editor-mode/customize-behavior.mdx | 3 ++-
realtime-collaboration/single-editor-mode/overview.mdx | 4 ++--
realtime-collaboration/single-editor-mode/setup.mdx | 4 ++--
realtime-collaboration/video-player-sync/overview.mdx | 4 ++++
realtime-collaboration/video-player-sync/setup.mdx | 3 ++-
release-notes/3-0-0.mdx | 3 ++-
release-notes/version-4/blocknote-changelog.mdx | 2 +-
release-notes/version-4/codemirror-changelog.mdx | 2 +-
release-notes/version-4/crdt-core-changelog.mdx | 2 +-
release-notes/version-4/lexical-changelog.mdx | 2 +-
release-notes/version-4/reactflow-changelog.mdx | 2 +-
release-notes/version-4/sdk-changelog.mdx | 2 +-
release-notes/version-4/tiptap-changelog.mdx | 2 +-
release-notes/version-4/upgrade-guide.mdx | 3 ++-
release-notes/version-5/crdt-core-changelog.mdx | 2 +-
release-notes/version-5/sdk-changelog.mdx | 2 +-
release-notes/version-5/upgrade-guide.mdx | 3 ++-
release-notes/version-5/velt-node-changelog.mdx | 2 +-
release-notes/version-5/velt-py-changelog.mdx | 2 +-
security/auth-tokens.mdx | 1 +
security/content-security-policy.mdx | 5 +++++
security/jwt-tokens.mdx | 2 +-
security/proxy-server.mdx | 3 ++-
security/supported-regions.mdx | 1 +
self-host-data/activity.mdx | 2 +-
self-host-data/attachments.mdx | 2 +-
self-host-data/field-inventory.mdx | 4 ++--
self-host-data/notifications.mdx | 2 +-
self-host-data/overview.mdx | 4 ++--
self-host-data/recordings.mdx | 2 +-
ui-customization/conditional-templates.mdx | 1 +
ui-customization/custom-action-component.mdx | 1 +
.../async/activity-logs/activity-logs-primitives.mdx | 2 +-
.../activity-logs/activity-logs-wireframe-variables.mdx | 2 +-
ui-customization/features/async/area/wireframe-variables.mdx | 2 +-
ui-customization/features/async/arrows/custom-button.mdx | 3 ++-
ui-customization/features/async/arrows/parts.mdx | 5 +++++
ui-customization/features/async/arrows/slots.mdx | 3 ++-
ui-customization/features/async/arrows/variables.mdx | 5 +++++
.../async/comments/autocomplete-wireframe-variables.mdx | 2 +-
.../features/async/comments/comment-bubble/primitives.mdx | 2 +-
.../async/comments/comment-bubble/wireframe-variables.mdx | 2 +-
.../features/async/comments/comment-bubble/wireframes.mdx | 2 +-
.../features/async/comments/comment-dialog-structure.mdx | 2 +-
.../features/async/comments/comment-dialog/primitives.mdx | 2 +-
.../async/comments/comment-dialog/wireframe-variables.mdx | 2 +-
.../features/async/comments/comment-dialog/wireframes.mdx | 2 +-
.../features/async/comments/comment-pin/primitives.mdx | 2 +-
.../features/async/comments/comment-pin/wireframes.mdx | 2 +-
.../features/async/comments/comment-player-timeline.mdx | 1 +
.../async/comments/comment-sidebar-button/primitives.mdx | 2 +-
.../comments/comment-sidebar-button/wireframe-variables.mdx | 2 +-
.../async/comments/comment-sidebar-button/wireframes.mdx | 2 +-
.../features/async/comments/comment-sidebar-structure-v2.mdx | 2 +-
.../features/async/comments/comment-sidebar-structure.mdx | 2 +-
.../comments/comment-sidebar/comment-sidebar-components.mdx | 2 +-
.../comment-sidebar/comment-sidebar-v2-primitives.mdx | 2 +-
.../comment-sidebar/comment-sidebar-v2-wireframes.mdx | 2 +-
.../comment-sidebar/comment-sidebar-wireframe-variables.mdx | 2 +-
.../async/comments/comment-tool-wireframe-variables.mdx | 2 +-
ui-customization/features/async/comments/comment-tool.mdx | 2 +-
.../features/async/comments/comment-video-player.mdx | 1 +
ui-customization/features/async/comments/confirm-dialog.mdx | 2 +-
.../async/comments/inline-comments-section/primitives.mdx | 2 +-
.../comments/inline-comments-section/wireframe-variables.mdx | 2 +-
.../async/comments/inline-comments-section/wireframes.mdx | 2 +-
.../async/comments/multithread-comments/primitives.mdx | 2 +-
.../comments/multithread-comments/wireframe-variables.mdx | 2 +-
.../async/comments/multithread-comments/wireframes.mdx | 2 +-
.../async/comments/persistent-comment-mode-banner.mdx | 2 +-
.../comments/standalone-components/comment-composer.mdx | 1 +
.../async/comments/standalone-components/comment-thread.mdx | 1 +
.../features/async/comments/text-comment-primitives.mdx | 2 +-
.../async/comments/text-comment-wireframe-variables.mdx | 2 +-
.../comments/text-comment/text-comment-tool/primitives.mdx | 2 +-
.../comments/text-comment/text-comment-tool/wireframes.mdx | 2 +-
.../text-comment/text-comment-toolbar/primitives.mdx | 2 +-
.../text-comment/text-comment-toolbar/wireframes.mdx | 2 +-
ui-customization/features/async/inline-reactions.mdx | 2 +-
.../async/notifications/notifications-panel/primitives.mdx | 2 +-
.../notifications-panel/wireframe-variables.mdx | 2 +-
.../async/notifications/notifications-panel/wireframes.mdx | 2 +-
.../async/notifications/notifications-tool/primitives.mdx | 2 +-
.../notifications/notifications-tool/wireframe-variables.mdx | 2 +-
.../async/notifications/notifications-tool/wireframes.mdx | 2 +-
.../features/async/reactions-wireframe-variables.mdx | 2 +-
ui-customization/features/async/recorder/control-panel.mdx | 2 +-
.../features/async/recorder/media-source-settings.mdx | 2 +-
ui-customization/features/async/recorder/recorder-player.mdx | 2 +-
ui-customization/features/async/recorder/recorder-tool.mdx | 2 +-
.../async/recorder/recording-preview-steps-dialog.mdx | 2 +-
ui-customization/features/async/recorder/subtitles.mdx | 2 +-
.../async/recorder/transcription-wireframe-variables.mdx | 2 +-
ui-customization/features/async/recorder/transcription.mdx | 2 +-
ui-customization/features/async/recorder/video-editor.mdx | 2 +-
.../features/async/recorder/wireframe-variables.mdx | 2 +-
.../features/async/rewriter/wireframe-variables.mdx | 2 +-
.../features/async/view-analytics/wireframe-variables.mdx | 2 +-
.../features/realtime/cursors-wireframe-variables.mdx | 2 +-
ui-customization/features/realtime/cursors.mdx | 2 +-
ui-customization/features/realtime/huddle/parts.mdx | 5 +++++
ui-customization/features/realtime/huddle/slots.mdx | 3 ++-
ui-customization/features/realtime/huddle/variables.mdx | 5 +++++
.../features/realtime/huddle/wireframe-variables.mdx | 2 +-
.../features/realtime/live-selection-wireframe-variables.mdx | 2 +-
ui-customization/features/realtime/live-selection.mdx | 1 +
.../features/realtime/presence-wireframe-variables.mdx | 2 +-
ui-customization/features/realtime/presence.mdx | 2 +-
ui-customization/features/realtime/single-editor-mode.mdx | 2 +-
ui-customization/layout.mdx | 1 +
ui-customization/localisation.mdx | 1 +
ui-customization/overview.mdx | 3 ++-
ui-customization/setup.mdx | 1 +
ui-customization/styling.mdx | 1 +
ui-customization/template-variables.mdx | 1 +
webhooks/advanced.mdx | 3 ++-
webhooks/basic.mdx | 3 ++-
427 files changed, 724 insertions(+), 370 deletions(-)
diff --git a/ai/agent-comments.mdx b/ai/agent-comments.mdx
index fe4d2535d..9814bcf79 100644
--- a/ai/agent-comments.mdx
+++ b/ai/agent-comments.mdx
@@ -1,7 +1,7 @@
---
title: "Agent Comments"
sidebarTitle: "Agent Comments"
-description: "Let your AI agents leave comments and findings directly in Velt by calling the Comments REST APIs."
+description: "Let AI agents post comments, findings, and suggestions into Velt threads via the Comments REST APIs, with accept/reject reviewer workflows."
---
## What are agent comments?
diff --git a/ai/approval-engine/customize-behavior.mdx b/ai/approval-engine/customize-behavior.mdx
index 2eaa3318e..472e6cecb 100644
--- a/ai/approval-engine/customize-behavior.mdx
+++ b/ai/approval-engine/customize-behavior.mdx
@@ -1,6 +1,6 @@
---
-title: "Customize Behavior"
-description: "Node configuration, edge expressions, parallel groups, SLAs, linter rules, events, errors, and the full object reference."
+title: "Approval Engine: Customize Behavior"
+description: "Reference for Approval Engine node configs, edge expressions, parallel groups, SLA deadlines, linter rules, events, and error handling."
---
This is the deep-dive reference. Setup covers the happy path. This page covers everything you reach for when you need precise control over node behavior, edge routing, quorum policies, SLA breaches, and event consumption.
diff --git a/ai/approval-engine/overview.mdx b/ai/approval-engine/overview.mdx
index 05db712f5..7d1c88761 100644
--- a/ai/approval-engine/overview.mdx
+++ b/ai/approval-engine/overview.mdx
@@ -1,7 +1,7 @@
---
title: "Approval Engine (Beta)"
sidebarTitle: "Overview"
-description: "Multi-step approval workflows where AI agents and humans review work together."
+description: "Run multi-step approval workflows where AI agents and humans review work together, with state, retries, quorum, SLAs, and webhooks built in."
---
## What is the Approval Engine?
diff --git a/ai/approval-engine/setup.mdx b/ai/approval-engine/setup.mdx
index 32d519f8e..031f6f8c7 100644
--- a/ai/approval-engine/setup.mdx
+++ b/ai/approval-engine/setup.mdx
@@ -1,6 +1,6 @@
---
-title: "Setup"
-description: "Build a review-and-approval workflow end to end: author a definition, dispatch a run, record a decision, and receive the outcome."
+title: "Approval Engine Setup"
+description: "Build a review-and-approval workflow end to end: author a definition, dispatch a run, record a human decision, and receive the outcome via webhook."
---
A hands-on guide to building your first workflow on the Approval Engine. By the end you'll have authored a workflow, dispatched a run against a work item, recorded a human decision, and received the outcome.
diff --git a/ai/chat-sdk-adapter.mdx b/ai/chat-sdk-adapter.mdx
index c40d52622..924fae34a 100644
--- a/ai/chat-sdk-adapter.mdx
+++ b/ai/chat-sdk-adapter.mdx
@@ -1,7 +1,7 @@
---
title: "Chat SDK Adapter"
sidebarTitle: "Chat SDK Adapter"
-description: "Build a bot that reads and responds to Velt comment threads using the Chat SDK and @veltdev/chat-sdk-adapter."
+description: "Build platform-agnostic bots that read and reply to Velt comment threads using the Chat SDK and the @veltdev/chat-sdk-adapter package."
---
[Chat SDK](https://chat-sdk.dev) lets you build cross-platform bots whose logic
diff --git a/ai/memory/setup.mdx b/ai/memory/setup.mdx
index e8de62cad..0aded457e 100644
--- a/ai/memory/setup.mdx
+++ b/ai/memory/setup.mdx
@@ -1,6 +1,6 @@
---
-title: "Setup"
-description: "Set up Velt Memory end to end: add a knowledge source, ask a question, search past decisions, and pull a grounded suggestion."
+title: "Velt Memory Setup"
+description: "Set up Velt Memory end to end: add a knowledge source, ask a natural-language question, search past review decisions, and get a grounded suggestion."
---
A hands-on guide to building on Velt **Memory**, the review-intelligence layer. By the end you'll have added a knowledge source, asked a natural-language question, searched past review decisions, and pulled a grounded decision suggestion.
diff --git a/ai/rewriter/customize-behavior.mdx b/ai/rewriter/customize-behavior.mdx
index ffbe79a78..00d39747e 100644
--- a/ai/rewriter/customize-behavior.mdx
+++ b/ai/rewriter/customize-behavior.mdx
@@ -1,5 +1,6 @@
---
-title: "Customize Behavior"
+title: "Rewriter: Customize Behavior"
+description: "Reference for Velt Rewriter methods like addComment to anchor AI suggestions, rewrites, and comments to selected text ranges inside your application."
---
# addComment
diff --git a/ai/rewriter/overview.mdx b/ai/rewriter/overview.mdx
index c17b227eb..f49f852de 100644
--- a/ai/rewriter/overview.mdx
+++ b/ai/rewriter/overview.mdx
@@ -1,7 +1,7 @@
---
title: "Rewriter"
sidebarTitle: "Overview"
-description: "Let users select text on your website and use AI to rewrite, improve, or comment on it — powered by any major LLM provider."
+description: "Let users select text in your app and use AI to rewrite, improve, or comment on it, powered by OpenAI, Anthropic, or any major LLM provider."
---
diff --git a/ai/rewriter/setup.mdx b/ai/rewriter/setup.mdx
index 8349f19a9..7c306a01b 100644
--- a/ai/rewriter/setup.mdx
+++ b/ai/rewriter/setup.mdx
@@ -1,5 +1,6 @@
---
-title: "Setup"
+title: "Rewriter Setup"
+description: "Enable Velt Rewriter in your React, Next.js, or other framework app to add AI-powered text rewriting and inline suggestions on selected content."
---
diff --git a/api-reference/rest-apis/v1/auth/generate-token.mdx b/api-reference/rest-apis/v1/auth/generate-token.mdx
index 87058021f..bf69c7c55 100644
--- a/api-reference/rest-apis/v1/auth/generate-token.mdx
+++ b/api-reference/rest-apis/v1/auth/generate-token.mdx
@@ -1,5 +1,6 @@
---
-title: "Generate Token"
+title: "Generate auth token (v1)"
+description: "Generate a Velt JWT auth token using your API key and auth token. Encodes userId, organizationId and admin flag; expires in 48 hours."
api: "POST https://api.velt.dev/v1/auth/token/get"
---
diff --git a/api-reference/rest-apis/v1/comments-feature/comment-annotations/add-comment-annotations.mdx b/api-reference/rest-apis/v1/comments-feature/comment-annotations/add-comment-annotations.mdx
index 18ddde321..3a39eca88 100644
--- a/api-reference/rest-apis/v1/comments-feature/comment-annotations/add-comment-annotations.mdx
+++ b/api-reference/rest-apis/v1/comments-feature/comment-annotations/add-comment-annotations.mdx
@@ -1,5 +1,6 @@
---
-title: "Add Comment Annotations"
+title: "Add comment annotations (v1)"
+description: "Add comment annotations to a document via the v1 REST API. Attach comments to elements, text, or pages with HTML or plain text content."
api: "POST https://api.velt.dev/v1/commentannotations/add"
# api: "POST https://addcommentannotations.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/comments-feature/comment-annotations/delete-comment-annotations.mdx b/api-reference/rest-apis/v1/comments-feature/comment-annotations/delete-comment-annotations.mdx
index 4fa2e9f87..290649a74 100644
--- a/api-reference/rest-apis/v1/comments-feature/comment-annotations/delete-comment-annotations.mdx
+++ b/api-reference/rest-apis/v1/comments-feature/comment-annotations/delete-comment-annotations.mdx
@@ -1,5 +1,6 @@
---
-title: "Delete Comment Annotations"
+title: "Delete comment annotations (v1)"
+description: "Delete comment annotations from a document using the v1 REST API. Filter by location IDs, annotation IDs, or user IDs for targeted removal."
api: "POST https://api.velt.dev/v1/commentannotations/delete"
# api: "POST https://deletecommentannotations.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/comments-feature/comment-annotations/get-comment-annotations-count.mdx b/api-reference/rest-apis/v1/comments-feature/comment-annotations/get-comment-annotations-count.mdx
index a1567c5d3..58ddff910 100644
--- a/api-reference/rest-apis/v1/comments-feature/comment-annotations/get-comment-annotations-count.mdx
+++ b/api-reference/rest-apis/v1/comments-feature/comment-annotations/get-comment-annotations-count.mdx
@@ -1,5 +1,6 @@
---
-title: 'Get Comment Annotations Count'
+title: 'Get comment annotations count (v1)'
+description: "Retrieve total and unread comment annotation counts for up to 30 documents using the v1 REST API. Filter by user ID and status IDs."
api: 'POST https://api.velt.dev/v1/commentannotations/count/get'
---
diff --git a/api-reference/rest-apis/v1/comments-feature/comment-annotations/get-comment-annotations.mdx b/api-reference/rest-apis/v1/comments-feature/comment-annotations/get-comment-annotations.mdx
index c6a8dc166..0ee9c5c01 100644
--- a/api-reference/rest-apis/v1/comments-feature/comment-annotations/get-comment-annotations.mdx
+++ b/api-reference/rest-apis/v1/comments-feature/comment-annotations/get-comment-annotations.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Comment Annotations"
+title: "Get comment annotations (v1)"
+description: "Retrieve comment annotations from a document via the v1 REST API for SDK v3 or earlier. Filter by location IDs, annotation IDs, or user IDs."
api: "POST https://api.velt.dev/v1/commentannotations/get"
# api: "POST https://getcommentannotations.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/comments-feature/comment-annotations/update-comment-annotations.mdx b/api-reference/rest-apis/v1/comments-feature/comment-annotations/update-comment-annotations.mdx
index d9eaff63b..81b562f13 100644
--- a/api-reference/rest-apis/v1/comments-feature/comment-annotations/update-comment-annotations.mdx
+++ b/api-reference/rest-apis/v1/comments-feature/comment-annotations/update-comment-annotations.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Comment Annotations"
+title: "Update comment annotations (v1)"
+description: "Update comment annotations on a document via the v1 REST API. Filter by location, annotation, or user IDs and modify status, assignees, and more."
api: "POST https://api.velt.dev/v1/commentannotations/update"
# api: "POST https://updatecommentannotations.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/comments-feature/comments/add-comments.mdx b/api-reference/rest-apis/v1/comments-feature/comments/add-comments.mdx
index 2675f6baf..fb3cc30cc 100644
--- a/api-reference/rest-apis/v1/comments-feature/comments/add-comments.mdx
+++ b/api-reference/rest-apis/v1/comments-feature/comments/add-comments.mdx
@@ -1,5 +1,6 @@
---
-title: "Add Comments"
+title: "Add comments to annotation (v1)"
+description: "Add reply comments inside a specific Velt comment annotation using the v1 REST API. Authenticate with API key and auth token headers."
api: "POST https://api.velt.dev/v1/commentannotations/comments/add"
# api: "POST https://addcommentsincommentannotation.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/comments-feature/comments/delete-comments.mdx b/api-reference/rest-apis/v1/comments-feature/comments/delete-comments.mdx
index f5b9da8ed..d023529a0 100644
--- a/api-reference/rest-apis/v1/comments-feature/comments/delete-comments.mdx
+++ b/api-reference/rest-apis/v1/comments-feature/comments/delete-comments.mdx
@@ -1,5 +1,6 @@
---
-title: "Delete Comments"
+title: "Delete comments from annotation (v1)"
+description: "Delete individual reply comments from a Velt comment annotation using the v1 REST API. Filter by specific comment IDs for targeted removal."
api: "POST https://api.velt.dev/v1/commentannotations/comments/delete"
# api: "POST https://getcommentsincommentannotation.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/comments-feature/comments/get-comments.mdx b/api-reference/rest-apis/v1/comments-feature/comments/get-comments.mdx
index 94f7067a1..5ea6516e9 100644
--- a/api-reference/rest-apis/v1/comments-feature/comments/get-comments.mdx
+++ b/api-reference/rest-apis/v1/comments-feature/comments/get-comments.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Comments"
+title: "Get comments in annotation (v1)"
+description: "Retrieve reply comments inside a specific Velt comment annotation using the v1 REST API. Requires advanced queries and SDK v4. Filter by comment IDs."
api: "POST https://api.velt.dev/v1/commentannotations/comments/get"
# api: "POST https://getcommentsincommentannotation.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/comments-feature/comments/update-comments.mdx b/api-reference/rest-apis/v1/comments-feature/comments/update-comments.mdx
index 8e4b8424c..c34135060 100644
--- a/api-reference/rest-apis/v1/comments-feature/comments/update-comments.mdx
+++ b/api-reference/rest-apis/v1/comments-feature/comments/update-comments.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Comments"
+title: "Update comments in annotation (v1)"
+description: "Update individual reply comments inside a Velt comment annotation using the v1 REST API. Edit comment text and metadata by comment ID."
api: "POST https://api.velt.dev/v1/commentannotations/comments/update"
# api: "POST https://updatecommentsincommentannotation.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/documents/add-documents.mdx b/api-reference/rest-apis/v1/documents/add-documents.mdx
index aed06a185..ef015a139 100644
--- a/api-reference/rest-apis/v1/documents/add-documents.mdx
+++ b/api-reference/rest-apis/v1/documents/add-documents.mdx
@@ -1,5 +1,6 @@
---
-title: "Add Documents"
+title: "Add documents (v1)"
+description: "Add documents with metadata to a Velt organization using the v1 REST API. Provide document IDs, names, and custom fields in a single request."
api: "POST https://api.velt.dev/v1/organizations/documents/add"
# api: "POST https://adddocuments.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/documents/delete-documents.mdx b/api-reference/rest-apis/v1/documents/delete-documents.mdx
index 89bc857fc..0920c8dc7 100644
--- a/api-reference/rest-apis/v1/documents/delete-documents.mdx
+++ b/api-reference/rest-apis/v1/documents/delete-documents.mdx
@@ -1,5 +1,6 @@
---
-title: "Delete Documents"
+title: "Delete documents (v1)"
+description: "Delete one or more documents from a Velt organization using the v1 REST API. Pass an array of document IDs to remove documents and their data."
api: "POST https://api.velt.dev/v1/organizations/documents/delete"
# api: "POST https://deletedocuments.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/documents/get-documents.mdx b/api-reference/rest-apis/v1/documents/get-documents.mdx
index 268aaf725..ca966202c 100644
--- a/api-reference/rest-apis/v1/documents/get-documents.mdx
+++ b/api-reference/rest-apis/v1/documents/get-documents.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Documents"
+title: "Get documents (v1)"
+description: "Retrieve specific documents or all documents in a Velt organization via the v1 REST API. Use this endpoint with SDK v3 or earlier versions."
api: "POST https://api.velt.dev/v1/organizations/documents/get"
# api: "POST https://getdocuments.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/documents/move-documents.mdx b/api-reference/rest-apis/v1/documents/move-documents.mdx
index 70c542a3c..3b9c0ed47 100644
--- a/api-reference/rest-apis/v1/documents/move-documents.mdx
+++ b/api-reference/rest-apis/v1/documents/move-documents.mdx
@@ -1,5 +1,6 @@
---
-title: "Move Documents"
+title: "Move documents to folder (v1)"
+description: "Move up to 30 documents into a target folder within a Velt organization using the v1 REST API. Reorganize document hierarchy in bulk."
api: "POST https://api.velt.dev/v1/organizations/documents/move"
---
diff --git a/api-reference/rest-apis/v1/documents/update-document-access.mdx b/api-reference/rest-apis/v1/documents/update-document-access.mdx
index 65b4e1ccc..578880dd9 100644
--- a/api-reference/rest-apis/v1/documents/update-document-access.mdx
+++ b/api-reference/rest-apis/v1/documents/update-document-access.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Access for Documents"
+title: "Update document access type (v1)"
+description: "Update the access type for one or many documents at once using the v1 REST API. Control public, restricted, or default document permissions."
api: "POST https://api.velt.dev/v1/organizations/documents/access/update"
# api: "POST https://updateaccessfordocuments.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/documents/update-document-disable-state.mdx b/api-reference/rest-apis/v1/documents/update-document-disable-state.mdx
index af3c2a2a0..3606fc106 100644
--- a/api-reference/rest-apis/v1/documents/update-document-disable-state.mdx
+++ b/api-reference/rest-apis/v1/documents/update-document-disable-state.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Disabled State for Documents"
+title: "Update document disabled state (v1)"
+description: "Enable or disable read and write access for specific documents using the v1 REST API. Useful to suspend Velt access after trial or subscription ends."
api: "POST https://api.velt.dev/v1/organizations/documents/access/disablestate/update"
# api: "POST https://updatedisablestatefordocuments.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/documents/update-documents.mdx b/api-reference/rest-apis/v1/documents/update-documents.mdx
index b2021a675..b316e957b 100644
--- a/api-reference/rest-apis/v1/documents/update-documents.mdx
+++ b/api-reference/rest-apis/v1/documents/update-documents.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Documents"
+title: "Update documents (v1)"
+description: "Update metadata for one or more documents in a Velt organization using the v1 REST API. Modify names, custom fields, and other document properties."
api: "POST https://api.velt.dev/v1/organizations/documents/update"
# api: "POST https://updatedocuments.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/folders/add-folder.mdx b/api-reference/rest-apis/v1/folders/add-folder.mdx
index 519b99333..867bf6594 100644
--- a/api-reference/rest-apis/v1/folders/add-folder.mdx
+++ b/api-reference/rest-apis/v1/folders/add-folder.mdx
@@ -1,5 +1,6 @@
---
-title: "Add Folder"
+title: "Add folder (v1)"
+description: "Create a new folder inside a Velt organization using the v1 REST API. Requires advanced queries enabled and Velt SDK v4 series deployed."
api: "POST https://api.velt.dev/v1/organizations/folders/add"
---
diff --git a/api-reference/rest-apis/v1/folders/get-folders.mdx b/api-reference/rest-apis/v1/folders/get-folders.mdx
index 8a1784853..e7863da74 100644
--- a/api-reference/rest-apis/v1/folders/get-folders.mdx
+++ b/api-reference/rest-apis/v1/folders/get-folders.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Folders"
+title: "Get folders (v1)"
+description: "Retrieve a folder's metadata and its subfolders within a Velt organization using the v1 REST API. Requires advanced queries and SDK v4 series."
api: "POST https://api.velt.dev/v1/organizations/folders/get"
---
diff --git a/api-reference/rest-apis/v1/folders/update-folder-access.mdx b/api-reference/rest-apis/v1/folders/update-folder-access.mdx
index b9773aa33..89ca8909d 100644
--- a/api-reference/rest-apis/v1/folders/update-folder-access.mdx
+++ b/api-reference/rest-apis/v1/folders/update-folder-access.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Access for Folders"
+title: "Update folder access type (v1)"
+description: "Update the access type for one or many folders at once using the v1 REST API. Control default, public, or restricted permissions for folders."
api: "POST https://api.velt.dev/v1/organizations/folders/access/update"
---
diff --git a/api-reference/rest-apis/v1/folders/update-folder.mdx b/api-reference/rest-apis/v1/folders/update-folder.mdx
index 38190edd5..989ae36f3 100644
--- a/api-reference/rest-apis/v1/folders/update-folder.mdx
+++ b/api-reference/rest-apis/v1/folders/update-folder.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Folder"
+title: "Update or move folder (v1)"
+description: "Update folder metadata or move a folder and its contents to a new parent using the v1 REST API. Requires advanced queries and SDK v4 series."
api: "POST https://api.velt.dev/v1/organizations/folders/update"
---
diff --git a/api-reference/rest-apis/v1/gdpr/delete-all-user-data-gdpr.mdx b/api-reference/rest-apis/v1/gdpr/delete-all-user-data-gdpr.mdx
index df5a63763..152d48bc2 100644
--- a/api-reference/rest-apis/v1/gdpr/delete-all-user-data-gdpr.mdx
+++ b/api-reference/rest-apis/v1/gdpr/delete-all-user-data-gdpr.mdx
@@ -1,6 +1,6 @@
---
-title: "Delete All User Data"
-description: "Remove All User data from Velt."
+title: "Delete all user data (GDPR, v1)"
+description: "Asynchronously delete all of a user's data from Velt for GDPR compliance, including comments, mentions, reactions, and organization access."
# api: "POST https://api.velt.dev/deleteusers"
api: "POST https://api.velt.dev/v1/users/data/delete"
---
diff --git a/api-reference/rest-apis/v1/gdpr/get-all-user-data-gdpr.mdx b/api-reference/rest-apis/v1/gdpr/get-all-user-data-gdpr.mdx
index 87349e5f5..47b76cc6a 100644
--- a/api-reference/rest-apis/v1/gdpr/get-all-user-data-gdpr.mdx
+++ b/api-reference/rest-apis/v1/gdpr/get-all-user-data-gdpr.mdx
@@ -1,6 +1,6 @@
---
-title: "Get All User Data"
-description: "Get all feature data for a user stored in Velt."
+title: "Get all user data (GDPR, v1)"
+description: "Export all Velt feature data stored for a user for GDPR requests. Returns paginated chunks of 100 items per feature using nextPageToken."
api: "POST https://api.velt.dev/v1/users/data/get"
---
diff --git a/api-reference/rest-apis/v1/gdpr/get-delete-user-data-status-gdpr.mdx b/api-reference/rest-apis/v1/gdpr/get-delete-user-data-status-gdpr.mdx
index 793de1961..460dc7fbb 100644
--- a/api-reference/rest-apis/v1/gdpr/get-delete-user-data-status-gdpr.mdx
+++ b/api-reference/rest-apis/v1/gdpr/get-delete-user-data-status-gdpr.mdx
@@ -1,6 +1,6 @@
---
-title: "Get Delete All User Data Status"
-description: "Get the status of the data deletion process for a user."
+title: "Get delete user data status (GDPR, v1)"
+description: "Check the progress and status of an asynchronous GDPR user data deletion job in Velt. Poll this endpoint after starting a delete request."
api: "POST https://api.velt.dev/v1/users/data/delete/status"
---
diff --git a/api-reference/rest-apis/v1/livestate/broadcast-event.mdx b/api-reference/rest-apis/v1/livestate/broadcast-event.mdx
index 1e034e967..e79ead34d 100644
--- a/api-reference/rest-apis/v1/livestate/broadcast-event.mdx
+++ b/api-reference/rest-apis/v1/livestate/broadcast-event.mdx
@@ -1,5 +1,6 @@
---
-title: "Broadcast Event"
+title: "Broadcast live state event (v1)"
+description: "Broadcast a live state event from your server to any Velt document using the v1 REST API. Pair with the Live State Sync feature for realtime updates."
api: "POST https://api.velt.dev/v1/livestate/broadcast"
---
diff --git a/api-reference/rest-apis/v1/locations/delete-data-by-location.mdx b/api-reference/rest-apis/v1/locations/delete-data-by-location.mdx
index 184c9e492..07276b7a1 100644
--- a/api-reference/rest-apis/v1/locations/delete-data-by-location.mdx
+++ b/api-reference/rest-apis/v1/locations/delete-data-by-location.mdx
@@ -1,6 +1,6 @@
---
-title: "Delete Data by Location"
-description: "Delete all data associated with a specific location"
+title: "Delete data by location (v1)"
+description: "Delete all Velt feature data tied to a specific location, including comments, recordings, and other annotations, using the v1 REST API."
api: "POST https://api.velt.dev/v1/organizations/documents/locations/data/delete"
---
diff --git a/api-reference/rest-apis/v1/locations/update-location.mdx b/api-reference/rest-apis/v1/locations/update-location.mdx
index 1edb3342f..590ce4c85 100644
--- a/api-reference/rest-apis/v1/locations/update-location.mdx
+++ b/api-reference/rest-apis/v1/locations/update-location.mdx
@@ -1,6 +1,6 @@
---
-title: "Update Location"
-description: "Update a Location's metadata"
+title: "Update location (v1)"
+description: "Update a Velt location's metadata within a document using the v1 REST API. Modify location names, custom fields, and other properties."
api: "POST https://api.velt.dev/v1/organizations/documents/locations/update"
---
diff --git a/api-reference/rest-apis/v1/notifications/add-notifications.mdx b/api-reference/rest-apis/v1/notifications/add-notifications.mdx
index 48f27661f..7afa6360a 100644
--- a/api-reference/rest-apis/v1/notifications/add-notifications.mdx
+++ b/api-reference/rest-apis/v1/notifications/add-notifications.mdx
@@ -1,5 +1,6 @@
---
-title: "Add Notifications"
+title: "Add notifications (v1)"
+description: "Create and send in-app notifications to Velt users using the v1 REST API. Trigger notifications from your server with custom payloads and targets."
api: "POST https://api.velt.dev/v1/notifications/add"
# api: "POST https://addnotifications.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/notifications/delete-notifications.mdx b/api-reference/rest-apis/v1/notifications/delete-notifications.mdx
index 376292d1b..9b4d28798 100644
--- a/api-reference/rest-apis/v1/notifications/delete-notifications.mdx
+++ b/api-reference/rest-apis/v1/notifications/delete-notifications.mdx
@@ -1,5 +1,6 @@
---
-title: "Delete Notifications"
+title: "Delete notifications (v1)"
+description: "Delete in-app notifications from Velt using the v1 REST API. Remove specific notifications by ID to clean up notification feeds programmatically."
api: "POST https://api.velt.dev/v1/notifications/delete"
# api: "POST https://deletenotifications.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/notifications/get-config.mdx b/api-reference/rest-apis/v1/notifications/get-config.mdx
index ac8499f60..0e4d42f61 100644
--- a/api-reference/rest-apis/v1/notifications/get-config.mdx
+++ b/api-reference/rest-apis/v1/notifications/get-config.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Config"
+title: "Get notifications config (v1)"
+description: "Retrieve a user's notifications configuration from Velt using the v1 REST API. Requires the notifications feature enabled in the Velt console."
api: "POST https://api.velt.dev/v1/notifications/config/get"
---
diff --git a/api-reference/rest-apis/v1/notifications/get-notifications.mdx b/api-reference/rest-apis/v1/notifications/get-notifications.mdx
index f5fbe3a56..a753c5efb 100644
--- a/api-reference/rest-apis/v1/notifications/get-notifications.mdx
+++ b/api-reference/rest-apis/v1/notifications/get-notifications.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Notifications"
+title: "Get notifications (v1)"
+description: "Retrieve in-app notifications for Velt users via the v1 REST API. Use this endpoint with SDK v3 or earlier versions for notification feeds."
api: "POST https://api.velt.dev/v1/notifications/get"
# api: "POST https://getnotifications.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/notifications/set-config.mdx b/api-reference/rest-apis/v1/notifications/set-config.mdx
index c15371ea3..8e9f83df1 100644
--- a/api-reference/rest-apis/v1/notifications/set-config.mdx
+++ b/api-reference/rest-apis/v1/notifications/set-config.mdx
@@ -1,5 +1,6 @@
---
-title: "Set Config"
+title: "Set notifications config (v1)"
+description: "Set a user's notifications configuration in Velt using the v1 REST API. Requires the notifications feature enabled in the Velt console first."
api: "POST https://api.velt.dev/v1/notifications/config/set"
---
diff --git a/api-reference/rest-apis/v1/notifications/update-notifications.mdx b/api-reference/rest-apis/v1/notifications/update-notifications.mdx
index 222afdf2f..d89249cea 100644
--- a/api-reference/rest-apis/v1/notifications/update-notifications.mdx
+++ b/api-reference/rest-apis/v1/notifications/update-notifications.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Notifications"
+title: "Update notifications (v1)"
+description: "Update existing in-app notifications in Velt using the v1 REST API. Modify notification content, status, or metadata after delivery."
api: "POST https://api.velt.dev/v1/notifications/update"
# api: "POST https://updatenotifications.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/organizations/add-organizations.mdx b/api-reference/rest-apis/v1/organizations/add-organizations.mdx
index 972dce255..f3b96a62b 100644
--- a/api-reference/rest-apis/v1/organizations/add-organizations.mdx
+++ b/api-reference/rest-apis/v1/organizations/add-organizations.mdx
@@ -1,5 +1,6 @@
---
-title: "Add Organizations"
+title: "Add organizations (v1)"
+description: "Create new organizations and their metadata in Velt using the v1 REST API. Provision tenants for multi-org collaboration apps in a single call."
api: "POST https://api.velt.dev/v1/organizations/add"
# api: "POST https://addorganizations.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/organizations/delete-organizations.mdx b/api-reference/rest-apis/v1/organizations/delete-organizations.mdx
index 41a433a90..ad51e814a 100644
--- a/api-reference/rest-apis/v1/organizations/delete-organizations.mdx
+++ b/api-reference/rest-apis/v1/organizations/delete-organizations.mdx
@@ -1,5 +1,6 @@
---
-title: "Delete Organizations"
+title: "Delete organizations (v1)"
+description: "Delete one or more Velt organizations and all of their data using the v1 REST API. Pass an array of organization IDs to remove tenants in bulk."
api: "POST https://api.velt.dev/v1/organizations/delete"
# api: "POST https://deleteorganizations.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/organizations/get-organizations.mdx b/api-reference/rest-apis/v1/organizations/get-organizations.mdx
index f3bfb6c04..44573c6d8 100644
--- a/api-reference/rest-apis/v1/organizations/get-organizations.mdx
+++ b/api-reference/rest-apis/v1/organizations/get-organizations.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Organizations"
+title: "Get organizations (v1)"
+description: "Retrieve specific Velt organizations by organization IDs using the v1 REST API. Use this endpoint with SDK v3 or earlier versions."
api: "POST https://api.velt.dev/v1/organizations/get"
# api: "POST https://getorganizations.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/organizations/update-organization-disable-state.mdx b/api-reference/rest-apis/v1/organizations/update-organization-disable-state.mdx
index 4f7082d18..03a0c3fd1 100644
--- a/api-reference/rest-apis/v1/organizations/update-organization-disable-state.mdx
+++ b/api-reference/rest-apis/v1/organizations/update-organization-disable-state.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Disabled State for Organizations"
+title: "Update organization disabled state (v1)"
+description: "Enable or disable read and write access for all documents in a Velt organization using the v1 REST API. Useful when suspending tenant access."
api: "POST https://api.velt.dev/v1/organizations/access/disablestate/update"
# api: "POST https://updatedisablestatefororganizations.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/organizations/update-organizations.mdx b/api-reference/rest-apis/v1/organizations/update-organizations.mdx
index 29bc319a7..6012fab2e 100644
--- a/api-reference/rest-apis/v1/organizations/update-organizations.mdx
+++ b/api-reference/rest-apis/v1/organizations/update-organizations.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Organizations"
+title: "Update organizations (v1)"
+description: "Update metadata for one or more existing Velt organizations using the v1 REST API. Modify org names, custom fields, and other tenant properties."
api: "POST https://api.velt.dev/v1/organizations/update"
# api: "POST https://updateorganizations.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/user-groups/add-groups.mdx b/api-reference/rest-apis/v1/user-groups/add-groups.mdx
index b22c14b2a..718e9aa9e 100644
--- a/api-reference/rest-apis/v1/user-groups/add-groups.mdx
+++ b/api-reference/rest-apis/v1/user-groups/add-groups.mdx
@@ -1,5 +1,6 @@
---
-title: "Add User Groups"
+title: "Add user groups (v1)"
+description: "Create user groups within a Velt organization using the v1 REST API. Organize members into groups for mentions, permissions, and team workflows."
api: "POST https://api.velt.dev/v1/organizations/usergroups/add"
# api: "POST https://addorganizationusergroups.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/user-groups/add-users-to-group.mdx b/api-reference/rest-apis/v1/user-groups/add-users-to-group.mdx
index 06f0bd0b6..a36232033 100644
--- a/api-reference/rest-apis/v1/user-groups/add-users-to-group.mdx
+++ b/api-reference/rest-apis/v1/user-groups/add-users-to-group.mdx
@@ -1,5 +1,6 @@
---
-title: "Add Users to Groups"
+title: "Add users to user group (v1)"
+description: "Add users to a specific Velt organization user group using the v1 REST API. Manage group membership for mentions and team-based permissions."
api: "POST https://api.velt.dev/v1/organizations/usergroups/users/add"
# api: "POST https://addorganizationuserstogroup.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/user-groups/delete-users-from-group.mdx b/api-reference/rest-apis/v1/user-groups/delete-users-from-group.mdx
index c078615a5..32047bda9 100644
--- a/api-reference/rest-apis/v1/user-groups/delete-users-from-group.mdx
+++ b/api-reference/rest-apis/v1/user-groups/delete-users-from-group.mdx
@@ -1,5 +1,6 @@
---
-title: "Delete Users from Groups"
+title: "Delete users from user group (v1)"
+description: "Remove users from a specific Velt organization user group using the v1 REST API. Revoke group-based permissions and mention targeting in bulk."
api: "POST https://api.velt.dev/v1/organizations/usergroups/users/delete"
# api: "POST https://deleteorganizationusersfromgroup.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/users/add-users.mdx b/api-reference/rest-apis/v1/users/add-users.mdx
index 4619f2000..febb48afc 100644
--- a/api-reference/rest-apis/v1/users/add-users.mdx
+++ b/api-reference/rest-apis/v1/users/add-users.mdx
@@ -1,5 +1,6 @@
---
-title: "Add Users"
+title: "Add users (v1)"
+description: "Add users to a Velt organization, folder, or document using the v1 REST API. Grants access and adds users to mention contact lists in one call."
api: "POST https://api.velt.dev/v1/users/add"
# api: "POST https://addusers.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/users/delete-users.mdx b/api-reference/rest-apis/v1/users/delete-users.mdx
index df2d47344..f6e461ed6 100644
--- a/api-reference/rest-apis/v1/users/delete-users.mdx
+++ b/api-reference/rest-apis/v1/users/delete-users.mdx
@@ -1,6 +1,6 @@
---
-title: "Delete Users"
-description: "Remove Users from an Organization or a Document."
+title: "Delete users (v1)"
+description: "Remove users from a Velt organization or document using the v1 REST API. Revokes access and removes them from mention contact lists in one call."
api: "POST https://api.velt.dev/v1/users/delete"
# api: "POST https://deleteusers.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/users/get-users.mdx b/api-reference/rest-apis/v1/users/get-users.mdx
index 02d636bdf..fa7f20f1f 100644
--- a/api-reference/rest-apis/v1/users/get-users.mdx
+++ b/api-reference/rest-apis/v1/users/get-users.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Users"
+title: "Get users (v1)"
+description: "Retrieve Velt users filtered by organization, document, user group, or user IDs via the v1 REST API. Use with SDK v3 or earlier versions."
api: "POST https://api.velt.dev/v1/users/get"
# api: "POST https://getusers.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/users/update-users.mdx b/api-reference/rest-apis/v1/users/update-users.mdx
index 1588b8441..755a5aeb6 100644
--- a/api-reference/rest-apis/v1/users/update-users.mdx
+++ b/api-reference/rest-apis/v1/users/update-users.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Users"
+title: "Update users (v1)"
+description: "Update Velt user metadata such as name and email using the v1 REST API. Filter by organization, document, folder, or user IDs to target users."
api: "POST https://api.velt.dev/v1/users/update"
# api: "POST https://updateusers.api.velt.dev/"
---
diff --git a/api-reference/rest-apis/v1/workspace/add-domain.mdx b/api-reference/rest-apis/v1/workspace/add-domain.mdx
index d5e27bd4e..8cd8d28ac 100644
--- a/api-reference/rest-apis/v1/workspace/add-domain.mdx
+++ b/api-reference/rest-apis/v1/workspace/add-domain.mdx
@@ -1,5 +1,6 @@
---
-title: "Add Domains"
+title: "Add workspace domains (v1)"
+description: "Add allowed domains to your Velt workspace using the v1 REST API. Manage which domains can authenticate and access your Velt-powered apps."
api: "POST https://api.velt.dev/v1/workspace/domains/add"
---
diff --git a/api-reference/rest-apis/v1/workspace/delete-domain.mdx b/api-reference/rest-apis/v1/workspace/delete-domain.mdx
index e7c27ea17..bbca2880a 100644
--- a/api-reference/rest-apis/v1/workspace/delete-domain.mdx
+++ b/api-reference/rest-apis/v1/workspace/delete-domain.mdx
@@ -1,5 +1,6 @@
---
-title: "Delete Domains"
+title: "Delete workspace domains (v1)"
+description: "Remove allowed domains from your Velt workspace using the v1 REST API. Revoke a domain's ability to authenticate against your Velt workspace."
api: "POST https://api.velt.dev/v1/workspace/domains/delete"
---
diff --git a/api-reference/rest-apis/v2/activities/add-activities.mdx b/api-reference/rest-apis/v2/activities/add-activities.mdx
index 7d51308ad..fb32505a4 100644
--- a/api-reference/rest-apis/v2/activities/add-activities.mdx
+++ b/api-reference/rest-apis/v2/activities/add-activities.mdx
@@ -1,5 +1,6 @@
---
-title: "Add Activity Logs"
+title: "Add activity logs (v2)"
+description: "Create activity log records for a document in an organization using the Velt v2 REST API. Requires activityServiceConfig enabled in the Velt Console."
api: "POST https://api.velt.dev/v2/activities/add"
---
diff --git a/api-reference/rest-apis/v2/activities/delete-activities.mdx b/api-reference/rest-apis/v2/activities/delete-activities.mdx
index 7dac0d2d8..1ab708033 100644
--- a/api-reference/rest-apis/v2/activities/delete-activities.mdx
+++ b/api-reference/rest-apis/v2/activities/delete-activities.mdx
@@ -1,5 +1,6 @@
---
-title: "Delete Activity Logs"
+title: "Delete activity logs (v2)"
+description: "Remove activity log records by documentId, targetEntityId, or activityId in an organization using the Velt v2 REST API for activity history cleanup."
api: "POST https://api.velt.dev/v2/activities/delete"
---
diff --git a/api-reference/rest-apis/v2/activities/get-activities.mdx b/api-reference/rest-apis/v2/activities/get-activities.mdx
index 0a3c1a250..702b677ee 100644
--- a/api-reference/rest-apis/v2/activities/get-activities.mdx
+++ b/api-reference/rest-apis/v2/activities/get-activities.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Activity Logs"
+title: "Get activity logs (v2)"
+description: "Retrieve activity log records for a document or organization using the Velt v2 REST API to fetch audit history, user actions, and event timelines."
api: "POST https://api.velt.dev/v2/activities/get"
---
diff --git a/api-reference/rest-apis/v2/activities/update-activities.mdx b/api-reference/rest-apis/v2/activities/update-activities.mdx
index 0bea82748..78d94f1ad 100644
--- a/api-reference/rest-apis/v2/activities/update-activities.mdx
+++ b/api-reference/rest-apis/v2/activities/update-activities.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Activity Logs"
+title: "Update activity logs (v2)"
+description: "Modify existing activity log records within an organization using the Velt v2 REST API to amend metadata, payloads, or labels on past audit events."
api: "POST https://api.velt.dev/v2/activities/update"
---
diff --git a/api-reference/rest-apis/v2/agents/list-agent-executions.mdx b/api-reference/rest-apis/v2/agents/list-agent-executions.mdx
index 9cb1ed2ea..e630c2575 100644
--- a/api-reference/rest-apis/v2/agents/list-agent-executions.mdx
+++ b/api-reference/rest-apis/v2/agents/list-agent-executions.mdx
@@ -1,5 +1,6 @@
---
-title: "List Agent Executions"
+title: "List agent executions (v2)"
+description: "List AI agent execution runs with status, timing, and metadata using the Velt v2 REST API to monitor agent activity, debug runs, and audit usage."
api: "POST https://api.velt.dev/v2/agents/execution/list"
---
diff --git a/api-reference/rest-apis/v2/approval-engine/definitions/create-definition.mdx b/api-reference/rest-apis/v2/approval-engine/definitions/create-definition.mdx
index 8cfd0f0df..95ff314e2 100644
--- a/api-reference/rest-apis/v2/approval-engine/definitions/create-definition.mdx
+++ b/api-reference/rest-apis/v2/approval-engine/definitions/create-definition.mdx
@@ -1,5 +1,6 @@
---
-title: "Create Definition"
+title: "Create approval definition (v2)"
+description: "Register a new approval workflow definition with nodes, edges, and parallel groups using the Velt v2 REST API. Graphs are linted at write time."
api: "POST https://api.velt.dev/v2/workflow/definitions/create"
---
diff --git a/api-reference/rest-apis/v2/approval-engine/definitions/delete-definition.mdx b/api-reference/rest-apis/v2/approval-engine/definitions/delete-definition.mdx
index cda259e53..561620258 100644
--- a/api-reference/rest-apis/v2/approval-engine/definitions/delete-definition.mdx
+++ b/api-reference/rest-apis/v2/approval-engine/definitions/delete-definition.mdx
@@ -1,5 +1,6 @@
---
-title: "Delete Definition"
+title: "Delete approval definition (v2)"
+description: "Remove an approval workflow definition by ID using the Velt v2 REST API. Deletes the static blueprint of nodes, edges, and parallel groups."
api: "POST https://api.velt.dev/v2/workflow/definitions/delete"
---
diff --git a/api-reference/rest-apis/v2/approval-engine/definitions/get-definition.mdx b/api-reference/rest-apis/v2/approval-engine/definitions/get-definition.mdx
index cd4997c2c..9ce95d609 100644
--- a/api-reference/rest-apis/v2/approval-engine/definitions/get-definition.mdx
+++ b/api-reference/rest-apis/v2/approval-engine/definitions/get-definition.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Definition"
+title: "Get approval definition (v2)"
+description: "Fetch a single approval workflow definition with its nodes, edges, and parallel groups by ID using the Velt v2 REST API for inspection and audits."
api: "POST https://api.velt.dev/v2/workflow/definitions/get"
---
diff --git a/api-reference/rest-apis/v2/approval-engine/definitions/list-definitions.mdx b/api-reference/rest-apis/v2/approval-engine/definitions/list-definitions.mdx
index 3df04155e..596485a8a 100644
--- a/api-reference/rest-apis/v2/approval-engine/definitions/list-definitions.mdx
+++ b/api-reference/rest-apis/v2/approval-engine/definitions/list-definitions.mdx
@@ -1,5 +1,6 @@
---
-title: "List Definitions"
+title: "List approval definitions (v2)"
+description: "List approval workflow definitions in a workspace using the Velt v2 REST API to browse blueprints, filter by status, and paginate results."
api: "POST https://api.velt.dev/v2/workflow/definitions/list"
---
diff --git a/api-reference/rest-apis/v2/approval-engine/definitions/update-definition.mdx b/api-reference/rest-apis/v2/approval-engine/definitions/update-definition.mdx
index 615451010..1192e3cf9 100644
--- a/api-reference/rest-apis/v2/approval-engine/definitions/update-definition.mdx
+++ b/api-reference/rest-apis/v2/approval-engine/definitions/update-definition.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Definition"
+title: "Update approval definition (v2)"
+description: "Edit an existing approval workflow definition's nodes, edges, or parallel groups using the Velt v2 REST API. Changes are linted before being applied."
api: "POST https://api.velt.dev/v2/workflow/definitions/update"
---
diff --git a/api-reference/rest-apis/v2/approval-engine/executions/cancel-execution.mdx b/api-reference/rest-apis/v2/approval-engine/executions/cancel-execution.mdx
index cfa3a214f..864af0d49 100644
--- a/api-reference/rest-apis/v2/approval-engine/executions/cancel-execution.mdx
+++ b/api-reference/rest-apis/v2/approval-engine/executions/cancel-execution.mdx
@@ -1,5 +1,6 @@
---
-title: "Cancel Execution"
+title: "Cancel approval execution (v2)"
+description: "Cancel a running approval workflow execution by ID using the Velt v2 REST API to halt pending steps and mark the run as terminated."
api: "POST https://api.velt.dev/v2/workflow/executions/cancel"
---
diff --git a/api-reference/rest-apis/v2/approval-engine/executions/dispatch-execution.mdx b/api-reference/rest-apis/v2/approval-engine/executions/dispatch-execution.mdx
index 901cdde21..0dfa0bef0 100644
--- a/api-reference/rest-apis/v2/approval-engine/executions/dispatch-execution.mdx
+++ b/api-reference/rest-apis/v2/approval-engine/executions/dispatch-execution.mdx
@@ -1,5 +1,6 @@
---
-title: "Dispatch Execution"
+title: "Dispatch approval execution (v2)"
+description: "Start a new approval workflow execution from a definition using the Velt v2 REST API, passing inputs and context to launch a fresh run."
api: "POST https://api.velt.dev/v2/workflow/executions/dispatch"
---
diff --git a/api-reference/rest-apis/v2/approval-engine/executions/get-execution-events.mdx b/api-reference/rest-apis/v2/approval-engine/executions/get-execution-events.mdx
index c8f9ed080..5dd187749 100644
--- a/api-reference/rest-apis/v2/approval-engine/executions/get-execution-events.mdx
+++ b/api-reference/rest-apis/v2/approval-engine/executions/get-execution-events.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Execution Events"
+title: "Get approval execution events (v2)"
+description: "Fetch the ordered event stream for an approval workflow execution using the Velt v2 REST API to audit transitions, reviewer actions, and outcomes."
api: "POST https://api.velt.dev/v2/workflow/executions/getEvents"
---
diff --git a/api-reference/rest-apis/v2/approval-engine/executions/get-execution.mdx b/api-reference/rest-apis/v2/approval-engine/executions/get-execution.mdx
index 141cf5d68..6f57f0d8d 100644
--- a/api-reference/rest-apis/v2/approval-engine/executions/get-execution.mdx
+++ b/api-reference/rest-apis/v2/approval-engine/executions/get-execution.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Execution"
+title: "Get approval execution (v2)"
+description: "Retrieve a single approval workflow execution with current status, step states, and metadata by ID using the Velt v2 REST API for run inspection."
api: "POST https://api.velt.dev/v2/workflow/executions/get"
---
diff --git a/api-reference/rest-apis/v2/approval-engine/executions/list-executions.mdx b/api-reference/rest-apis/v2/approval-engine/executions/list-executions.mdx
index 3f0cc8ec7..486b34df0 100644
--- a/api-reference/rest-apis/v2/approval-engine/executions/list-executions.mdx
+++ b/api-reference/rest-apis/v2/approval-engine/executions/list-executions.mdx
@@ -1,5 +1,6 @@
---
-title: "List Executions"
+title: "List approval executions (v2)"
+description: "List approval workflow executions filtered by definition, status, or time range using the Velt v2 REST API to monitor runs and reporting dashboards."
api: "POST https://api.velt.dev/v2/workflow/executions/list"
---
diff --git a/api-reference/rest-apis/v2/approval-engine/steps/cancel-step.mdx b/api-reference/rest-apis/v2/approval-engine/steps/cancel-step.mdx
index 20f1e6136..56c52dc44 100644
--- a/api-reference/rest-apis/v2/approval-engine/steps/cancel-step.mdx
+++ b/api-reference/rest-apis/v2/approval-engine/steps/cancel-step.mdx
@@ -1,5 +1,6 @@
---
-title: "Cancel Step"
+title: "Cancel approval step (v2)"
+description: "Cancel an individual step within a running approval workflow execution using the Velt v2 REST API to skip pending reviewers or agent tasks."
api: "POST https://api.velt.dev/v2/workflow/steps/cancel"
---
diff --git a/api-reference/rest-apis/v2/approval-engine/steps/record-agent-resolution.mdx b/api-reference/rest-apis/v2/approval-engine/steps/record-agent-resolution.mdx
index 2dfbe8e39..9e713982b 100644
--- a/api-reference/rest-apis/v2/approval-engine/steps/record-agent-resolution.mdx
+++ b/api-reference/rest-apis/v2/approval-engine/steps/record-agent-resolution.mdx
@@ -1,5 +1,6 @@
---
-title: "Record Agent Resolution"
+title: "Record agent resolution (v2)"
+description: "Submit an AI agent's resolution for an approval step using the Velt v2 REST API to record agent verdicts, confidence, and reasoning back into the run."
api: "POST https://api.velt.dev/v2/workflow/steps/recordAgentResolution"
---
diff --git a/api-reference/rest-apis/v2/approval-engine/steps/record-reviewer-decision.mdx b/api-reference/rest-apis/v2/approval-engine/steps/record-reviewer-decision.mdx
index a8b38769d..55b6f2cec 100644
--- a/api-reference/rest-apis/v2/approval-engine/steps/record-reviewer-decision.mdx
+++ b/api-reference/rest-apis/v2/approval-engine/steps/record-reviewer-decision.mdx
@@ -1,5 +1,6 @@
---
-title: "Record Reviewer Decision"
+title: "Record reviewer decision (v2)"
+description: "Record a human reviewer's approve, reject, or comment decision on an approval step using the Velt v2 REST API to advance the workflow execution."
api: "POST https://api.velt.dev/v2/workflow/steps/recordReviewerDecision"
---
diff --git a/api-reference/rest-apis/v2/approval-engine/steps/resolve-step.mdx b/api-reference/rest-apis/v2/approval-engine/steps/resolve-step.mdx
index 5d0696b9a..8637cb177 100644
--- a/api-reference/rest-apis/v2/approval-engine/steps/resolve-step.mdx
+++ b/api-reference/rest-apis/v2/approval-engine/steps/resolve-step.mdx
@@ -1,5 +1,6 @@
---
-title: "Resolve Step"
+title: "Resolve approval step (v2)"
+description: "Mark an approval workflow step as resolved with a final outcome using the Velt v2 REST API to close out the step and progress to the next node."
api: "POST https://api.velt.dev/v2/workflow/steps/resolve"
---
diff --git a/api-reference/rest-apis/v2/auth/add-permissions.mdx b/api-reference/rest-apis/v2/auth/add-permissions.mdx
index 3fee8231b..45c03bb0a 100644
--- a/api-reference/rest-apis/v2/auth/add-permissions.mdx
+++ b/api-reference/rest-apis/v2/auth/add-permissions.mdx
@@ -1,5 +1,6 @@
---
-title: "Add Permissions"
+title: "Add user permissions (v2)"
+description: "Grant a user access roles (viewer or editor) on organizations, folders, or documents using the Velt v2 REST API for fine-grained authorization control."
api: "POST https://api.velt.dev/v2/auth/permissions/add"
---
diff --git a/api-reference/rest-apis/v2/auth/generate-signature.mdx b/api-reference/rest-apis/v2/auth/generate-signature.mdx
index 78ad09a80..2c883f1d4 100644
--- a/api-reference/rest-apis/v2/auth/generate-signature.mdx
+++ b/api-reference/rest-apis/v2/auth/generate-signature.mdx
@@ -1,5 +1,6 @@
---
-title: "Generate Signature"
+title: "Generate auth signature (v2)"
+description: "Generate a server-side signed payload signature using the Velt v2 REST API to securely authenticate end-user identity claims sent from your backend."
api: "POST https://api.velt.dev/v2/auth/generate_signature"
---
diff --git a/api-reference/rest-apis/v2/auth/generate-token.mdx b/api-reference/rest-apis/v2/auth/generate-token.mdx
index d23df6114..57b8098a9 100644
--- a/api-reference/rest-apis/v2/auth/generate-token.mdx
+++ b/api-reference/rest-apis/v2/auth/generate-token.mdx
@@ -1,5 +1,6 @@
---
-title: "Generate Token"
+title: "Generate auth token (v2)"
+description: "Mint a JWT auth token with user identity and resource permissions using the Velt v2 REST API to securely sign in users to organizations, folders, and documents."
api: "POST https://api.velt.dev/v2/auth/generate_token"
---
diff --git a/api-reference/rest-apis/v2/auth/get-permissions.mdx b/api-reference/rest-apis/v2/auth/get-permissions.mdx
index 7bbf9cba9..1e65b5d62 100644
--- a/api-reference/rest-apis/v2/auth/get-permissions.mdx
+++ b/api-reference/rest-apis/v2/auth/get-permissions.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Permissions"
+title: "Get user permissions (v2)"
+description: "Retrieve a user's current access roles across organizations, folders, and documents using the Velt v2 REST API for authorization checks and audits."
api: "POST https://api.velt.dev/v2/auth/permissions/get"
---
diff --git a/api-reference/rest-apis/v2/auth/remove-permissions.mdx b/api-reference/rest-apis/v2/auth/remove-permissions.mdx
index 0181c6ad8..05da0115e 100644
--- a/api-reference/rest-apis/v2/auth/remove-permissions.mdx
+++ b/api-reference/rest-apis/v2/auth/remove-permissions.mdx
@@ -1,5 +1,6 @@
---
-title: "Remove Permissions"
+title: "Remove user permissions (v2)"
+description: "Revoke a user's access roles on organizations, folders, or documents using the Velt v2 REST API to tighten authorization and offboard collaborators."
api: "POST https://api.velt.dev/v2/auth/permissions/remove"
---
diff --git a/api-reference/rest-apis/v2/comments-feature/comment-annotations/add-comment-annotations.mdx b/api-reference/rest-apis/v2/comments-feature/comment-annotations/add-comment-annotations.mdx
index bd8d35908..6daa12821 100644
--- a/api-reference/rest-apis/v2/comments-feature/comment-annotations/add-comment-annotations.mdx
+++ b/api-reference/rest-apis/v2/comments-feature/comment-annotations/add-comment-annotations.mdx
@@ -1,5 +1,6 @@
---
-title: "Add Comment Annotations"
+title: "Add comment annotations (v2)"
+description: "Create comment annotation threads anchored to documents using the Velt v2 REST API, with support for replies, mentions, and target element metadata."
api: "POST https://api.velt.dev/v2/commentannotations/add"
---
diff --git a/api-reference/rest-apis/v2/comments-feature/comment-annotations/delete-comment-annotations.mdx b/api-reference/rest-apis/v2/comments-feature/comment-annotations/delete-comment-annotations.mdx
index 635e88ce2..a2286e395 100644
--- a/api-reference/rest-apis/v2/comments-feature/comment-annotations/delete-comment-annotations.mdx
+++ b/api-reference/rest-apis/v2/comments-feature/comment-annotations/delete-comment-annotations.mdx
@@ -1,5 +1,6 @@
---
-title: "Delete Comment Annotations"
+title: "Delete comment annotations (v2)"
+description: "Permanently remove comment annotation threads and their replies from a document using the Velt v2 REST API for moderation and content cleanup."
api: "POST https://api.velt.dev/v2/commentannotations/delete"
---
diff --git a/api-reference/rest-apis/v2/comments-feature/comment-annotations/get-comment-annotations-count.mdx b/api-reference/rest-apis/v2/comments-feature/comment-annotations/get-comment-annotations-count.mdx
index 9089cf924..6013475c9 100644
--- a/api-reference/rest-apis/v2/comments-feature/comment-annotations/get-comment-annotations-count.mdx
+++ b/api-reference/rest-apis/v2/comments-feature/comment-annotations/get-comment-annotations-count.mdx
@@ -1,5 +1,6 @@
---
-title: 'Get Comment Annotations Count'
+title: "Get comment annotations count (v2)"
+description: "Get the total count of comment annotations on a document or across an organization using the Velt v2 REST API to power activity badges and dashboards."
api: 'POST https://api.velt.dev/v2/commentannotations/count/get'
---
diff --git a/api-reference/rest-apis/v2/comments-feature/comment-annotations/get-comment-annotations-v2.mdx b/api-reference/rest-apis/v2/comments-feature/comment-annotations/get-comment-annotations-v2.mdx
index 02eb683af..46613e1ab 100644
--- a/api-reference/rest-apis/v2/comments-feature/comment-annotations/get-comment-annotations-v2.mdx
+++ b/api-reference/rest-apis/v2/comments-feature/comment-annotations/get-comment-annotations-v2.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Comment Annotations"
+title: "Get comment annotations (v2)"
+description: "Fetch comment annotation threads with replies, mentions, and status filters using the Velt v2 REST API to render inline collaboration threads in your app."
api: "POST https://api.velt.dev/v2/commentannotations/get"
---
diff --git a/api-reference/rest-apis/v2/comments-feature/comment-annotations/update-comment-annotations.mdx b/api-reference/rest-apis/v2/comments-feature/comment-annotations/update-comment-annotations.mdx
index d727f4295..31202fe1d 100644
--- a/api-reference/rest-apis/v2/comments-feature/comment-annotations/update-comment-annotations.mdx
+++ b/api-reference/rest-apis/v2/comments-feature/comment-annotations/update-comment-annotations.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Comment Annotations"
+title: "Update comment annotations (v2)"
+description: "Update comment annotation properties such as status, priority, assignees, or labels using the Velt v2 REST API to manage collaboration threads server-side."
api: "POST https://api.velt.dev/v2/commentannotations/update"
---
diff --git a/api-reference/rest-apis/v2/comments-feature/comments/add-comments.mdx b/api-reference/rest-apis/v2/comments-feature/comments/add-comments.mdx
index 60e6c8ae8..32b4122ca 100644
--- a/api-reference/rest-apis/v2/comments-feature/comments/add-comments.mdx
+++ b/api-reference/rest-apis/v2/comments-feature/comments/add-comments.mdx
@@ -1,5 +1,6 @@
---
-title: "Add Comments"
+title: "Add comments (v2)"
+description: "Add a new comment or reply to an existing comment annotation thread using the Velt v2 REST API, with support for rich content, mentions, and attachments."
api: "POST https://api.velt.dev/v2/commentannotations/comments/add"
---
diff --git a/api-reference/rest-apis/v2/comments-feature/comments/delete-comments.mdx b/api-reference/rest-apis/v2/comments-feature/comments/delete-comments.mdx
index fcc39fcfd..254b7055a 100644
--- a/api-reference/rest-apis/v2/comments-feature/comments/delete-comments.mdx
+++ b/api-reference/rest-apis/v2/comments-feature/comments/delete-comments.mdx
@@ -1,5 +1,6 @@
---
-title: "Delete Comments"
+title: "Delete comments (v2)"
+description: "Delete individual comments or replies within a comment annotation thread using the Velt v2 REST API for moderation and content removal workflows."
api: "POST https://api.velt.dev/v2/commentannotations/comments/delete"
---
diff --git a/api-reference/rest-apis/v2/comments-feature/comments/get-comments.mdx b/api-reference/rest-apis/v2/comments-feature/comments/get-comments.mdx
index d55bd949a..40a3311e6 100644
--- a/api-reference/rest-apis/v2/comments-feature/comments/get-comments.mdx
+++ b/api-reference/rest-apis/v2/comments-feature/comments/get-comments.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Comments"
+title: "Get comments (v2)"
+description: "Retrieve individual comments and replies within comment annotation threads using the Velt v2 REST API for inspection, exports, and integrations."
api: "POST https://api.velt.dev/v2/commentannotations/comments/get"
---
diff --git a/api-reference/rest-apis/v2/comments-feature/comments/update-comments.mdx b/api-reference/rest-apis/v2/comments-feature/comments/update-comments.mdx
index 93abff050..6349c8c73 100644
--- a/api-reference/rest-apis/v2/comments-feature/comments/update-comments.mdx
+++ b/api-reference/rest-apis/v2/comments-feature/comments/update-comments.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Comments"
+title: "Update comments (v2)"
+description: "Edit the body, mentions, or metadata of an existing comment in a thread using the Velt v2 REST API to keep collaboration content accurate and current."
api: "POST https://api.velt.dev/v2/commentannotations/comments/update"
---
diff --git a/api-reference/rest-apis/v2/crdt/add-crdt-data.mdx b/api-reference/rest-apis/v2/crdt/add-crdt-data.mdx
index 24978045e..b55ecd99d 100644
--- a/api-reference/rest-apis/v2/crdt/add-crdt-data.mdx
+++ b/api-reference/rest-apis/v2/crdt/add-crdt-data.mdx
@@ -1,5 +1,6 @@
---
-title: "Add CRDT Data"
+title: "Add CRDT data (v2)"
+description: "Insert new CRDT documents for collaborative real-time state using the Velt v2 REST API to seed shared data across clients with conflict-free merges."
api: "POST https://api.velt.dev/v2/crdt/add"
---
diff --git a/api-reference/rest-apis/v2/crdt/get-crdt-data.mdx b/api-reference/rest-apis/v2/crdt/get-crdt-data.mdx
index 2843af1b6..572bdb6fd 100644
--- a/api-reference/rest-apis/v2/crdt/get-crdt-data.mdx
+++ b/api-reference/rest-apis/v2/crdt/get-crdt-data.mdx
@@ -1,5 +1,6 @@
---
-title: "Get CRDT Data"
+title: "Get CRDT data (v2)"
+description: "Read CRDT documents and their merged state using the Velt v2 REST API for server-side syncing, backups, and integrations with collaborative state."
api: "POST https://api.velt.dev/v2/crdt/get"
---
diff --git a/api-reference/rest-apis/v2/crdt/update-crdt-data.mdx b/api-reference/rest-apis/v2/crdt/update-crdt-data.mdx
index 10dced24c..9977507e0 100644
--- a/api-reference/rest-apis/v2/crdt/update-crdt-data.mdx
+++ b/api-reference/rest-apis/v2/crdt/update-crdt-data.mdx
@@ -1,5 +1,6 @@
---
-title: "Update CRDT Data"
+title: "Update CRDT data (v2)"
+description: "Apply updates to existing CRDT documents using the Velt v2 REST API to push server-side mutations into the conflict-free replicated data store."
api: "POST https://api.velt.dev/v2/crdt/update"
---
diff --git a/api-reference/rest-apis/v2/documents/add-documents.mdx b/api-reference/rest-apis/v2/documents/add-documents.mdx
index 8d5b4a005..84207fa13 100644
--- a/api-reference/rest-apis/v2/documents/add-documents.mdx
+++ b/api-reference/rest-apis/v2/documents/add-documents.mdx
@@ -1,5 +1,6 @@
---
-title: "Add Documents"
+title: "Add documents (v2)"
+description: "Create new documents under an organization with metadata and folder placement using the Velt v2 REST API to bootstrap collaboration resources at scale."
api: "POST https://api.velt.dev/v2/organizations/documents/add"
---
diff --git a/api-reference/rest-apis/v2/documents/delete-documents.mdx b/api-reference/rest-apis/v2/documents/delete-documents.mdx
index e6ae23849..a1faeda1a 100644
--- a/api-reference/rest-apis/v2/documents/delete-documents.mdx
+++ b/api-reference/rest-apis/v2/documents/delete-documents.mdx
@@ -1,5 +1,6 @@
---
-title: "Delete Documents"
+title: "Delete documents (v2)"
+description: "Permanently delete documents and their associated collaboration data from an organization using the Velt v2 REST API for cleanup and lifecycle automation."
api: "POST https://api.velt.dev/v2/organizations/documents/delete"
---
diff --git a/api-reference/rest-apis/v2/documents/get-documents-v2.mdx b/api-reference/rest-apis/v2/documents/get-documents-v2.mdx
index 8af3a5a9c..240182760 100644
--- a/api-reference/rest-apis/v2/documents/get-documents-v2.mdx
+++ b/api-reference/rest-apis/v2/documents/get-documents-v2.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Documents"
+title: "Get documents (v2)"
+description: "Retrieve documents within an organization filtered by IDs, folders, or metadata using the Velt v2 REST API for syncing, exports, and dashboards."
api: "POST https://api.velt.dev/v2/organizations/documents/get"
---
diff --git a/api-reference/rest-apis/v2/documents/migrate-documents-status.mdx b/api-reference/rest-apis/v2/documents/migrate-documents-status.mdx
index 0c254774c..f5fc3afea 100644
--- a/api-reference/rest-apis/v2/documents/migrate-documents-status.mdx
+++ b/api-reference/rest-apis/v2/documents/migrate-documents-status.mdx
@@ -1,5 +1,6 @@
---
-title: "Migrate Documents Status"
+title: "Get document migration status (v2)"
+description: "Check the progress and status of a bulk document migration job using the Velt v2 REST API to monitor long-running data transfers between organizations."
api: "POST https://api.velt.dev/v2/organizations/documents/migrate/status"
---
diff --git a/api-reference/rest-apis/v2/documents/migrate-documents.mdx b/api-reference/rest-apis/v2/documents/migrate-documents.mdx
index 98c854318..937f5e3f6 100644
--- a/api-reference/rest-apis/v2/documents/migrate-documents.mdx
+++ b/api-reference/rest-apis/v2/documents/migrate-documents.mdx
@@ -1,5 +1,6 @@
---
-title: "Migrate Documents"
+title: "Migrate documents (v2)"
+description: "Bulk migrate documents and their collaboration data between organizations or environments using the Velt v2 REST API for tenant moves and consolidations."
api: "POST https://api.velt.dev/v2/organizations/documents/migrate"
---
diff --git a/api-reference/rest-apis/v2/documents/move-documents.mdx b/api-reference/rest-apis/v2/documents/move-documents.mdx
index d37dcfa40..ffb9d7583 100644
--- a/api-reference/rest-apis/v2/documents/move-documents.mdx
+++ b/api-reference/rest-apis/v2/documents/move-documents.mdx
@@ -1,5 +1,6 @@
---
-title: "Move Documents"
+title: "Move documents (v2)"
+description: "Move documents between folders within an organization using the Velt v2 REST API to reorganize content hierarchies without losing comments or activity."
api: "POST https://api.velt.dev/v2/organizations/documents/move"
---
diff --git a/api-reference/rest-apis/v2/documents/update-document-access.mdx b/api-reference/rest-apis/v2/documents/update-document-access.mdx
index f68e50a6d..695411b9b 100644
--- a/api-reference/rest-apis/v2/documents/update-document-access.mdx
+++ b/api-reference/rest-apis/v2/documents/update-document-access.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Access for Documents"
+title: "Update document access (v2)"
+description: "Adjust document-level access roles and sharing rules for users or groups using the Velt v2 REST API to manage permissions and collaboration scope."
api: "POST https://api.velt.dev/v2/organizations/documents/access/update"
---
diff --git a/api-reference/rest-apis/v2/documents/update-document-disable-state.mdx b/api-reference/rest-apis/v2/documents/update-document-disable-state.mdx
index 43d95165b..402cde7f7 100644
--- a/api-reference/rest-apis/v2/documents/update-document-disable-state.mdx
+++ b/api-reference/rest-apis/v2/documents/update-document-disable-state.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Disabled State for Documents"
+title: "Update document disabled state (v2)"
+description: "Enable or disable a document's collaboration features such as comments and presence using the Velt v2 REST API to freeze or reopen activity per resource."
api: "POST https://api.velt.dev/v2/organizations/documents/access/disablestate/update"
---
diff --git a/api-reference/rest-apis/v2/documents/update-documents.mdx b/api-reference/rest-apis/v2/documents/update-documents.mdx
index 4d79f4422..32f7bc234 100644
--- a/api-reference/rest-apis/v2/documents/update-documents.mdx
+++ b/api-reference/rest-apis/v2/documents/update-documents.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Documents"
+title: "Update documents (v2)"
+description: "Update document metadata such as title, description, and custom fields using the Velt v2 REST API to keep collaboration resources in sync with your app."
api: "POST https://api.velt.dev/v2/organizations/documents/update"
---
diff --git a/api-reference/rest-apis/v2/folders/add-folder.mdx b/api-reference/rest-apis/v2/folders/add-folder.mdx
index 623a7fa1e..c0c975fce 100644
--- a/api-reference/rest-apis/v2/folders/add-folder.mdx
+++ b/api-reference/rest-apis/v2/folders/add-folder.mdx
@@ -1,5 +1,6 @@
---
-title: "Add Folder"
+title: "Add folder (v2)"
+description: "Create a new folder under an organization using the Velt v2 REST API to organize documents into hierarchies and scope access for collaborators."
api: "POST https://api.velt.dev/v2/organizations/folders/add"
---
diff --git a/api-reference/rest-apis/v2/folders/delete-folder.mdx b/api-reference/rest-apis/v2/folders/delete-folder.mdx
index 6a5975f1b..0781b2aef 100644
--- a/api-reference/rest-apis/v2/folders/delete-folder.mdx
+++ b/api-reference/rest-apis/v2/folders/delete-folder.mdx
@@ -1,5 +1,6 @@
---
-title: "Delete Folder"
+title: "Delete folder (v2)"
+description: "Delete a folder and optionally its child documents from an organization using the Velt v2 REST API for cleanup and content-hierarchy maintenance."
api: "POST https://api.velt.dev/v2/organizations/folders/delete"
---
diff --git a/api-reference/rest-apis/v2/folders/get-folders.mdx b/api-reference/rest-apis/v2/folders/get-folders.mdx
index 423ac69d7..aa21e7794 100644
--- a/api-reference/rest-apis/v2/folders/get-folders.mdx
+++ b/api-reference/rest-apis/v2/folders/get-folders.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Folders"
+title: "Get folders (v2)"
+description: "Retrieve folders within an organization filtered by IDs or parent using the Velt v2 REST API to render navigation trees and content browsers in your app."
api: "POST https://api.velt.dev/v2/organizations/folders/get"
---
diff --git a/api-reference/rest-apis/v2/folders/update-folder-access.mdx b/api-reference/rest-apis/v2/folders/update-folder-access.mdx
index e64b6c633..19cdba071 100644
--- a/api-reference/rest-apis/v2/folders/update-folder-access.mdx
+++ b/api-reference/rest-apis/v2/folders/update-folder-access.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Access for Folders"
+title: "Update folder access (v2)"
+description: "Adjust folder-level access roles and sharing rules for users or groups using the Velt v2 REST API to govern collaboration on grouped documents."
api: "POST https://api.velt.dev/v2/organizations/folders/access/update"
---
diff --git a/api-reference/rest-apis/v2/folders/update-folder.mdx b/api-reference/rest-apis/v2/folders/update-folder.mdx
index 5bf7cea18..26df3d755 100644
--- a/api-reference/rest-apis/v2/folders/update-folder.mdx
+++ b/api-reference/rest-apis/v2/folders/update-folder.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Folder"
+title: "Update folder (v2)"
+description: "Edit folder metadata like name, description, or parent placement using the Velt v2 REST API to keep your content hierarchy organized and labeled."
api: "POST https://api.velt.dev/v2/organizations/folders/update"
---
diff --git a/api-reference/rest-apis/v2/gdpr/delete-all-user-data-gdpr.mdx b/api-reference/rest-apis/v2/gdpr/delete-all-user-data-gdpr.mdx
index edf2af467..ddb4a59ae 100644
--- a/api-reference/rest-apis/v2/gdpr/delete-all-user-data-gdpr.mdx
+++ b/api-reference/rest-apis/v2/gdpr/delete-all-user-data-gdpr.mdx
@@ -1,6 +1,6 @@
---
-title: "Delete All User Data"
-description: "Remove All User data from Velt."
+title: "Delete all user data (v2)"
+description: "Permanently remove all of a user's stored data from Velt for GDPR compliance using the v2 REST API to honor data deletion and right-to-be-forgotten requests."
api: "POST https://api.velt.dev/v2/users/data/delete"
---
diff --git a/api-reference/rest-apis/v2/gdpr/get-all-user-data-gdpr.mdx b/api-reference/rest-apis/v2/gdpr/get-all-user-data-gdpr.mdx
index a25c4372d..c7fd21b4d 100644
--- a/api-reference/rest-apis/v2/gdpr/get-all-user-data-gdpr.mdx
+++ b/api-reference/rest-apis/v2/gdpr/get-all-user-data-gdpr.mdx
@@ -1,6 +1,6 @@
---
-title: "Get All User Data"
-description: "Get all feature data for a user stored in Velt."
+title: "Get all user data (v2)"
+description: "Export all feature data stored in Velt for a single user using the v2 REST API to support GDPR data-access, portability, and subject-access requests."
api: "POST https://api.velt.dev/v2/users/data/get"
---
diff --git a/api-reference/rest-apis/v2/gdpr/get-delete-user-data-status-gdpr.mdx b/api-reference/rest-apis/v2/gdpr/get-delete-user-data-status-gdpr.mdx
index 0ef81b63b..66cba9c82 100644
--- a/api-reference/rest-apis/v2/gdpr/get-delete-user-data-status-gdpr.mdx
+++ b/api-reference/rest-apis/v2/gdpr/get-delete-user-data-status-gdpr.mdx
@@ -1,6 +1,6 @@
---
-title: "Get Delete All User Data Status"
-description: "Get the status of the data deletion process for a user."
+title: "Get user data deletion status (v2)"
+description: "Check the progress of a GDPR user-data deletion job using the Velt v2 REST API to track completion status, errors, and remaining items in the deletion queue."
api: "POST https://api.velt.dev/v2/users/data/delete/status"
---
diff --git a/api-reference/rest-apis/v2/livestate/broadcast-event.mdx b/api-reference/rest-apis/v2/livestate/broadcast-event.mdx
index 6d05b9045..5bfd78782 100644
--- a/api-reference/rest-apis/v2/livestate/broadcast-event.mdx
+++ b/api-reference/rest-apis/v2/livestate/broadcast-event.mdx
@@ -1,5 +1,6 @@
---
-title: "Broadcast Event"
+title: "Broadcast live state event (v2)"
+description: "Broadcast custom real-time events to connected clients on a document or channel using the Velt v2 REST API to power live state, presence, and notifications."
api: "POST https://api.velt.dev/v2/livestate/broadcast"
---
diff --git a/api-reference/rest-apis/v2/memory/alerts/action.mdx b/api-reference/rest-apis/v2/memory/alerts/action.mdx
index fbd93c40e..6c9176772 100644
--- a/api-reference/rest-apis/v2/memory/alerts/action.mdx
+++ b/api-reference/rest-apis/v2/memory/alerts/action.mdx
@@ -1,5 +1,6 @@
---
-title: "Mark Alert Actioned"
+title: "Mark memory alert actioned (v2)"
+description: "Mark a Memory alert as actioned with an outcome note using the Velt v2 REST API to track follow-up on AI-driven review trend notifications."
api: "POST https://api.velt.dev/v2/memory/alerts/action"
---
diff --git a/api-reference/rest-apis/v2/memory/alerts/config/get.mdx b/api-reference/rest-apis/v2/memory/alerts/config/get.mdx
index 2e7e626ec..9d1cd2e3e 100644
--- a/api-reference/rest-apis/v2/memory/alerts/config/get.mdx
+++ b/api-reference/rest-apis/v2/memory/alerts/config/get.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Alert Config"
+title: "Get memory alert config (v2)"
+description: "Fetch the current Memory alert configuration including thresholds and channels using the Velt v2 REST API to inspect alerting rules for review trends."
api: "POST https://api.velt.dev/v2/memory/alerts/config/get"
---
diff --git a/api-reference/rest-apis/v2/memory/alerts/config/update.mdx b/api-reference/rest-apis/v2/memory/alerts/config/update.mdx
index 04c307c8c..bdc76ba4a 100644
--- a/api-reference/rest-apis/v2/memory/alerts/config/update.mdx
+++ b/api-reference/rest-apis/v2/memory/alerts/config/update.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Alert Config"
+title: "Update memory alert config (v2)"
+description: "Update Memory alert thresholds, channels, and routing rules using the Velt v2 REST API to tune proactive notifications for review trend monitoring."
api: "POST https://api.velt.dev/v2/memory/alerts/config/update"
---
diff --git a/api-reference/rest-apis/v2/memory/alerts/dismiss.mdx b/api-reference/rest-apis/v2/memory/alerts/dismiss.mdx
index bceacc6aa..a637cc1a2 100644
--- a/api-reference/rest-apis/v2/memory/alerts/dismiss.mdx
+++ b/api-reference/rest-apis/v2/memory/alerts/dismiss.mdx
@@ -1,5 +1,6 @@
---
-title: "Dismiss Alert"
+title: "Dismiss memory alert (v2)"
+description: "Dismiss a Memory alert so it no longer appears in the active list using the Velt v2 REST API to clear handled review-trend notifications from the queue."
api: "POST https://api.velt.dev/v2/memory/alerts/dismiss"
---
diff --git a/api-reference/rest-apis/v2/memory/alerts/list.mdx b/api-reference/rest-apis/v2/memory/alerts/list.mdx
index 720493e82..f4f673147 100644
--- a/api-reference/rest-apis/v2/memory/alerts/list.mdx
+++ b/api-reference/rest-apis/v2/memory/alerts/list.mdx
@@ -1,5 +1,6 @@
---
-title: "List Alerts"
+title: "List memory alerts (v2)"
+description: "List active Memory alerts (up to 50) about review trends such as approval-rate drift using the Velt v2 REST API to surface proactive notifications in your app."
api: "POST https://api.velt.dev/v2/memory/alerts/list"
---
diff --git a/api-reference/rest-apis/v2/memory/ask.mdx b/api-reference/rest-apis/v2/memory/ask.mdx
index 2025db49e..3d456bb6c 100644
--- a/api-reference/rest-apis/v2/memory/ask.mdx
+++ b/api-reference/rest-apis/v2/memory/ask.mdx
@@ -1,5 +1,6 @@
---
-title: "Ask Memory"
+title: "Ask memory (v2)"
+description: "Send a natural-language query to Velt Memory and get grounded answers from your knowledge sources using the v2 REST API for AI-powered review assistance."
api: "POST https://api.velt.dev/v2/memory/ask"
---
diff --git a/api-reference/rest-apis/v2/memory/judgments/query.mdx b/api-reference/rest-apis/v2/memory/judgments/query.mdx
index b0e8682e4..2ccc06687 100644
--- a/api-reference/rest-apis/v2/memory/judgments/query.mdx
+++ b/api-reference/rest-apis/v2/memory/judgments/query.mdx
@@ -1,5 +1,6 @@
---
-title: "Query Judgments"
+title: "Query memory judgments (v2)"
+description: "Query Memory reviewer judgments by filters such as outcome, reviewer, or time range using the Velt v2 REST API to analyze decisions and approval trends."
api: "POST https://api.velt.dev/v2/memory/judgments/query"
---
diff --git a/api-reference/rest-apis/v2/memory/knowledge/delete.mdx b/api-reference/rest-apis/v2/memory/knowledge/delete.mdx
index 1eb1c851f..ec62fffbb 100644
--- a/api-reference/rest-apis/v2/memory/knowledge/delete.mdx
+++ b/api-reference/rest-apis/v2/memory/knowledge/delete.mdx
@@ -1,5 +1,6 @@
---
-title: "Delete Knowledge"
+title: "Delete memory knowledge source (v2)"
+description: "Hard-delete a Memory knowledge source and all its chunks and rules using the Velt v2 REST API. Processing or referenced sources return FAILED_PRECONDITION."
api: "POST https://api.velt.dev/v2/memory/knowledge/delete"
---
diff --git a/api-reference/rest-apis/v2/memory/knowledge/download.mdx b/api-reference/rest-apis/v2/memory/knowledge/download.mdx
index 95107e762..a74a6f68a 100644
--- a/api-reference/rest-apis/v2/memory/knowledge/download.mdx
+++ b/api-reference/rest-apis/v2/memory/knowledge/download.mdx
@@ -1,5 +1,6 @@
---
-title: "Download Canonical Markdown"
+title: "Download canonical markdown (v2)"
+description: "Download the canonical markdown extracted from a Memory knowledge source using the Velt v2 REST API. Returns null if extraction is still in progress."
api: "POST https://api.velt.dev/v2/memory/knowledge/download"
---
diff --git a/api-reference/rest-apis/v2/memory/knowledge/ingest-status.mdx b/api-reference/rest-apis/v2/memory/knowledge/ingest-status.mdx
index 80d463d2d..5f39ab599 100644
--- a/api-reference/rest-apis/v2/memory/knowledge/ingest-status.mdx
+++ b/api-reference/rest-apis/v2/memory/knowledge/ingest-status.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Ingest Status"
+title: "Get knowledge ingest status (v2)"
+description: "Poll the status of a Memory knowledge ingestion job started via the ingest endpoint using the Velt v2 REST API to track parsing, chunking, and indexing."
api: "POST https://api.velt.dev/v2/memory/knowledge/ingest-status"
---
diff --git a/api-reference/rest-apis/v2/memory/knowledge/ingest.mdx b/api-reference/rest-apis/v2/memory/knowledge/ingest.mdx
index 182cd203e..a58819a06 100644
--- a/api-reference/rest-apis/v2/memory/knowledge/ingest.mdx
+++ b/api-reference/rest-apis/v2/memory/knowledge/ingest.mdx
@@ -1,5 +1,6 @@
---
-title: "Ingest Knowledge"
+title: "Ingest memory knowledge (v2)"
+description: "Submit a new knowledge source for ingestion into Velt Memory using the v2 REST API to extract, chunk, and index content for grounded AI answers and judgments."
api: "POST https://api.velt.dev/v2/memory/knowledge/ingest"
---
diff --git a/api-reference/rest-apis/v2/memory/knowledge/list.mdx b/api-reference/rest-apis/v2/memory/knowledge/list.mdx
index 07059957e..73200fd87 100644
--- a/api-reference/rest-apis/v2/memory/knowledge/list.mdx
+++ b/api-reference/rest-apis/v2/memory/knowledge/list.mdx
@@ -1,5 +1,6 @@
---
title: "List Knowledge Sources"
+description: "List your Velt Memory v2 knowledge sources, each with ingestion status, embedding state, and signed download URLs for completed files."
api: "POST https://api.velt.dev/v2/memory/knowledge/list"
---
diff --git a/api-reference/rest-apis/v2/memory/knowledge/rules.mdx b/api-reference/rest-apis/v2/memory/knowledge/rules.mdx
index ab18135fd..bb3f0714f 100644
--- a/api-reference/rest-apis/v2/memory/knowledge/rules.mdx
+++ b/api-reference/rest-apis/v2/memory/knowledge/rules.mdx
@@ -1,5 +1,6 @@
---
title: "List Extracted Rules"
+description: "List the policy rules extracted from a rule-based knowledge source in Velt Memory v2, including rule text, IDs, and source metadata."
api: "POST https://api.velt.dev/v2/memory/knowledge/rules"
---
diff --git a/api-reference/rest-apis/v2/memory/knowledge/search.mdx b/api-reference/rest-apis/v2/memory/knowledge/search.mdx
index ff662074c..ea5d90447 100644
--- a/api-reference/rest-apis/v2/memory/knowledge/search.mdx
+++ b/api-reference/rest-apis/v2/memory/knowledge/search.mdx
@@ -1,5 +1,6 @@
---
title: "Search Knowledge Base"
+description: "Run a workspace-scoped semantic vector search over ingested knowledge base content in Velt Memory v2 to retrieve relevant chunks and citations."
api: "POST https://api.velt.dev/v2/memory/knowledge/search"
---
diff --git a/api-reference/rest-apis/v2/memory/knowledge/update.mdx b/api-reference/rest-apis/v2/memory/knowledge/update.mdx
index bbb69c958..8178c2f75 100644
--- a/api-reference/rest-apis/v2/memory/knowledge/update.mdx
+++ b/api-reference/rest-apis/v2/memory/knowledge/update.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Knowledge"
+title: "Update Knowledge Source"
+description: "Replace a Velt Memory v2 knowledge source's content and re-run the conversion, rule extraction, and embedding pipeline, bumping its version."
api: "POST https://api.velt.dev/v2/memory/knowledge/update"
---
diff --git a/api-reference/rest-apis/v2/memory/knowledge/upload-url.mdx b/api-reference/rest-apis/v2/memory/knowledge/upload-url.mdx
index fffe45e68..de2db46e7 100644
--- a/api-reference/rest-apis/v2/memory/knowledge/upload-url.mdx
+++ b/api-reference/rest-apis/v2/memory/knowledge/upload-url.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Upload URL"
+title: "Get Knowledge Upload URL"
+description: "Mint a short-lived signed upload URL (up to 30 MB) for the Velt Memory v2 by-reference ingestion flow, returning a fileRef for ingestion."
api: "POST https://api.velt.dev/v2/memory/knowledge/upload-url"
---
diff --git a/api-reference/rest-apis/v2/memory/patterns/get.mdx b/api-reference/rest-apis/v2/memory/patterns/get.mdx
index eca9872cd..7a7754d69 100644
--- a/api-reference/rest-apis/v2/memory/patterns/get.mdx
+++ b/api-reference/rest-apis/v2/memory/patterns/get.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Patterns"
+title: "Get Decision Patterns"
+description: "List decision patterns detected by Velt Memory v2 across accumulated review judgments in a workspace, revealing reviewer policies and trends."
api: "POST https://api.velt.dev/v2/memory/patterns/get"
---
diff --git a/api-reference/rest-apis/v2/memory/profiles/get.mdx b/api-reference/rest-apis/v2/memory/profiles/get.mdx
index c6f666db9..780dfb00c 100644
--- a/api-reference/rest-apis/v2/memory/profiles/get.mdx
+++ b/api-reference/rest-apis/v2/memory/profiles/get.mdx
@@ -1,5 +1,6 @@
---
title: "Get Reviewer Profile"
+description: "Fetch a reviewer's behavioral profile from Velt Memory v2: judgment volume, approval rate, review speed, top flags, content types, and peak hours."
api: "POST https://api.velt.dev/v2/memory/profiles/get"
---
diff --git a/api-reference/rest-apis/v2/memory/search.mdx b/api-reference/rest-apis/v2/memory/search.mdx
index ead68fb8e..c015f7f8f 100644
--- a/api-reference/rest-apis/v2/memory/search.mdx
+++ b/api-reference/rest-apis/v2/memory/search.mdx
@@ -1,5 +1,6 @@
---
title: "Search Judgments"
+description: "Run a semantic vector search over past review judgments in Velt Memory v2, with optional filters by decision, reviewer, content type, or recency."
api: "POST https://api.velt.dev/v2/memory/search"
---
diff --git a/api-reference/rest-apis/v2/memory/stats/get.mdx b/api-reference/rest-apis/v2/memory/stats/get.mdx
index 33a036712..8dc0a67da 100644
--- a/api-reference/rest-apis/v2/memory/stats/get.mdx
+++ b/api-reference/rest-apis/v2/memory/stats/get.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Stats"
+title: "Get Memory Stats"
+description: "Fetch aggregate Velt Memory v2 counts for a workspace, including totals for judgments, knowledge sources, patterns, and reviewer profiles."
api: "POST https://api.velt.dev/v2/memory/stats/get"
---
diff --git a/api-reference/rest-apis/v2/memory/suggest.mdx b/api-reference/rest-apis/v2/memory/suggest.mdx
index c2d2a8f1b..8e89349cd 100644
--- a/api-reference/rest-apis/v2/memory/suggest.mdx
+++ b/api-reference/rest-apis/v2/memory/suggest.mdx
@@ -1,5 +1,6 @@
---
title: "Suggest Decision"
+description: "Compute a suggested review decision in Velt Memory v2 grounded in past judgments, returning a primary recommendation and a conflict signal when split."
api: "POST https://api.velt.dev/v2/memory/suggest"
---
diff --git a/api-reference/rest-apis/v2/notifications/add-notifications.mdx b/api-reference/rest-apis/v2/notifications/add-notifications.mdx
index 2613c02ea..334594eae 100644
--- a/api-reference/rest-apis/v2/notifications/add-notifications.mdx
+++ b/api-reference/rest-apis/v2/notifications/add-notifications.mdx
@@ -1,5 +1,6 @@
---
title: "Add Notifications"
+description: "Create in-app notifications for users in a Velt workspace via the v2 REST API, including recipient targeting, message body, and metadata."
api: "POST https://api.velt.dev/v2/notifications/add"
---
diff --git a/api-reference/rest-apis/v2/notifications/delete-notifications.mdx b/api-reference/rest-apis/v2/notifications/delete-notifications.mdx
index d88dbd2ed..ec7ca9b35 100644
--- a/api-reference/rest-apis/v2/notifications/delete-notifications.mdx
+++ b/api-reference/rest-apis/v2/notifications/delete-notifications.mdx
@@ -1,5 +1,6 @@
---
title: "Delete Notifications"
+description: "Delete one or more in-app notifications from a Velt workspace using the v2 REST API by notification ID, recipient, or document filter."
api: "POST https://api.velt.dev/v2/notifications/delete"
---
diff --git a/api-reference/rest-apis/v2/notifications/get-config.mdx b/api-reference/rest-apis/v2/notifications/get-config.mdx
index 776b6248d..533c19ae7 100644
--- a/api-reference/rest-apis/v2/notifications/get-config.mdx
+++ b/api-reference/rest-apis/v2/notifications/get-config.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Config"
+title: "Get Notifications Config"
+description: "Retrieve the workspace notifications configuration in Velt v2, including channel toggles, default preferences, and delivery rules for in-app notifications."
api: "POST https://api.velt.dev/v2/notifications/config/get"
---
diff --git a/api-reference/rest-apis/v2/notifications/get-notifications-v2.mdx b/api-reference/rest-apis/v2/notifications/get-notifications-v2.mdx
index 6b14556f3..7ece73458 100644
--- a/api-reference/rest-apis/v2/notifications/get-notifications-v2.mdx
+++ b/api-reference/rest-apis/v2/notifications/get-notifications-v2.mdx
@@ -1,5 +1,6 @@
---
title: "Get Notifications"
+description: "Retrieve in-app notifications from a Velt workspace using the v2 REST API, with filters by recipient user, document, organization, and pagination."
api: "POST https://api.velt.dev/v2/notifications/get"
---
diff --git a/api-reference/rest-apis/v2/notifications/set-config.mdx b/api-reference/rest-apis/v2/notifications/set-config.mdx
index 8016fc408..eeaa7827c 100644
--- a/api-reference/rest-apis/v2/notifications/set-config.mdx
+++ b/api-reference/rest-apis/v2/notifications/set-config.mdx
@@ -1,5 +1,6 @@
---
-title: "Set Config"
+title: "Set Notifications Config"
+description: "Set or replace the workspace notifications configuration in Velt v2, controlling channel toggles, defaults, and delivery rules for in-app notifications."
api: "POST https://api.velt.dev/v2/notifications/config/set"
---
diff --git a/api-reference/rest-apis/v2/notifications/update-notifications.mdx b/api-reference/rest-apis/v2/notifications/update-notifications.mdx
index 50b6e9260..9200422bc 100644
--- a/api-reference/rest-apis/v2/notifications/update-notifications.mdx
+++ b/api-reference/rest-apis/v2/notifications/update-notifications.mdx
@@ -1,5 +1,6 @@
---
title: "Update Notifications"
+description: "Update in-app notifications in a Velt workspace via the v2 REST API, modifying read state, message content, recipients, or custom metadata."
api: "POST https://api.velt.dev/v2/notifications/update"
---
diff --git a/api-reference/rest-apis/v2/organizations/add-organizations.mdx b/api-reference/rest-apis/v2/organizations/add-organizations.mdx
index e09833160..551c63193 100644
--- a/api-reference/rest-apis/v2/organizations/add-organizations.mdx
+++ b/api-reference/rest-apis/v2/organizations/add-organizations.mdx
@@ -1,5 +1,6 @@
---
title: "Add Organizations"
+description: "Create one or more organizations in a Velt workspace using the v2 REST API, including organization IDs, names, and custom metadata fields."
api: "POST https://api.velt.dev/v2/organizations/add"
---
diff --git a/api-reference/rest-apis/v2/organizations/delete-organizations.mdx b/api-reference/rest-apis/v2/organizations/delete-organizations.mdx
index cc189e622..45fbf61ee 100644
--- a/api-reference/rest-apis/v2/organizations/delete-organizations.mdx
+++ b/api-reference/rest-apis/v2/organizations/delete-organizations.mdx
@@ -1,5 +1,6 @@
---
title: "Delete Organizations"
+description: "Delete specific organizations and their data from a Velt workspace by organization ID using the v2 REST API for tenant cleanup and offboarding."
api: "POST https://api.velt.dev/v2/organizations/delete"
---
diff --git a/api-reference/rest-apis/v2/organizations/get-organizations-v2.mdx b/api-reference/rest-apis/v2/organizations/get-organizations-v2.mdx
index a7ead3285..0272e7476 100644
--- a/api-reference/rest-apis/v2/organizations/get-organizations-v2.mdx
+++ b/api-reference/rest-apis/v2/organizations/get-organizations-v2.mdx
@@ -1,5 +1,6 @@
---
title: "Get Organizations"
+description: "Retrieve organizations from a Velt workspace by organization ID using the v2 REST API, returning organization metadata, names, and configuration."
api: "POST https://api.velt.dev/v2/organizations/get"
---
diff --git a/api-reference/rest-apis/v2/organizations/update-organization-disable-state.mdx b/api-reference/rest-apis/v2/organizations/update-organization-disable-state.mdx
index 921487124..3f6bc9f03 100644
--- a/api-reference/rest-apis/v2/organizations/update-organization-disable-state.mdx
+++ b/api-reference/rest-apis/v2/organizations/update-organization-disable-state.mdx
@@ -1,5 +1,6 @@
---
-title: "Update Disabled State for Organizations"
+title: "Update Organization Disabled State"
+description: "Enable or disable access for one or more organizations in a Velt workspace using the v2 REST API to restrict or restore Velt features."
api: "POST https://api.velt.dev/v2/organizations/access/disablestate/update"
---
diff --git a/api-reference/rest-apis/v2/organizations/update-organizations.mdx b/api-reference/rest-apis/v2/organizations/update-organizations.mdx
index 442cdcfc5..08a03549d 100644
--- a/api-reference/rest-apis/v2/organizations/update-organizations.mdx
+++ b/api-reference/rest-apis/v2/organizations/update-organizations.mdx
@@ -1,5 +1,6 @@
---
title: "Update Organizations"
+description: "Update metadata for one or more organizations in a Velt workspace using the v2 REST API, including names, descriptions, and custom organization fields."
api: "POST https://api.velt.dev/v2/organizations/update"
---
diff --git a/api-reference/rest-apis/v2/presence/add-presence.mdx b/api-reference/rest-apis/v2/presence/add-presence.mdx
index a2cb30f71..578c061d1 100644
--- a/api-reference/rest-apis/v2/presence/add-presence.mdx
+++ b/api-reference/rest-apis/v2/presence/add-presence.mdx
@@ -1,5 +1,6 @@
---
title: "Add Presence"
+description: "Add users to the presence list for a document within an organization using the Velt v2 REST API to show who is currently active or viewing."
api: "POST https://api.velt.dev/v2/presence/add"
---
diff --git a/api-reference/rest-apis/v2/presence/delete-presence.mdx b/api-reference/rest-apis/v2/presence/delete-presence.mdx
index 209a9d0c6..35c2b5483 100644
--- a/api-reference/rest-apis/v2/presence/delete-presence.mdx
+++ b/api-reference/rest-apis/v2/presence/delete-presence.mdx
@@ -1,5 +1,6 @@
---
title: "Delete Presence"
+description: "Remove users from the presence list for a document within an organization using the Velt v2 REST API to update who appears as active."
api: "POST https://api.velt.dev/v2/presence/delete"
---
diff --git a/api-reference/rest-apis/v2/presence/update-presence.mdx b/api-reference/rest-apis/v2/presence/update-presence.mdx
index 19629c58d..16e9ce499 100644
--- a/api-reference/rest-apis/v2/presence/update-presence.mdx
+++ b/api-reference/rest-apis/v2/presence/update-presence.mdx
@@ -1,5 +1,6 @@
---
title: "Update Presence"
+description: "Update presence data for existing users on a document within an organization using the Velt v2 REST API, including status, metadata, and timestamps."
api: "POST https://api.velt.dev/v2/presence/update"
---
diff --git a/api-reference/rest-apis/v2/recordings/get-recordings.mdx b/api-reference/rest-apis/v2/recordings/get-recordings.mdx
index a94ee95a6..569ea634b 100644
--- a/api-reference/rest-apis/v2/recordings/get-recordings.mdx
+++ b/api-reference/rest-apis/v2/recordings/get-recordings.mdx
@@ -1,5 +1,6 @@
---
title: "Get Recordings"
+description: "Retrieve recording annotations for a document or organization with the Velt v2 REST API, with optional filtering by recording ID and pagination."
api: "POST https://api.velt.dev/v2/recordings/get"
---
diff --git a/api-reference/rest-apis/v2/rewriter/ask-ai.mdx b/api-reference/rest-apis/v2/rewriter/ask-ai.mdx
index 8f27c3f79..fce1a1206 100644
--- a/api-reference/rest-apis/v2/rewriter/ask-ai.mdx
+++ b/api-reference/rest-apis/v2/rewriter/ask-ai.mdx
@@ -1,5 +1,6 @@
---
-title: "Ask AI"
+title: "Ask AI Rewriter"
+description: "Send a text rewriting or processing prompt to an AI model through the Velt v2 REST API; the model provider is resolved from the model name prefix."
api: "POST https://api.velt.dev/v2/rewriter/ask-ai"
---
diff --git a/api-reference/rest-apis/v2/user-groups/add-groups.mdx b/api-reference/rest-apis/v2/user-groups/add-groups.mdx
index a72210c4c..7946f0e03 100644
--- a/api-reference/rest-apis/v2/user-groups/add-groups.mdx
+++ b/api-reference/rest-apis/v2/user-groups/add-groups.mdx
@@ -1,5 +1,6 @@
---
title: "Add User Groups"
+description: "Create organization user groups in a Velt workspace using the v2 REST API, including group IDs and metadata for permission and notification routing."
api: "POST https://api.velt.dev/v2/organizations/usergroups/add"
---
diff --git a/api-reference/rest-apis/v2/user-groups/add-users-to-group.mdx b/api-reference/rest-apis/v2/user-groups/add-users-to-group.mdx
index 9154b28d9..1905e4ddc 100644
--- a/api-reference/rest-apis/v2/user-groups/add-users-to-group.mdx
+++ b/api-reference/rest-apis/v2/user-groups/add-users-to-group.mdx
@@ -1,5 +1,6 @@
---
title: "Add Users to Groups"
+description: "Add one or more users to an organization user group in a Velt workspace using the v2 REST API to manage group membership and access scopes."
api: "POST https://api.velt.dev/v2/organizations/usergroups/users/add"
---
diff --git a/api-reference/rest-apis/v2/user-groups/delete-users-from-group.mdx b/api-reference/rest-apis/v2/user-groups/delete-users-from-group.mdx
index dd49853d1..89d28febe 100644
--- a/api-reference/rest-apis/v2/user-groups/delete-users-from-group.mdx
+++ b/api-reference/rest-apis/v2/user-groups/delete-users-from-group.mdx
@@ -1,5 +1,6 @@
---
title: "Delete Users from Groups"
+description: "Remove one or more users from an organization user group in a Velt workspace using the v2 REST API to revoke group membership and access."
api: "POST https://api.velt.dev/v2/organizations/usergroups/users/delete"
---
diff --git a/api-reference/rest-apis/v2/users/add-users.mdx b/api-reference/rest-apis/v2/users/add-users.mdx
index f3dd94163..068affc48 100644
--- a/api-reference/rest-apis/v2/users/add-users.mdx
+++ b/api-reference/rest-apis/v2/users/add-users.mdx
@@ -1,5 +1,6 @@
---
title: "Add Users"
+description: "Add users to an organization, document, or folder in a Velt workspace using the v2 REST API, including user IDs, names, and custom metadata."
api: "POST https://api.velt.dev/v2/users/add"
---
diff --git a/api-reference/rest-apis/v2/users/delete-users.mdx b/api-reference/rest-apis/v2/users/delete-users.mdx
index 9702635fd..cad00e8fd 100644
--- a/api-reference/rest-apis/v2/users/delete-users.mdx
+++ b/api-reference/rest-apis/v2/users/delete-users.mdx
@@ -1,6 +1,6 @@
---
title: "Delete Users"
-description: "Remove Users from an Organization or a Document."
+description: "Remove users from an organization, document, or folder in a Velt workspace using the v2 REST API, with support for filtering by user IDs and scope."
api: "POST https://api.velt.dev/v2/users/delete"
---
diff --git a/api-reference/rest-apis/v2/users/get-users-v2.mdx b/api-reference/rest-apis/v2/users/get-users-v2.mdx
index 15819d63a..314857574 100644
--- a/api-reference/rest-apis/v2/users/get-users-v2.mdx
+++ b/api-reference/rest-apis/v2/users/get-users-v2.mdx
@@ -1,5 +1,6 @@
---
title: "Get Users"
+description: "Retrieve users from a Velt workspace using the v2 REST API with filters by organization ID, document ID, user group IDs, or user IDs."
api: "POST https://api.velt.dev/v2/users/get"
---
diff --git a/api-reference/rest-apis/v2/users/update-users.mdx b/api-reference/rest-apis/v2/users/update-users.mdx
index 3ce1a9a45..937465082 100644
--- a/api-reference/rest-apis/v2/users/update-users.mdx
+++ b/api-reference/rest-apis/v2/users/update-users.mdx
@@ -1,5 +1,6 @@
---
title: "Update Users"
+description: "Update user metadata in a Velt workspace using the v2 REST API, filtering by organization ID, document ID, folder ID, or user IDs."
api: "POST https://api.velt.dev/v2/users/update"
---
diff --git a/api-reference/rest-apis/v2/workspace/activityconfig-get.mdx b/api-reference/rest-apis/v2/workspace/activityconfig-get.mdx
index 30d0629e6..49bdd50e1 100644
--- a/api-reference/rest-apis/v2/workspace/activityconfig-get.mdx
+++ b/api-reference/rest-apis/v2/workspace/activityconfig-get.mdx
@@ -1,5 +1,6 @@
---
title: "Get Activity Config"
+description: "Retrieve the current activity logs configuration for a Velt workspace using the v2 REST API, including enabled state, retention, and service settings."
api: "POST https://api.velt.dev/v2/workspace/activityconfig/get"
---
diff --git a/api-reference/rest-apis/v2/workspace/activityconfig-update.mdx b/api-reference/rest-apis/v2/workspace/activityconfig-update.mdx
index 0c2a21623..59746ae21 100644
--- a/api-reference/rest-apis/v2/workspace/activityconfig-update.mdx
+++ b/api-reference/rest-apis/v2/workspace/activityconfig-update.mdx
@@ -1,5 +1,6 @@
---
title: "Update Activity Config"
+description: "Update the activity logs configuration for a Velt workspace using the v2 REST API; the config is deep-merged so omitted sub-fields are preserved."
api: "POST https://api.velt.dev/v2/workspace/activityconfig/update"
---
diff --git a/api-reference/rest-apis/v2/workspace/add-domain.mdx b/api-reference/rest-apis/v2/workspace/add-domain.mdx
index 65b236d5f..45f75780c 100644
--- a/api-reference/rest-apis/v2/workspace/add-domain.mdx
+++ b/api-reference/rest-apis/v2/workspace/add-domain.mdx
@@ -1,5 +1,6 @@
---
-title: "Add Domains"
+title: "Add Allowed Domains"
+description: "Add one or more domains to the allowed domains list for a Velt workspace using the v2 REST API to control which origins can use your API keys."
api: "POST https://api.velt.dev/v2/workspace/domains/add"
---
diff --git a/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-create.mdx b/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-create.mdx
index b1c3d2cd5..a6b5d65f6 100644
--- a/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-create.mdx
+++ b/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-create.mdx
@@ -1,5 +1,6 @@
---
title: "Create Advanced Webhook Endpoint"
+description: "Create a new advanced webhook delivery endpoint in a Velt workspace using the v2 REST API to receive event payloads at your destination URL."
api: "POST https://api.velt.dev/v2/workspace/advancedwebhook/endpoints/create"
---
diff --git a/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-delete.mdx b/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-delete.mdx
index 2a4a43da0..c8e61a2e4 100644
--- a/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-delete.mdx
+++ b/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-delete.mdx
@@ -1,5 +1,6 @@
---
title: "Delete Advanced Webhook Endpoint"
+description: "Delete an advanced webhook delivery endpoint from a Velt workspace using the v2 REST API to stop receiving event payloads at that destination URL."
api: "POST https://api.velt.dev/v2/workspace/advancedwebhook/endpoints/delete"
---
diff --git a/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-get.mdx b/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-get.mdx
index bbde3da27..4c1c2ac01 100644
--- a/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-get.mdx
+++ b/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-get.mdx
@@ -1,5 +1,6 @@
---
title: "Get Advanced Webhook Endpoints"
+description: "List the advanced webhook delivery endpoints configured for a Velt workspace using the v2 REST API, with pagination via an opaque iterator cursor."
api: "POST https://api.velt.dev/v2/workspace/advancedwebhook/endpoints/get"
---
diff --git a/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-secret-get.mdx b/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-secret-get.mdx
index aa7e9b927..2d5219a6a 100644
--- a/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-secret-get.mdx
+++ b/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-secret-get.mdx
@@ -1,5 +1,6 @@
---
title: "Get Advanced Webhook Endpoint Secret"
+description: "Retrieve the signing secret for a Velt v2 advanced webhook endpoint so you can verify the signature of webhook payloads delivered to your service."
api: "POST https://api.velt.dev/v2/workspace/advancedwebhook/endpoints/secret/get"
---
diff --git a/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-update.mdx b/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-update.mdx
index 43438920d..9f078e2a4 100644
--- a/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-update.mdx
+++ b/api-reference/rest-apis/v2/workspace/advancedwebhook-endpoints-update.mdx
@@ -1,5 +1,6 @@
---
title: "Update Advanced Webhook Endpoint"
+description: "Update an existing advanced webhook delivery endpoint in a Velt workspace via the v2 REST API; at least one field besides endpointId must be provided."
api: "POST https://api.velt.dev/v2/workspace/advancedwebhook/endpoints/update"
---
diff --git a/api-reference/rest-apis/v2/workspace/advancedwebhookconfig-get.mdx b/api-reference/rest-apis/v2/workspace/advancedwebhookconfig-get.mdx
index 9b32e6e19..e59adf9fc 100644
--- a/api-reference/rest-apis/v2/workspace/advancedwebhookconfig-get.mdx
+++ b/api-reference/rest-apis/v2/workspace/advancedwebhookconfig-get.mdx
@@ -1,5 +1,6 @@
---
title: "Get Advanced Webhook Config"
+description: "Retrieve the advanced webhook configuration for a Velt workspace using the v2 REST API, including enable state, encryption, and data protection flags."
api: "POST https://api.velt.dev/v2/workspace/advancedwebhookconfig/get"
---
diff --git a/api-reference/rest-apis/v2/workspace/advancedwebhookconfig-update.mdx b/api-reference/rest-apis/v2/workspace/advancedwebhookconfig-update.mdx
index 401b30251..4802ecd7a 100644
--- a/api-reference/rest-apis/v2/workspace/advancedwebhookconfig-update.mdx
+++ b/api-reference/rest-apis/v2/workspace/advancedwebhookconfig-update.mdx
@@ -1,5 +1,6 @@
---
title: "Update Advanced Webhook Config"
+description: "Update the advanced webhook configuration for a Velt workspace via the v2 REST API, toggling enable state, encryption, encoding, and data protection."
api: "POST https://api.velt.dev/v2/workspace/advancedwebhookconfig/update"
---
diff --git a/api-reference/rest-apis/v2/workspace/apikey-create.mdx b/api-reference/rest-apis/v2/workspace/apikey-create.mdx
index 926108101..70392fb8d 100644
--- a/api-reference/rest-apis/v2/workspace/apikey-create.mdx
+++ b/api-reference/rest-apis/v2/workspace/apikey-create.mdx
@@ -1,5 +1,6 @@
---
title: "Create API Key"
+description: "Create a new API key for a Velt workspace using the v2 REST API, returning the key value and associated auth token for client and server use."
api: "POST https://api.velt.dev/v2/workspace/apikey/create"
---
diff --git a/api-reference/rest-apis/v2/workspace/apikey-update.mdx b/api-reference/rest-apis/v2/workspace/apikey-update.mdx
index bb80d56a5..28d5e505d 100644
--- a/api-reference/rest-apis/v2/workspace/apikey-update.mdx
+++ b/api-reference/rest-apis/v2/workspace/apikey-update.mdx
@@ -1,5 +1,6 @@
---
title: "Update API Key"
+description: "Update the display name of an existing Velt workspace API key using the v2 REST API to keep keys organized across environments and projects."
api: "POST https://api.velt.dev/v2/workspace/apikey/update"
---
diff --git a/api-reference/rest-apis/v2/workspace/apikeyconfig-get.mdx b/api-reference/rest-apis/v2/workspace/apikeyconfig-get.mdx
index 8cb4b58f8..7c57c4f05 100644
--- a/api-reference/rest-apis/v2/workspace/apikeyconfig-get.mdx
+++ b/api-reference/rest-apis/v2/workspace/apikeyconfig-get.mdx
@@ -1,5 +1,6 @@
---
title: "Get API Key Config"
+description: "Retrieve the app configuration for a Velt v2 workspace API key: owner email, plan info, default document access, JWT and auto-org-user toggles."
api: "POST https://api.velt.dev/v2/workspace/apikeyconfig/get"
---
diff --git a/api-reference/rest-apis/v2/workspace/apikeyconfig-update.mdx b/api-reference/rest-apis/v2/workspace/apikeyconfig-update.mdx
index bb8d9e331..fea080a06 100644
--- a/api-reference/rest-apis/v2/workspace/apikeyconfig-update.mdx
+++ b/api-reference/rest-apis/v2/workspace/apikeyconfig-update.mdx
@@ -1,5 +1,6 @@
---
title: "Update API Key Config"
+description: "Update the app configuration for a Velt v2 workspace API key with field-merge semantics; every field is optional but at least one must be provided."
api: "POST https://api.velt.dev/v2/workspace/apikeyconfig/update"
---
diff --git a/api-reference/rest-apis/v2/workspace/apikeys-get.mdx b/api-reference/rest-apis/v2/workspace/apikeys-get.mdx
index 91b7c77f4..a646ff615 100644
--- a/api-reference/rest-apis/v2/workspace/apikeys-get.mdx
+++ b/api-reference/rest-apis/v2/workspace/apikeys-get.mdx
@@ -1,5 +1,6 @@
---
title: "Get API Keys"
+description: "Retrieve the list of API keys configured for a Velt workspace using the v2 REST API, including key IDs, names, and associated metadata for auditing."
api: "POST https://api.velt.dev/v2/workspace/apikeys/get"
---
diff --git a/api-reference/rest-apis/v2/workspace/authtoken-reset.mdx b/api-reference/rest-apis/v2/workspace/authtoken-reset.mdx
index 545d81e28..67446ed32 100644
--- a/api-reference/rest-apis/v2/workspace/authtoken-reset.mdx
+++ b/api-reference/rest-apis/v2/workspace/authtoken-reset.mdx
@@ -1,5 +1,6 @@
---
title: "Reset Auth Token"
+description: "Reset the auth token associated with a specific Velt workspace API key using the v2 REST API to rotate credentials and revoke compromised tokens."
api: "POST https://api.velt.dev/v2/workspace/authtoken/reset"
---
diff --git a/api-reference/rest-apis/v2/workspace/authtokens-get.mdx b/api-reference/rest-apis/v2/workspace/authtokens-get.mdx
index 294425890..1797f8c4b 100644
--- a/api-reference/rest-apis/v2/workspace/authtokens-get.mdx
+++ b/api-reference/rest-apis/v2/workspace/authtokens-get.mdx
@@ -1,5 +1,6 @@
---
title: "Get Auth Tokens"
+description: "Retrieve all auth tokens associated with a specific Velt workspace API key using the v2 REST API for credential auditing and key management."
api: "POST https://api.velt.dev/v2/workspace/authtokens/get"
---
diff --git a/api-reference/rest-apis/v2/workspace/create.mdx b/api-reference/rest-apis/v2/workspace/create.mdx
index f29728ce9..1e7e997f5 100644
--- a/api-reference/rest-apis/v2/workspace/create.mdx
+++ b/api-reference/rest-apis/v2/workspace/create.mdx
@@ -1,5 +1,6 @@
---
title: "Create Workspace"
+description: "Programmatically create a new Velt workspace via the v2 REST API; protected by IP-based rate limiting and disposable email domain blocking."
api: "POST https://api.velt.dev/v2/workspace/create"
---
diff --git a/api-reference/rest-apis/v2/workspace/delete-domain.mdx b/api-reference/rest-apis/v2/workspace/delete-domain.mdx
index fa74b52ab..8cba1e6d5 100644
--- a/api-reference/rest-apis/v2/workspace/delete-domain.mdx
+++ b/api-reference/rest-apis/v2/workspace/delete-domain.mdx
@@ -1,5 +1,6 @@
---
-title: "Delete Domains"
+title: "Delete Allowed Domains"
+description: "Remove domains from a Velt workspace's allowed origins list using the v2 REST API to revoke origins permitted to use your API keys in the browser."
api: "POST https://api.velt.dev/v2/workspace/domains/delete"
---
diff --git a/api-reference/rest-apis/v2/workspace/domains-get.mdx b/api-reference/rest-apis/v2/workspace/domains-get.mdx
index 4aa716cbd..8c1ab0bc6 100644
--- a/api-reference/rest-apis/v2/workspace/domains-get.mdx
+++ b/api-reference/rest-apis/v2/workspace/domains-get.mdx
@@ -1,5 +1,6 @@
---
-title: "Get Domains"
+title: "Get Allowed Domains"
+description: "Retrieve the list of allowed domains configured for a Velt workspace using the v2 REST API to review which origins can use your API keys."
api: "POST https://api.velt.dev/v2/workspace/domains/get"
---
diff --git a/api-reference/rest-apis/v2/workspace/email-status.mdx b/api-reference/rest-apis/v2/workspace/email-status.mdx
index db22e6074..4bb247ae5 100644
--- a/api-reference/rest-apis/v2/workspace/email-status.mdx
+++ b/api-reference/rest-apis/v2/workspace/email-status.mdx
@@ -1,5 +1,6 @@
---
title: "Get Email Verification Status"
+description: "Check whether a given email address has been verified for Velt workspace ownership using the v2 REST API as part of the workspace signup flow."
api: "POST https://api.velt.dev/v2/workspace/email/status"
---
diff --git a/api-reference/rest-apis/v2/workspace/emailconfig-get.mdx b/api-reference/rest-apis/v2/workspace/emailconfig-get.mdx
index 0605562c6..12659452a 100644
--- a/api-reference/rest-apis/v2/workspace/emailconfig-get.mdx
+++ b/api-reference/rest-apis/v2/workspace/emailconfig-get.mdx
@@ -1,5 +1,6 @@
---
title: "Get Email Config"
+description: "Retrieve the current email service configuration for a Velt workspace using the v2 REST API, including provider settings and enable state."
api: "POST https://api.velt.dev/v2/workspace/emailconfig/get"
---
diff --git a/api-reference/rest-apis/v2/workspace/emailconfig-update.mdx b/api-reference/rest-apis/v2/workspace/emailconfig-update.mdx
index 329a51b7b..21ff4a0a0 100644
--- a/api-reference/rest-apis/v2/workspace/emailconfig-update.mdx
+++ b/api-reference/rest-apis/v2/workspace/emailconfig-update.mdx
@@ -1,5 +1,6 @@
---
title: "Update Email Config"
+description: "Update the email service configuration for a Velt workspace using the v2 REST API; at least one of useEmailService or emailServiceConfig must be provided."
api: "POST https://api.velt.dev/v2/workspace/emailconfig/update"
---
diff --git a/api-reference/rest-apis/v2/workspace/get.mdx b/api-reference/rest-apis/v2/workspace/get.mdx
index 4e8cc76f9..b105c3d87 100644
--- a/api-reference/rest-apis/v2/workspace/get.mdx
+++ b/api-reference/rest-apis/v2/workspace/get.mdx
@@ -1,5 +1,6 @@
---
title: "Get Workspace"
+description: "Retrieve details of an existing Velt workspace using the v2 REST API, including workspace metadata, owner info, plan, and configuration summary."
api: "POST https://api.velt.dev/v2/workspace/get"
---
diff --git a/api-reference/rest-apis/v2/workspace/notificationconfig-get.mdx b/api-reference/rest-apis/v2/workspace/notificationconfig-get.mdx
index 762cb568c..fa27383b6 100644
--- a/api-reference/rest-apis/v2/workspace/notificationconfig-get.mdx
+++ b/api-reference/rest-apis/v2/workspace/notificationconfig-get.mdx
@@ -1,5 +1,6 @@
---
title: "Get Notification Config"
+description: "Retrieve the current in-app notification service configuration for a Velt workspace using the v2 REST API, including enable state and service settings."
api: "POST https://api.velt.dev/v2/workspace/notificationconfig/get"
---
diff --git a/api-reference/rest-apis/v2/workspace/notificationconfig-update.mdx b/api-reference/rest-apis/v2/workspace/notificationconfig-update.mdx
index b4f345e5e..8713cab41 100644
--- a/api-reference/rest-apis/v2/workspace/notificationconfig-update.mdx
+++ b/api-reference/rest-apis/v2/workspace/notificationconfig-update.mdx
@@ -1,5 +1,6 @@
---
title: "Update Notification Config"
+description: "Update the in-app notification service configuration for a Velt workspace via the v2 REST API; the config is deep-merged so omitted sub-fields are preserved."
api: "POST https://api.velt.dev/v2/workspace/notificationconfig/update"
---
diff --git a/api-reference/rest-apis/v2/workspace/permissionproviderconfig-get.mdx b/api-reference/rest-apis/v2/workspace/permissionproviderconfig-get.mdx
index 41ee0f636..55396f7c9 100644
--- a/api-reference/rest-apis/v2/workspace/permissionproviderconfig-get.mdx
+++ b/api-reference/rest-apis/v2/workspace/permissionproviderconfig-get.mdx
@@ -1,5 +1,6 @@
---
title: "Get Permission Provider Config"
+description: "Retrieve the current permission provider configuration for a Velt workspace using the v2 REST API, including provider URL, auth token, and enable state."
api: "POST https://api.velt.dev/v2/workspace/permissionproviderconfig/get"
---
diff --git a/api-reference/rest-apis/v2/workspace/permissionproviderconfig-update.mdx b/api-reference/rest-apis/v2/workspace/permissionproviderconfig-update.mdx
index 3e9da9e70..ff161fd80 100644
--- a/api-reference/rest-apis/v2/workspace/permissionproviderconfig-update.mdx
+++ b/api-reference/rest-apis/v2/workspace/permissionproviderconfig-update.mdx
@@ -1,5 +1,6 @@
---
title: "Update Permission Provider Config"
+description: "Update the permission provider configuration for a Velt workspace via the v2 REST API; the config is merged so existing values like authToken are preserved."
api: "POST https://api.velt.dev/v2/workspace/permissionproviderconfig/update"
---
diff --git a/api-reference/rest-apis/v2/workspace/send-login-link.mdx b/api-reference/rest-apis/v2/workspace/send-login-link.mdx
index 9f97eb658..2c9fb4bae 100644
--- a/api-reference/rest-apis/v2/workspace/send-login-link.mdx
+++ b/api-reference/rest-apis/v2/workspace/send-login-link.mdx
@@ -1,5 +1,6 @@
---
title: "Send Login Link"
+description: "Send a magic login link to a Velt workspace owner's email address using the v2 REST API to authenticate access to the Velt console without a password."
api: "POST https://api.velt.dev/v2/workspace/email/send-login-link"
---
diff --git a/api-reference/rest-apis/v2/workspace/webhookconfig-get.mdx b/api-reference/rest-apis/v2/workspace/webhookconfig-get.mdx
index 34f201bc9..23224a85b 100644
--- a/api-reference/rest-apis/v2/workspace/webhookconfig-get.mdx
+++ b/api-reference/rest-apis/v2/workspace/webhookconfig-get.mdx
@@ -1,5 +1,6 @@
---
title: "Get Webhook Config"
+description: "Retrieve the current webhook service configuration for a Velt workspace using the v2 REST API, including endpoint URL, enable state, and event settings."
api: "POST https://api.velt.dev/v2/workspace/webhookconfig/get"
---
diff --git a/api-reference/rest-apis/v2/workspace/webhookconfig-update.mdx b/api-reference/rest-apis/v2/workspace/webhookconfig-update.mdx
index e14349c86..3f84526f8 100644
--- a/api-reference/rest-apis/v2/workspace/webhookconfig-update.mdx
+++ b/api-reference/rest-apis/v2/workspace/webhookconfig-update.mdx
@@ -1,5 +1,6 @@
---
title: "Update Webhook Config"
+description: "Update the webhook service configuration for a Velt workspace using the v2 REST API; at least one of useWebhookService or webhookServiceConfig is required."
api: "POST https://api.velt.dev/v2/workspace/webhookconfig/update"
---
diff --git a/api-reference/sdk/api/api-methods.mdx b/api-reference/sdk/api/api-methods.mdx
index 736b9f196..bf2b641b3 100644
--- a/api-reference/sdk/api/api-methods.mdx
+++ b/api-reference/sdk/api/api-methods.mdx
@@ -1,5 +1,6 @@
---
-title : "API Methods Index"
+title: "API Methods Index"
+description: "Complete index of Velt SDK API methods for comments, presence, notifications, cursors, recordings, and more, with links to docs and React hooks."
---
# Comments
diff --git a/api-reference/sdk/api/react-hooks.mdx b/api-reference/sdk/api/react-hooks.mdx
index d3926e2ee..950764aca 100644
--- a/api-reference/sdk/api/react-hooks.mdx
+++ b/api-reference/sdk/api/react-hooks.mdx
@@ -1,5 +1,6 @@
---
title: "React Hooks Index"
+description: "Complete index of Velt SDK React hooks for comments, presence, notifications, cursors, recordings, and more, with links to docs and API methods."
---
# Comments
diff --git a/api-reference/sdk/models/data-models.mdx b/api-reference/sdk/models/data-models.mdx
index bdc338fc5..db43e9fe7 100644
--- a/api-reference/sdk/models/data-models.mdx
+++ b/api-reference/sdk/models/data-models.mdx
@@ -1,3 +1,8 @@
+---
+title: "Data Models Index"
+description: "Reference for Velt SDK data models including CommentAnnotation, Comment, User, request and event types used across comments, presence, and notifications."
+---
+
# Comments
### Threads
diff --git a/async-collaboration/activity/customize-behavior.mdx b/async-collaboration/activity/customize-behavior.mdx
index a0fc209d2..a548bf221 100644
--- a/async-collaboration/activity/customize-behavior.mdx
+++ b/async-collaboration/activity/customize-behavior.mdx
@@ -1,5 +1,6 @@
---
-title: "Customize Behavior"
+title: "Customize Activity Logs behavior"
+description: "Customize Velt Activity Logs with subscription filters by document, feature type, and action type, plus options to scope feeds and render custom timelines."
---
#### getAllActivities
diff --git a/async-collaboration/activity/overview.mdx b/async-collaboration/activity/overview.mdx
index 5cfe6b079..8411f2f27 100644
--- a/async-collaboration/activity/overview.mdx
+++ b/async-collaboration/activity/overview.mdx
@@ -1,6 +1,7 @@
---
title: "Activity Logs"
sidebarTitle: "Overview"
+description: "Track every collaboration event with real-time activity logs for comments, reactions, edits, and custom events across your product in one unified timeline."
---
Every collaboration event in your app, every comment, approval, edit, and review, generates a question someone eventually asks: "Who did what, and when?" Activity Logs gives you a complete, real-time record of everything that happens across your product.
diff --git a/async-collaboration/activity/setup.mdx b/async-collaboration/activity/setup.mdx
index f6ae08ca8..f2f7007e2 100644
--- a/async-collaboration/activity/setup.mdx
+++ b/async-collaboration/activity/setup.mdx
@@ -1,5 +1,6 @@
---
-title: "Setup"
+title: "Activity Logs setup"
+description: "Install and configure Velt Activity Logs to render a filterable timeline component, emit custom activity records, and stream real-time event feeds in your app."
---
diff --git a/async-collaboration/arrows/customize-behavior.mdx b/async-collaboration/arrows/customize-behavior.mdx
index 67009834d..6f2433581 100644
--- a/async-collaboration/arrows/customize-behavior.mdx
+++ b/async-collaboration/arrows/customize-behavior.mdx
@@ -1,5 +1,6 @@
---
-title: "Customize Behavior"
+title: "Customize Arrows behavior"
+description: "Configure Velt Arrows with allowed element IDs, custom containers, and Arrow Element APIs to control where and how arrow annotations can be placed."
---
diff --git a/async-collaboration/arrows/overview.mdx b/async-collaboration/arrows/overview.mdx
index 5f5139c4d..2de6d19c1 100644
--- a/async-collaboration/arrows/overview.mdx
+++ b/async-collaboration/arrows/overview.mdx
@@ -1,6 +1,7 @@
---
title: "Arrows"
sidebarTitle: "Overview"
+description: "Add interactive arrow annotations that let users point, highlight, and direct attention to specific elements in your app for clearer async collaboration."
---
diff --git a/async-collaboration/arrows/setup.mdx b/async-collaboration/arrows/setup.mdx
index 4bfbecc6e..569f53dc4 100644
--- a/async-collaboration/arrows/setup.mdx
+++ b/async-collaboration/arrows/setup.mdx
@@ -1,5 +1,6 @@
---
-title: "Setup"
+title: "Arrows setup"
+description: "Install Velt Arrows by adding the VeltArrows and VeltArrowTool components to your React, Next.js, or HTML app to enable visual pointer annotations."
---
diff --git a/async-collaboration/comments-sidebar/overview.mdx b/async-collaboration/comments-sidebar/overview.mdx
index 9ca7fd0fb..93846ffa2 100644
--- a/async-collaboration/comments-sidebar/overview.mdx
+++ b/async-collaboration/comments-sidebar/overview.mdx
@@ -1,7 +1,7 @@
---
title: "Comments Sidebar"
sidebarTitle: "Overview"
-description: "Provide a toggleable sidebar to view and filter comments."
+description: "Add a toggleable Comments Sidebar to view, filter, sort, and search all comments across your app with built-in components for opening and managing threads."
---
The Velt SDK contains 4 components that can be used to control the Comments Sidebar functionality:
diff --git a/async-collaboration/comments-sidebar/v1/customize-behavior.mdx b/async-collaboration/comments-sidebar/v1/customize-behavior.mdx
index 520c3f4e0..0d5992f8b 100644
--- a/async-collaboration/comments-sidebar/v1/customize-behavior.mdx
+++ b/async-collaboration/comments-sidebar/v1/customize-behavior.mdx
@@ -1,5 +1,6 @@
---
-title: "Customize Behavior"
+title: "Customize Comments Sidebar V1 behavior"
+description: "Customize the V1 Comments Sidebar with filters, sorting, grouping, custom actions, lifecycle events, and wireframe overrides to tailor the comments panel."
---
# Custom filtering, sorting and grouping
diff --git a/async-collaboration/comments-sidebar/v1/setup.mdx b/async-collaboration/comments-sidebar/v1/setup.mdx
index 53fb7595c..deb4c17bf 100644
--- a/async-collaboration/comments-sidebar/v1/setup.mdx
+++ b/async-collaboration/comments-sidebar/v1/setup.mdx
@@ -1,5 +1,6 @@
---
-title: "Setup"
+title: "Comments Sidebar V1 setup"
+description: "Install the V1 Comments Sidebar by adding VeltCommentsSidebar, VeltSidebarButton, and VeltCommentTool components to surface comment threads in your app."
---
diff --git a/async-collaboration/comments-sidebar/v2/customize-behavior.mdx b/async-collaboration/comments-sidebar/v2/customize-behavior.mdx
index 661610afb..6ec2eced9 100644
--- a/async-collaboration/comments-sidebar/v2/customize-behavior.mdx
+++ b/async-collaboration/comments-sidebar/v2/customize-behavior.mdx
@@ -1,5 +1,6 @@
---
-title: "Customize Behavior"
+title: "Customize Comments Sidebar V2 behavior"
+description: "Configure the V2 Comments Sidebar with declarative filters, mini filters, sort, group, and search inputs plus client-side filter APIs for full control."
---
# Filtering
diff --git a/async-collaboration/comments-sidebar/v2/setup.mdx b/async-collaboration/comments-sidebar/v2/setup.mdx
index 31b3be6af..87771f83c 100644
--- a/async-collaboration/comments-sidebar/v2/setup.mdx
+++ b/async-collaboration/comments-sidebar/v2/setup.mdx
@@ -1,5 +1,6 @@
---
-title: "Setup"
+title: "Comments Sidebar V2 setup"
+description: "Install the V2 primitive-based Comments Sidebar with VeltCommentsSidebarV2 for a customizable, composable comments panel in React, Next.js, and HTML."
---
The V2 sidebar is a fully primitive-based implementation. Import `VeltCommentsSidebarV2` directly to use it.
diff --git a/async-collaboration/comments/customize-behavior.mdx b/async-collaboration/comments/customize-behavior.mdx
index 6d7b13b5e..fd6fab820 100644
--- a/async-collaboration/comments/customize-behavior.mdx
+++ b/async-collaboration/comments/customize-behavior.mdx
@@ -1,5 +1,6 @@
---
-title: "Customize Behavior"
+title: "Customize Comments behavior"
+description: "Customize Velt Comments with APIs to add, edit, delete annotations, manage threads, replies, mentions, statuses, priorities, and assignees programmatically."
---
# Threads
diff --git a/async-collaboration/comments/notifications.mdx b/async-collaboration/comments/notifications.mdx
index 4b05d582b..9ea09d957 100644
--- a/async-collaboration/comments/notifications.mdx
+++ b/async-collaboration/comments/notifications.mdx
@@ -1,6 +1,6 @@
---
title: "Notifications"
-description: "There are several options to send notifications to your users."
+description: "Send comment notifications to users via in-app banners, email digests, and webhooks to channels like Slack to keep collaborators informed of new activity."
---
There are three ways to send notifications to your users:
diff --git a/async-collaboration/comments/overview.mdx b/async-collaboration/comments/overview.mdx
index 4404a479c..f02cedbfd 100644
--- a/async-collaboration/comments/overview.mdx
+++ b/async-collaboration/comments/overview.mdx
@@ -1,7 +1,7 @@
---
title: "Comments"
sidebarTitle: "Overview"
-description: "Your users can add comments in context to ask questions, leave feedback, report bugs etc. We handle all complexity to ensure the comments are robust against content changes. We support many types of comment UX patterns as illustrated below."
+description: "Add in-context comments, replies, mentions, and annotations to any app with support for freestyle pins, area comments, inline text, and more UX patterns."
---
diff --git a/async-collaboration/comments/setup/ace.mdx b/async-collaboration/comments/setup/ace.mdx
index e62fc3cfe..903683082 100644
--- a/async-collaboration/comments/setup/ace.mdx
+++ b/async-collaboration/comments/setup/ace.mdx
@@ -1,5 +1,6 @@
---
-title: "Ace Editor Setup"
+title: "Ace Editor comments setup"
+description: "Integrate Velt Comments with the Ace code editor to enable inline text comments, mentions, and replies on specific lines or selections of source code."
---

diff --git a/async-collaboration/comments/setup/apryse.mdx b/async-collaboration/comments/setup/apryse.mdx
index f4c52ab80..6e8e23f36 100644
--- a/async-collaboration/comments/setup/apryse.mdx
+++ b/async-collaboration/comments/setup/apryse.mdx
@@ -1,5 +1,6 @@
---
-title: "Apryse Setup"
+title: "Apryse WebViewer comments setup"
+description: "Add Velt Comments to the Apryse WebViewer PDF viewer in React to enable in-context annotations, replies, and mentions on PDF documents and pages."
---

diff --git a/async-collaboration/comments/setup/canvas-comments/overview.mdx b/async-collaboration/comments/setup/canvas-comments/overview.mdx
index eae70bb61..cacccdd16 100644
--- a/async-collaboration/comments/setup/canvas-comments/overview.mdx
+++ b/async-collaboration/comments/setup/canvas-comments/overview.mdx
@@ -1,5 +1,6 @@
---
-title: "Overview"
+title: "Canvas and chart comments overview"
+description: "Add Velt comment pins to charting libraries and canvas surfaces by manually positioning Comment Pin components using custom metadata and annotation hooks."
---
Within any charts library you have the option to manually set the position of a Comment Annotation using the `Comment Pin` component.
diff --git a/async-collaboration/comments/setup/canvas.mdx b/async-collaboration/comments/setup/canvas.mdx
index 6b34f289d..b27db7d58 100644
--- a/async-collaboration/comments/setup/canvas.mdx
+++ b/async-collaboration/comments/setup/canvas.mdx
@@ -1,6 +1,6 @@
---
-title: "