@gpt-platform/client 0.3.3 → 0.4.0

package/llms.txt

@@ -24,1001 +24,1069 @@ client.setConfig({
 
 ## Access log
 
-- `getAccess-logs()` - List access logs
-- `getAccess-logsById()` - Get access logs
+- `getAccess-logs()` - /access-logs operation on access_log resource
+- `getAccess-logsById()` - /access-logs/:id operation on access_log resource
 
 ## Agent stats
 
-- `getAgentsByIdStats()` - Get stats
+- `getAgentsByIdStats()` - /agents/:id/stats operation on agent_stats resource
 
 ## Agent test result
 
-- `postAgent-test-results()` - Create agent test results
+- `postAgent-test-results()` - Run an agent version against a document and return the test result
 
 ## Agent training stats
 
-- `getAgentsByIdTraining-stats()` - Get training stats
+- `getAgentsByIdTraining-stats()` - /agents/:id/training-stats operation on agent_training_stats resource
 
 ## Agent usage
 
-- `getAgentsByIdUsage()` - Get usage
-- `getAgentsUsage()` - List usage
+- `getAgentsByIdUsage()` - /agents/:id/usage operation on agent_usage resource
+- `getAgentsUsage()` - Batch read usage for all accessible agents
 
 ## Agent version comparison
 
-- `postAgent-version-comparisons()` - Create agent version comparisons
+- `postAgent-version-comparisons()` - Compare two agent versions and return the differences
 
 ## Agent version revision
 
-- `getAgent-version-revisions()` - List agent version revisions
-- `getAgent-version-revisionsById()` - Get agent version revisions
+- `getAgent-version-revisions()` - /agent-version-revisions operation on agent_version_revision resource
+- `getAgent-version-revisionsById()` - /agent-version-revisions/:id operation on agent_version_revision resource
 
 ## AI Agents
 
-- `getAgent-versions()` - List agent versions
-- `getAgent-versionsById()` - Get agent versions
-- `getAgent-versionsByIdMetrics()` - Get metrics
-- `getAgent-versionsByIdRevisions()` - Get revisions
-- `getAgents()` - List agents
-- `getAgentsById()` - Get agents
-- `getAgentsByIdSchema-versions()` - Get schema versions
-- `getAgentsByIdTraining-examples()` - Get training examples
-- `postAgent-versions()` - Create agent versions
-- `postAgent-versionsByIdAdd-system-field()` - Create add system field
-- `postAgent-versionsByIdRemove-system-field()` - Create remove system field
-- `postAgent-versionsByIdSet-system-fields()` - Create set system fields
-- `postAgents()` - Create agents
-- `postAgentsByIdAnalyze-training()` - Create analyze training
-- `postAgentsByIdClone()` - Create clone
-- `postAgentsByIdExport()` - Create export
-- `postAgentsByIdPublish-version()` - Create publish version
-- `postAgentsByIdRestore-version()` - Create restore version
-- `postAgentsByIdSchema-versions()` - Create schema versions
-- `postAgentsByIdSchema-versionsByVersionIdActivate()` - Create activate
-- `postAgentsByIdTeach()` - Create teach
-- `postAgentsByIdTest()` - Create test
-- `postAgentsByIdValidate()` - Create validate
-- `postAgentsClone-for-workspace()` - Create clone for workspace
-- `postAgentsImport()` - Create import
-- `postAgentsPredict()` - Create predict
-- `patchAgentsById()` - Update agents
-- `patchAgentsByIdSchema-versionsByVersionId()` - Update schema versions
-- `deleteAgent-versionsById()` - Delete agent versions
-- `deleteAgentsById()` - Delete agents
-- `deleteAgentsByIdTraining-examplesByExampleId()` - Delete training examples
+- `getAgent-versions()` - List AgentVersions, optionally filtered to a specific agent
+- `getAgent-versionsById()` - Fetch a single AgentVersion by ID
+- `getAgent-versionsByIdMetrics()` - Get performance metrics for this version
+- `getAgent-versionsByIdRevisions()` - List all revisions for a specific AgentVersion, sorted by revision number descending
+- `getAgents()` - List all agents accessible in the current workspace
+- `getAgentsById()` - Fetch a single agent by ID
+- `getAgentsByIdSchema-versions()` - List all schema versions for this agent
+- `getAgentsByIdTraining-examples()` - List training examples for this agent
+- `postAgent-versions()` - Create a new AgentVersion snapshot
+- `postAgent-versionsByIdAdd-system-field()` - Add a predefined system field to this version's schema
+- `postAgent-versionsByIdRemove-system-field()` - Remove a system field from this version's schema
+- `postAgent-versionsByIdSet-system-fields()` - Set which system fields are included in this version's schema (batch operation)
+- `postAgents()` - Create a new agent
+- `postAgentsByIdAnalyze-training()` - Analyze training examples for conflicts, coverage, and quality
+- `postAgentsByIdClone()` - Clone the agent to a new one with a new name
+- `postAgentsByIdExport()` - Export agent configuration and training examples
+- `postAgentsByIdPublish-version()` - Create a new immutable version from current agent state
+- `postAgentsByIdRestore-version()` - Restore the agent to a previously used version by activating it
+- `postAgentsByIdSchema-versions()` - Create a new schema version for this agent
+- `postAgentsByIdSchema-versionsByVersionIdActivate()` - Activate a specific schema version
+- `postAgentsByIdTeach()` - Submit human corrections to improve agent training
+- `postAgentsByIdTest()` - Run the agent against sample input
+- `postAgentsByIdValidate()` - Validate sample output against agent schema
+- `postAgentsClone-for-workspace()` - Clone a system agent for workspace-specific customization
+- `postAgentsImport()` - Import an agent from a JSON payload produced by `:export`
+- `postAgentsPredict()` - Predicts the best agents for a given input
+- `patchAgentsById()` - Update agent metadata such as name, description, domain, tags, and instructions
+- `patchAgentsByIdSchema-versionsByVersionId()` - Update a schema version without creating a new version
+- `deleteAgent-versionsById()` - Delete an AgentVersion
+- `deleteAgentsById()` - Permanently delete an agent and cascade-destroy all associated data
+- `deleteAgentsByIdTraining-examplesByExampleId()` - Delete a training example belonging to this agent
 
 ## AI Training
 
-- `getTraining-examples()` - List training examples
-- `getTraining-examplesById()` - Get training examples
-- `getTraining-sessionsAgentsByAgentIdSessions()` - Get sessions
-- `getTraining-sessionsById()` - Get training sessions
-- `postTraining-examples()` - Create training examples
-- `postTraining-examplesBulk()` - Create bulk
-- `postTraining-examplesBulk-delete()` - Create bulk delete
-- `postTraining-examplesSearch()` - Create search
-- `patchTraining-examplesById()` - Update training examples
-- `deleteTraining-examplesById()` - Delete training examples
-- `deleteTraining-sessionsById()` - Delete training sessions
+- `getTraining-examples()` - List training examples with filtering support
+- `getTraining-examplesById()` - Fetch a single TrainingExample by ID.
+- `getTraining-sessionsAgentsByAgentIdSessions()` - /training-sessions/agents/:agent_id/sessions operation on training_session resource
+- `getTraining-sessionsById()` - /training-sessions/:id operation on training_session resource
+- `postTraining-examples()` - Create a single training example (golden example for few-shot learning)
+- `postTraining-examplesBulk()` - Create multiple training examples in a single transaction using `Ash.bulk_create`
+- `postTraining-examplesBulk-delete()` - Delete multiple training examples by ID in a single transaction
+- `postTraining-examplesSearch()` - Public entry point for semantic similarity search over training examples
+- `patchTraining-examplesById()` - Update an existing training example's input text, expected output JSON, notes,
+correction reasons, or image reference
+- `deleteTraining-examplesById()` - /training-examples/:id operation on training_example resource
+- `deleteTraining-sessionsById()` - /training-sessions/:id operation on training_session resource
 
 ## Analytics
 
-- `getLlmAnalytics()` - List llm analytics
-- `getLlmAnalyticsById()` - Get llm analytics
-- `getLlmAnalyticsCosts()` - List costs
-- `getLlmAnalyticsPlatform()` - List platform
-- `getLlmAnalyticsSummary()` - List summary
-- `getLlmAnalyticsUsage()` - List usage
-- `getLlmAnalyticsWorkspace()` - List workspace
-- `postLlmAnalytics()` - Create llm analytics
+- `getLlmAnalytics()` - List LLM analytics records sorted by created_at descending; scoped to the caller's tenant.
+- `getLlmAnalyticsById()` - /llm_analytics/:id operation on llm_analytics resource
+- `getLlmAnalyticsCosts()` - Retrieve cost-focused analytics records for the caller's tenant; use for billing reconciliation and cost analysis.
+- `getLlmAnalyticsPlatform()` - Platform-wide analytics summary (platform admin only)
+- `getLlmAnalyticsSummary()` - Aggregate LLM usage and cost statistics optionally filtered by a date range; returns a single summary record.
+- `getLlmAnalyticsUsage()` - Return token usage summary analytics for the caller's tenant; useful for quota monitoring and capacity planning.
+- `getLlmAnalyticsWorkspace()` - Fetch LLM analytics scoped to a single workspace; use for per-workspace usage dashboards and cost attribution.
+- `postLlmAnalytics()` - Append a single LLM call analytics record (model, tokens, latency, cost); called by the billing/analytics pipeline after each LLM invocation
 
 ## API Keys
 
-- `getApi-keys()` - List api keys
-- `getApi-keysActive()` - List active
-- `getApi-keysById()` - Get api keys
-- `getApi-keysStats()` - List stats
-- `postApi-keys()` - Create api keys
-- `patchApi-keysById()` - Update api keys
-- `patchApi-keysByIdAllocate()` - Update allocate
-- `patchApi-keysByIdReset-period()` - Update reset period
-- `patchApi-keysByIdRevoke()` - Update revoke
-- `patchApi-keysByIdRotate()` - Update rotate
-- `patchApi-keysByIdSet-budget()` - Update set budget
-- `deleteApi-keysById()` - Delete api keys
+- `getApi-keys()` - List or fetch API keys
+- `getApi-keysActive()` - List only active API keys
+- `getApi-keysById()` - List or fetch API keys
+- `getApi-keysStats()` - Get API keys with usage statistics for a tenant
+- `postApi-keys()` - Create a new API key for the authenticated actor
+- `patchApi-keysById()` - Update mutable API key properties: name, scopes, rate limit, and credit limit
+- `patchApi-keysByIdReset-period()` - Reset budget period (for testing or manual reset)
+- `patchApi-keysByIdRevoke()` - Revoke an API key, setting its status to :revoked and recording the revocation
+timestamp
+- `patchApi-keysByIdRotate()` - Rotate an API key by generating a new token while preserving the key's id,
+metadata, and configuration
+- `patchApi-keysByIdSet-budget()` - Set or remove credit budget for this API key
+- `deleteApi-keysById()` - Permanently delete an API key record
 
 ## Applications
 
-- `getApplications()` - List applications
-- `getApplicationsBy-slugBySlug()` - Get by slug
-- `getApplicationsById()` - Get applications
-- `getApplicationsCurrent()` - List current
-- `postApplications()` - Create applications
-- `patchApplicationsById()` - Update applications
-- `patchApplicationsByIdAllocate-credits()` - Update allocate credits
-- `patchApplicationsByIdGrant-credits()` - Update grant credits
-- `deleteApplicationsById()` - Delete applications
+- `getApplications()` - /applications operation on application resource
+- `getApplicationsBy-slugBySlug()` - Fetch a single application by its unique slug
+- `getApplicationsById()` - /applications/:id operation on application resource
+- `getApplicationsCurrent()` - Get the current application based on x-application-key header context
+- `postApplications()` - Register a new ISV application on the platform
+- `patchApplicationsById()` - Update application configuration including branding, email settings, capability
+flags, workspace mode, and execution limits
+- `patchApplicationsByIdAllocate-credits()` - Allocate credits to the account associated with this Application
+- `patchApplicationsByIdGrant-credits()` - Allocates promotional credits to a specific tenant on behalf of the application
+- `deleteApplicationsById()` - Permanently delete an application and all associated data
 
 ## Audit chain entry
 
-- `getAudit-chain-entries()` - List audit chain entries
-- `getAudit-chain-entriesById()` - Get audit chain entries
+- `getAudit-chain-entries()` - /audit-chain-entries operation on audit_chain_entry resource
+- `getAudit-chain-entriesById()` - /audit-chain-entries/:id operation on audit_chain_entry resource
 
 ## Audit-log
 
-- `getAudit-logs()` - List audit logs
-- `getAudit-logsActivity()` - List activity
+- `getAudit-logs()` - List audit log entries
+- `getAudit-logsActivity()` - Fetch a scoped, paginated activity feed for a tenant; optionally filter by workspace_id, activity_type, date range, or actor
+- `getAudit-logsCount-by-action()` - Return a per-action count for a tenant's audit logs
+- `postAudit-logsExport()` - Enqueue a bulk export job for audit logs
 
 ## Billing
 
-- `getCredit-packages()` - List credit packages
-- `getCredit-packagesById()` - Get credit packages
-- `getCredit-packagesSlugBySlug()` - Get slug
-- `getPlans()` - List plans
-- `getPlansById()` - Get plans
-- `getPlansSlugBySlug()` - Get slug
-- `getWallet()` - List wallet
-- `getWalletPlanPreview()` - List preview
-- `postPayments()` - Create payments
-- `patchWalletAddons()` - Update addons
-- `patchWalletAddonsByAddonSlugCancel()` - Update cancel
-- `patchWalletAuto-top-up()` - Update auto top up
-- `patchWalletCredits()` - Update credits
-- `patchWalletPlan()` - Update plan
+- `getCredit-packages()` - /credit-packages operation on credit_package resource
+- `getCredit-packagesById()` - /credit-packages/:id operation on credit_package resource
+- `getCredit-packagesSlugBySlug()` - /credit-packages/slug/:slug operation on credit_package resource
+- `getPlans()` - /plans operation on plan resource
+- `getPlansById()` - /plans/:id operation on plan resource
+- `getPlansSlugBySlug()` - /plans/slug/:slug operation on plan resource
+- `getWallet()` - Reads the wallet for the current tenant
+- `getWalletPlanPreview()` - Preview the cost and effective date of a plan change
+- `postPayments()` - Process a payment
+- `patchWalletAddons()` - Purchase an add-on for the wallet
+- `patchWalletAddonsByAddonSlugCancel()` - Cancel an add-on for the wallet
+- `patchWalletAuto-top-up()` - Update auto-top-up settings
+- `patchWalletCredits()` - Purchase credits (Top-up)
+- `patchWalletPlan()` - Change the main plan for the wallet
 
 ## Breach incident
 
-- `getBreach-incidents()` - List breach incidents
-- `getBreach-incidentsById()` - Get breach incidents
-- `postBreach-incidents()` - Create breach incidents
-- `patchBreach-incidentsByIdStatus()` - Update status
+- `getBreach-incidents()` - /breach-incidents operation on breach_incident resource
+- `getBreach-incidentsById()` - /breach-incidents/:id operation on breach_incident resource
+- `postBreach-incidents()` - Report a new data breach or security incident
+- `patchBreach-incidentsByIdStatus()` - Advance a breach incident through its lifecycle (identified → investigating → notifying → resolved / false_positive) and record officer notification and remediation notes.
 
 ## Breach notification
 
-- `getBreach-notifications()` - List breach notifications
-- `getBreach-notificationsById()` - Get breach notifications
+- `getBreach-notifications()` - /breach-notifications operation on breach_notification resource
+- `getBreach-notificationsById()` - /breach-notifications/:id operation on breach_notification resource
 
 ## Bulk dismissal result
 
-- `postWorkspacesByWorkspaceIdExtractionDocumentsDismiss-all-trained()` - Create dismiss all trained
+- `postWorkspacesByWorkspaceIdExtractionDocumentsDismiss-all-trained()` - /workspaces/:workspace_id/extraction/documents/dismiss-all-trained operation on bulk_dismissal_result resource
 
 ## Bulk reprocess result
 
-- `postExtractionDocumentsBulk-reprocess()` - Create bulk reprocess
+- `postExtractionDocumentsBulk-reprocess()` - /extraction/documents/bulk-reprocess operation on bulk_reprocess_result resource
+
+## Campaign
+
+- `getEmail-marketingCampaignsById()` - /email-marketing/campaigns/:id operation on campaign resource
+- `getEmail-marketingCampaignsWorkspaceByWorkspaceId()` - /email-marketing/campaigns/workspace/:workspace_id operation on campaign resource
+- `postEmail-marketingCampaigns()` - /email-marketing/campaigns operation on campaign resource
+- `postEmail-marketingCampaignsByIdAnalyze()` - Run post-campaign AI analysis with insights and recommendations
+- `postEmail-marketingCampaignsByIdCreate-followup()` - Create a re-engagement campaign for non-engaged recipients
+- `postEmail-marketingCampaignsByIdExport()` - Export campaign data (recipients, results, or tracking) as CSV
+- `postEmail-marketingCampaignsByIdGenerate-emails()` - /email-marketing/campaigns/:id/generate-emails operation on campaign resource
+- `postEmail-marketingCampaignsByIdImport-recipients()` - /email-marketing/campaigns/:id/import-recipients operation on campaign resource
+- `postEmail-marketingCampaignsByIdOptimize-send-times()` - Predict optimal send times per recipient using AI
+- `postEmail-marketingCampaignsByIdOptimize-subjects()` - Generate A/B test subject line variants using AI
+- `postEmail-marketingCampaignsByIdSend()` - Triggers batch sending for approved emails
+- `patchEmail-marketingCampaignsById()` - /email-marketing/campaigns/:id operation on campaign resource
+- `deleteEmail-marketingCampaignsById()` - /email-marketing/campaigns/:id operation on campaign resource
 
 ## Catalog option type
 
-- `getCatalogOption-typesApplicationByApplicationId()` - Get application
-- `getCatalogOption-typesById()` - Get option types
-- `postCatalogOption-types()` - Create option types
-- `patchCatalogOption-typesById()` - Update option types
-- `deleteCatalogOption-typesById()` - Delete option types
+- `getCatalogOption-typesApplicationByApplicationId()` - List all option types for an application ordered by position
+- `getCatalogOption-typesById()` - /catalog/option-types/:id operation on catalog_option_type resource
+- `postCatalogOption-types()` - Create an option type (e.g., Size, Color) for an application; shared across all tenants
+- `patchCatalogOption-typesById()` - Update the name, slug, or display position of an option type
+- `deleteCatalogOption-typesById()` - Permanently delete an option type and all its values; cascades to variant_option_values
 
 ## Catalog option value
 
-- `getCatalogOption-valuesById()` - Get option values
-- `getCatalogOption-valuesOption-typeByOptionTypeId()` - Get option type
-- `postCatalogOption-values()` - Create option values
-- `patchCatalogOption-valuesById()` - Update option values
-- `deleteCatalogOption-valuesById()` - Delete option values
+- `getCatalogOption-valuesById()` - /catalog/option-values/:id operation on catalog_option_value resource
+- `getCatalogOption-valuesOption-typeByOptionTypeId()` - List all values for an option type ordered by position
+- `postCatalogOption-values()` - Create a specific option value (e.g., 'Large', 'Red') within an option type
+- `patchCatalogOption-valuesById()` - Update the name, slug, position, or metadata of an option value
+- `deleteCatalogOption-valuesById()` - Permanently delete an option value; removes associated variant_option_values
 
 ## Catalog price list
 
-- `getCatalogPrice-listsApplicationByApplicationId()` - Get application
-- `getCatalogPrice-listsById()` - Get price lists
-- `postCatalogPrice-lists()` - Create price lists
-- `patchCatalogPrice-listsById()` - Update price lists
-- `deleteCatalogPrice-listsById()` - Delete price lists
+- `getCatalogPrice-listsApplicationByApplicationId()` - List all price lists for an application, ordered by priority
+- `getCatalogPrice-listsById()` - /catalog/price-lists/:id operation on catalog_price_list resource
+- `postCatalogPrice-lists()` - Create a named price list for an application with a strategy (fixed, percentage_discount, or tiered)
+- `patchCatalogPrice-listsById()` - Update price list metadata, strategy, or validity period
+- `deleteCatalogPrice-listsById()` - Permanently delete a price list and all its entries
 
 ## Catalog price list entry
 
-- `getCatalogPrice-list-entriesPrice-listByPriceListId()` - Get price list
-- `postCatalogPrice-list-entries()` - Create price list entries
-- `patchCatalogPrice-list-entriesById()` - Update price list entries
-- `deleteCatalogPrice-list-entriesById()` - Delete price list entries
+- `getCatalogPrice-list-entriesPrice-listByPriceListId()` - List all entries in a price list
+- `postCatalogPrice-list-entries()` - Add a pricing entry to a price list for a product or variant; supply a fixed price, modifier, or tiered structure
+- `patchCatalogPrice-list-entriesById()` - Update the price, modifier, tiers, or floor price for an existing entry
+- `deleteCatalogPrice-list-entriesById()` - Permanently delete a price list entry
 
 ## Catalog product
 
-- `getCatalogProductsById()` - Get products
-- `getCatalogProductsWorkspaceByWorkspaceId()` - Get workspace
-- `postCatalogProducts()` - Create products
-- `patchCatalogProductsById()` - Update products
-- `deleteCatalogProductsById()` - Delete products
+- `getCatalogProductsById()` - /catalog/products/:id operation on catalog_product resource
+- `getCatalogProductsWorkspaceByWorkspaceId()` - List all active (non-deleted) products in a workspace
+- `postCatalogProducts()` - Create a new catalog product in a workspace; triggers search indexing and enqueues embedding generation
+- `patchCatalogProductsById()` - Update a product's attributes; triggers search re-indexing and embedding refresh
+- `deleteCatalogProductsById()` - Soft-delete a product by stamping deleted_at; excluded from all future reads
 
 ## Catalog product variant
 
-- `getCatalogProduct-variantsById()` - Get product variants
-- `getCatalogProduct-variantsProductByProductId()` - Get product
-- `postCatalogProduct-variants()` - Create product variants
-- `patchCatalogProduct-variantsById()` - Update product variants
-- `deleteCatalogProduct-variantsById()` - Delete product variants
+- `getCatalogProduct-variantsById()` - /catalog/product-variants/:id operation on catalog_product_variant resource
+- `getCatalogProduct-variantsProductByProductId()` - List all active variants for a given product, sorted by position
+- `postCatalogProduct-variants()` - Create a product variant (SKU, price override, option values); enforces max_variants_per_product quota
+- `patchCatalogProduct-variantsById()` - Update a variant's SKU, pricing, properties, or media
+- `deleteCatalogProduct-variantsById()` - Soft-delete a variant by setting deleted_at; excluded from future reads
 
 ## Catalog taxonomy
 
-- `getCatalogTaxonomiesApplicationByApplicationId()` - Get application
-- `getCatalogTaxonomiesById()` - Get taxonomies
-- `postCatalogTaxonomies()` - Create taxonomies
-- `patchCatalogTaxonomiesById()` - Update taxonomies
-- `deleteCatalogTaxonomiesById()` - Delete taxonomies
+- `getCatalogTaxonomiesApplicationByApplicationId()` - List active taxonomies for an application
+- `getCatalogTaxonomiesById()` - /catalog/taxonomies/:id operation on catalog_taxonomy resource
+- `postCatalogTaxonomies()` - Create a new taxonomy (classification axis) for an application; enforces max_taxonomies quota
+- `patchCatalogTaxonomiesById()` - Update taxonomy metadata (name, slug, hierarchy settings)
+- `deleteCatalogTaxonomiesById()` - Soft-delete a taxonomy by setting deleted_at; cascades to exclude nodes from future reads
 
 ## Catalog taxonomy node
 
-- `getCatalogTaxonomy-nodesById()` - Get taxonomy nodes
-- `getCatalogTaxonomy-nodesTaxonomyByTaxonomyId()` - Get taxonomy
-- `postCatalogTaxonomy-nodes()` - Create taxonomy nodes
-- `patchCatalogTaxonomy-nodesById()` - Update taxonomy nodes
-- `deleteCatalogTaxonomy-nodesById()` - Delete taxonomy nodes
+- `getCatalogTaxonomy-nodesById()` - /catalog/taxonomy-nodes/:id operation on catalog_taxonomy_node resource
+- `getCatalogTaxonomy-nodesTaxonomyByTaxonomyId()` - List all active nodes in a taxonomy
+- `postCatalogTaxonomy-nodes()` - Create a taxonomy node (category) at the given position in the tree; validates hierarchy depth
+- `patchCatalogTaxonomy-nodesById()` - Update a node's name, slug, position, or parent; re-validates tree depth
+- `deleteCatalogTaxonomy-nodesById()` - Soft-delete a taxonomy node by stamping deleted_at; child nodes are not auto-deleted
 
 ## Catalog view
 
-- `getCatalogViewsById()` - Get views
-- `getCatalogViewsWorkspaceByWorkspaceId()` - Get workspace
-- `postCatalogViews()` - Create views
-- `patchCatalogViewsById()` - Update views
-- `deleteCatalogViewsById()` - Delete views
+- `getCatalogViewsById()` - /catalog/views/:id operation on catalog_view resource
+- `getCatalogViewsWorkspaceByWorkspaceId()` - List all catalog views in a workspace
+- `postCatalogViews()` - Create a catalog view (named product lens) in a workspace; enforces max_catalog_views quota
+- `patchCatalogViewsById()` - Update view metadata, filtering rules, or pricing association
+- `deleteCatalogViewsById()` - Permanently delete a catalog view and its rules and overrides
 
 ## Config
 
-- `getConfigs()` - List configs
-- `postConfigs()` - Create configs
-- `patchConfigsByKey()` - Update configs
+- `getConfigs()` - /configs operation on config resource
+- `postConfigs()` - Create or upsert a platform config entry by key; if the key already exists its value, description, and sensitivity flag are updated
+- `patchConfigsByKey()` - Update the value, description, or sensitivity flag for an existing config entry; automatically invalidates the FetchConfig cache for the key
 
 ## Connector instance
 
-- `getConnectors()` - List connectors
-- `getConnectorsById()` - Get connectors
-- `postConnectors()` - Create connectors
-- `postConnectorsFullscriptCheck-patient()` - Create check patient
-- `postConnectorsFullscriptCreate-patient()` - Create create patient
-- `postConnectorsFullscriptSession-grant()` - Create session grant
-- `postConnectorsOauthCallback()` - Create callback
-- `postConnectorsOauthInitiate()` - Create initiate
-- `patchConnectorsById()` - Update connectors
-- `deleteConnectorsById()` - Delete connectors
+- `getConnectors()` - /connectors operation on connector_instance resource
+- `getConnectorsById()` - /connectors/:id operation on connector_instance resource
+- `postConnectors()` - Install a new connector instance in a workspace
+- `postConnectorsByIdEdamamRecipesGet()` - Get full details for a single recipe by Edamam recipe ID
+- `postConnectorsByIdEdamamRecipesSearch()` - Search for recipes using the Edamam Recipe API
+- `postConnectorsFullscriptCheck-patient()` - Check if a patient exists in Fullscript by email
+- `postConnectorsFullscriptCreate-patient()` - Create a patient in Fullscript
+- `postConnectorsFullscriptSession-grant()` - Get a Fullscript embed session grant token for the prescribing widget
+- `postConnectorsOauthCallback()` - Exchange OAuth authorization code for credential.
+- `postConnectorsOauthInitiate()` - Initiate OAuth flow for a connector type
+- `patchConnectorsById()` - Update a connector instance's name, configuration, sync interval, health status, or metadata
+- `deleteConnectorsById()` - /connectors/:id operation on connector_instance resource
 
 ## Consent record
 
-- `getConsent-records()` - List consent records
-- `getConsent-recordsActive()` - List active
-- `getConsent-recordsById()` - Get consent records
-- `postConsent-records()` - Create consent records
-- `patchConsent-recordsByIdWithdraw()` - Update withdraw
+- `getConsent-records()` - /consent-records operation on consent_record resource
+- `getConsent-recordsActive()` - List all currently granted (non-withdrawn) consents for a given user
+- `getConsent-recordsById()` - /consent-records/:id operation on consent_record resource
+- `postConsent-records()` - Record a new consent grant for a specific processing purpose (AI document processing, analytics, marketing, or third-party sharing)
+- `patchConsent-recordsByIdWithdraw()` - Revoke an existing consent grant
 
 ## Conversations
 
-- `getAiConversations()` - List conversations
-- `getAiConversationsById()` - Get conversations
-- `postAiConversations()` - Create conversations
-- `patchAiConversationsById()` - Update conversations
-- `deleteAiConversationsById()` - Delete conversations
+- `getAiConversations()` - /ai/conversations operation on conversation resource
+- `getAiConversationsById()` - /ai/conversations/:id operation on conversation resource
+- `postAiConversations()` - Start a new AI conversation session with optional structured context data (e.g., prediction results to discuss)
+- `patchAiConversationsById()` - Update the conversation title or replace the context data map
+- `deleteAiConversationsById()` - /ai/conversations/:id operation on conversation resource
 
 ## Crawler job
 
-- `getCrawlerJobs()` - List jobs
-- `getCrawlerJobsById()` - Get jobs
-- `postCrawlerJobs()` - Create jobs
-- `patchCrawlerJobsByIdCancel()` - Update cancel
-- `deleteCrawlerJobsById()` - Delete jobs
+- `getCrawlerJobs()` - /crawler/jobs operation on crawler_job resource
+- `getCrawlerJobsById()` - /crawler/jobs/:id operation on crawler_job resource
+- `postCrawlerJobs()` - Create a crawl job for a URL with the specified mode and strategy; performs a credit pre-check and enqueues execution
+- `patchCrawlerJobsByIdCancel()` - Cancel a pending or running job; sets status to :cancelled with completed_at timestamp
+- `deleteCrawlerJobsById()` - /crawler/jobs/:id operation on crawler_job resource
 
 ## Crawler result
 
-- `getCrawlerResults()` - List results
-- `getCrawlerResultsById()` - Get results
+- `getCrawlerResults()` - /crawler/results operation on crawler_result resource
+- `getCrawlerResultsById()` - /crawler/results/:id operation on crawler_result resource
 
 ## Crawler schedule
 
-- `getCrawlerSchedules()` - List schedules
-- `getCrawlerSchedulesById()` - Get schedules
-- `postCrawlerSchedules()` - Create schedules
-- `patchCrawlerSchedulesById()` - Update schedules
-- `patchCrawlerSchedulesByIdDisable()` - Update disable
-- `patchCrawlerSchedulesByIdEnable()` - Update enable
-- `patchCrawlerSchedulesByIdTrigger()` - Update trigger
-- `deleteCrawlerSchedulesById()` - Delete schedules
+- `getCrawlerSchedules()` - /crawler/schedules operation on crawler_schedule resource
+- `getCrawlerSchedulesById()` - /crawler/schedules/:id operation on crawler_schedule resource
+- `postCrawlerSchedules()` - Create a recurring crawl schedule for a URL; sets frequency, cron expression, and notification preferences
+- `patchCrawlerSchedulesById()` - Update schedule configuration, URL, frequency, or notification settings
+- `patchCrawlerSchedulesByIdDisable()` - Disable a schedule to pause automatic crawling without deleting the configuration.
+- `patchCrawlerSchedulesByIdEnable()` - Enable a disabled schedule so it resumes automatic crawling on its next_run_at.
+- `patchCrawlerSchedulesByIdTrigger()` - Manually trigger a scheduled crawl immediately.
+- `deleteCrawlerSchedulesById()` - /crawler/schedules/:id operation on crawler_schedule resource
 
 ## Credential
 
-- `getConnectorsCredentials()` - List credentials
-- `getConnectorsCredentialsById()` - Get credentials
-- `postConnectorsCredentialsByIdRefresh()` - Create refresh
+- `getConnectorsCredentials()` - /connectors/credentials operation on credential resource
+- `getConnectorsCredentialsById()` - /connectors/credentials/:id operation on credential resource
+- `postConnectorsCredentialsByIdRefresh()` - Refresh OAuth credential token.
 
 ## Crm activity
 
-- `getCrmActivitiesById()` - Get activities
-- `getCrmActivitiesWorkspaceByWorkspaceId()` - Get workspace
-- `postCrmActivities()` - Create activities
-- `deleteCrmActivitiesById()` - Delete activities
+- `getCrmActivitiesById()` - Fetch a single active activity by ID; excludes soft-deleted records.
+- `getCrmActivitiesWorkspaceByWorkspaceId()` - List active activities in a workspace with offset pagination
+- `postCrmActivities()` - Log a CRM activity (call, email, meeting, note, etc.) linked to the workspace
+- `deleteCrmActivitiesById()` - Soft-delete an activity by setting deleted_at
 
 ## Crm company
 
-- `getCrmCompaniesById()` - Get companies
-- `getCrmCompaniesWorkspaceByWorkspaceId()` - Get workspace
-- `postCrmCompanies()` - Create companies
-- `patchCrmCompaniesById()` - Update companies
-- `deleteCrmCompaniesById()` - Delete companies
+- `getCrmCompaniesById()` - Fetch a single active company by ID; excludes soft-deleted records.
+- `getCrmCompaniesWorkspaceByWorkspaceId()` - List active companies in a workspace with offset pagination
+- `postCrmCompanies()` - Create a new CRM company
+- `patchCrmCompaniesById()` - Update mutable fields on an existing company
+- `deleteCrmCompaniesById()` - Soft-delete a company by setting deleted_at
 
 ## Crm contact
 
-- `getCrmContactsById()` - Get contacts
-- `getCrmContactsWorkspaceByWorkspaceId()` - Get workspace
-- `postCrmContacts()` - Create contacts
-- `patchCrmContactsById()` - Update contacts
-- `deleteCrmContactsById()` - Delete contacts
+- `getCrmContactsById()` - Fetch a single active contact by ID; excludes soft-deleted records.
+- `getCrmContactsWorkspaceByWorkspaceId()` - List active contacts in a workspace with optional lifecycle_stage, tag, and
+property filters applied Elixir-side
+- `getCrmContactsWorkspaceByWorkspaceIdArchived()` - List contacts that have been soft-archived (deleted_at is set) in a workspace.
+- `postCrmContacts()` - Create a new CRM contact
+- `postCrmContactsByIdUnarchive()` - Restore an archived contact (clears deleted_at)
+- `patchCrmContactsById()` - Update mutable fields on an existing contact
+- `patchCrmContactsByIdArchive()` - Soft-archive a contact (sets deleted_at)
+- `deleteCrmContactsById()` - Soft-delete a contact by setting deleted_at
 
 ## Crm custom entity
 
-- `getCrmCustom-entitiesById()` - Get custom entities
-- `getCrmCustom-entitiesWorkspaceByWorkspaceId()` - Get workspace
-- `postCrmCustom-entities()` - Create custom entities
-- `patchCrmCustom-entitiesById()` - Update custom entities
-- `deleteCrmCustom-entitiesById()` - Delete custom entities
+- `getCrmCustom-entitiesById()` - Fetch a single active custom entity by ID; excludes soft-deleted records.
+- `getCrmCustom-entitiesWorkspaceByWorkspaceId()` - List active custom entities in a workspace, optionally filtered by type slug and
+attribute-level property filters
+- `postCrmCustom-entities()` - Create an instance of a custom entity type
+- `patchCrmCustom-entitiesById()` - Update a custom entity's properties and pipeline assignment
+- `deleteCrmCustom-entitiesById()` - Soft-delete a custom entity by setting deleted_at
 
 ## Crm custom entity version
 
-- `getCrmCustom-entitiesByEntityIdVersions()` - Get versions
-- `getCrmCustom-entitiesByEntityIdVersionsById()` - Get versions
+- `getCrmCustom-entitiesByEntityIdVersions()` - /crm/custom-entities/:entity_id/versions operation on crm_custom_entity_version resource
+- `getCrmCustom-entitiesByEntityIdVersionsById()` - Fetch a single version by ID, scoped to a specific entity (IDOR-safe)
 
 ## Crm data export job
 
-- `getCrmExportsById()` - Get exports
-- `getCrmExportsWorkspaceByWorkspaceId()` - Get workspace
-- `postCrmExports()` - Create exports
+- `getCrmExportsById()` - Fetch a single export job by ID
+- `getCrmExportsWorkspaceByWorkspaceId()` - List all export jobs for a workspace, sorted newest first
+- `postCrmExports()` - Enqueue an async CRM data export job
 
 ## Crm deal
 
-- `getCrmDealsById()` - Get deals
-- `getCrmDealsWorkspaceByWorkspaceId()` - Get workspace
-- `postCrmDeals()` - Create deals
-- `patchCrmDealsById()` - Update deals
-- `deleteCrmDealsById()` - Delete deals
+- `getCrmDealsById()` - Fetch a single active deal by ID; excludes soft-deleted records.
+- `getCrmDealsWorkspaceByWorkspaceId()` - List active deals in a workspace with offset pagination
+- `postCrmDeals()` - Create a new CRM deal and place it in a pipeline stage
+- `patchCrmDealsById()` - Update deal fields including status, AI scores, and pipeline assignment
+- `deleteCrmDealsById()` - Soft-delete a deal by setting deleted_at
 
 ## Crm pipeline
 
-- `getCrmPipelinesById()` - Get pipelines
-- `getCrmPipelinesWorkspaceByWorkspaceId()` - Get workspace
-- `postCrmPipelines()` - Create pipelines
-- `patchCrmPipelinesById()` - Update pipelines
-- `deleteCrmPipelinesById()` - Delete pipelines
+- `getCrmPipelinesById()` - /crm/pipelines/:id operation on crm_pipeline resource
+- `getCrmPipelinesWorkspaceByWorkspaceId()` - List pipelines available to a workspace — includes both workspace-specific pipelines and application-level templates (workspace_id IS NULL).
+- `postCrmPipelines()` - Create a pipeline scoped to an application (template) or a specific workspace
+- `patchCrmPipelinesById()` - Update a pipeline's name or default status
+- `deleteCrmPipelinesById()` - /crm/pipelines/:id operation on crm_pipeline resource
 
 ## Crm pipeline stage
 
-- `getCrmPipeline-stagesById()` - Get pipeline stages
-- `postCrmPipeline-stages()` - Create pipeline stages
-- `patchCrmPipeline-stagesById()` - Update pipeline stages
-- `deleteCrmPipeline-stagesById()` - Delete pipeline stages
+- `getCrmPipeline-stagesById()` - /crm/pipeline-stages/:id operation on crm_pipeline_stage resource
+- `postCrmPipeline-stages()` - Add a stage to a pipeline with an explicit sort order, optional win probability, and forecast category
+- `patchCrmPipeline-stagesById()` - Update a pipeline stage's name, order, probability, or closed flag
+- `deleteCrmPipeline-stagesById()` - /crm/pipeline-stages/:id operation on crm_pipeline_stage resource
 
 ## Crm relationship
 
-- `getCrmRelationshipsById()` - Get relationships
-- `getCrmRelationshipsWorkspaceByWorkspaceId()` - Get workspace
-- `postCrmRelationships()` - Create relationships
-- `deleteCrmRelationshipsById()` - Delete relationships
+- `getCrmRelationshipsById()` - Fetch a single CRM relationship by ID
+- `getCrmRelationshipsWorkspaceByWorkspaceId()` - List all relationship edges in a workspace
+- `postCrmRelationships()` - Create a typed relationship edge between two CRM entities
+- `deleteCrmRelationshipsById()` - Permanently remove a relationship edge (hard delete)
 
 ## Crm relationship type
 
-- `getCrmRelationship-types()` - List relationship types
-- `getCrmRelationship-typesById()` - Get relationship types
-- `postCrmRelationship-types()` - Create relationship types
-- `patchCrmRelationship-typesById()` - Update relationship types
-- `deleteCrmRelationship-typesById()` - Delete relationship types
+- `getCrmRelationship-types()` - /crm/relationship-types operation on crm_relationship_type resource
+- `getCrmRelationship-typesById()` - /crm/relationship-types/:id operation on crm_relationship_type resource
+- `postCrmRelationship-types()` - Define a named relationship category for an application
+- `patchCrmRelationship-typesById()` - Update a relationship type's display name, allowed entity types, or properties schema
+- `deleteCrmRelationship-typesById()` - /crm/relationship-types/:id operation on crm_relationship_type resource
 
 ## Data protection impact assessment
 
-- `getImpact-assessments()` - List impact assessments
-- `getImpact-assessmentsById()` - Get impact assessments
-- `postImpact-assessments()` - Create impact assessments
-- `patchImpact-assessmentsById()` - Update impact assessments
-- `patchImpact-assessmentsByIdApprove()` - Update approve
+- `getImpact-assessments()` - /impact-assessments operation on data_protection_impact_assessment resource
+- `getImpact-assessmentsById()` - /impact-assessments/:id operation on data_protection_impact_assessment resource
+- `postImpact-assessments()` - Open a new GDPR Article 35 Data Protection Impact Assessment for a high-risk processing activity
+- `patchImpact-assessmentsById()` - Update the DPIA's title, description, risk level, findings, or mitigations while it is in draft or in_review status
+- `patchImpact-assessmentsByIdApprove()` - Approve a completed DPIA by recording the approver's name and setting `approved_at` to the current timestamp
 
 ## Data subject request
 
-- `getData-subject-requests()` - List data subject requests
-- `getData-subject-requestsById()` - Get data subject requests
-- `postData-subject-requests()` - Create data subject requests
-- `patchData-subject-requestsByIdStatus()` - Update status
+- `getData-subject-requests()` - /data-subject-requests operation on data_subject_request resource
+- `getData-subject-requestsById()` - /data-subject-requests/:id operation on data_subject_request resource
+- `postData-subject-requests()` - Open a new GDPR/CCPA data subject request (access, erasure, portability, rectification, or restriction)
+- `patchData-subject-requestsByIdStatus()` - Advance a data subject request through its lifecycle (pending → in_progress → completed / rejected / expired) and record notes or a completion timestamp.
 
 ## Document chunk
 
-- `getAiChunksDocumentByDocumentId()` - Get document
-- `postAiChunksSearch()` - Create search
+- `getAiChunksDocumentByDocumentId()` - Fetch all chunks for a document sorted by chunk_index ascending; equivalent to read_by_document — use for JSON:API access via /ai/chunks/document/:document_id.
+- `postAiChunksSearch()` - Run a similarity search and return matching chunks via the JSON:API endpoint (/ai/chunks/search); internally calls the :search read action and wraps results in a metadata envelope.
 
 ## Document Extraction
 
-- `getExtractionDocuments()` - List documents
-- `getExtractionDocumentsById()` - Get documents
-- `getExtractionDocumentsByIdStatus()` - Get status
-- `getExtractionDocumentsByIdView()` - Get view
-- `getExtractionDocumentsWorkspaceByWorkspaceId()` - Get workspace
-- `getExtractionDocumentsWorkspaceByWorkspaceIdBy-statusByStatus()` - Get by status
-- `getExtractionDocumentsWorkspaceByWorkspaceIdExcluded()` - Get excluded
-- `getExtractionDocumentsWorkspaceByWorkspaceIdReview-queue()` - Get review queue
-- `getExtractionDocumentsWorkspaceByWorkspaceIdTrained()` - Get trained
-- `getExtractionDocumentsWorkspaceByWorkspaceIdTrashed()` - Get trashed
-- `postExtractionDocumentsBegin-upload()` - Create begin upload
-- `postExtractionDocumentsFind-or-begin-upload()` - Create find or begin upload
-- `postExtractionDocumentsUpload()` - Create upload
-- `patchExtractionDocumentsByIdCancel()` - Update cancel
-- `patchExtractionDocumentsByIdDismiss()` - Update dismiss
-- `patchExtractionDocumentsByIdDismiss-training()` - Update dismiss training
-- `patchExtractionDocumentsByIdExclude()` - Update exclude
-- `patchExtractionDocumentsByIdFinish-upload()` - Update finish upload
-- `patchExtractionDocumentsByIdInclude()` - Update include
-- `patchExtractionDocumentsByIdMark-trained()` - Update mark trained
-- `patchExtractionDocumentsByIdReprocess()` - Update reprocess
-- `patchExtractionDocumentsByIdRestore()` - Update restore
-- `patchExtractionDocumentsByIdStatus()` - Update status
-- `patchExtractionDocumentsByIdVerification()` - Update verification
-- `deleteExtractionDocumentsById()` - Delete documents
+- `getExtractionDocuments()` - Primary read for active (non-deleted) documents
+- `getExtractionDocumentsById()` - Primary read for active (non-deleted) documents
+- `getExtractionDocumentsByIdStatus()` - Lightweight poll endpoint: fetches only `id`, `status`, `progress`, and `error_message` for
+a single document
+- `getExtractionDocumentsByIdView()` - Get a document with its presigned view URL
+- `getExtractionDocumentsWorkspaceByWorkspaceId()` - List active (non-deleted) documents in a workspace, sorted by creation date
+- `getExtractionDocumentsWorkspaceByWorkspaceIdBy-statusByStatus()` - Filter documents by workspace_id and processing status
+- `getExtractionDocumentsWorkspaceByWorkspaceIdExcluded()` - List excluded documents
+- `getExtractionDocumentsWorkspaceByWorkspaceIdReview-queue()` - Get prioritized review queue for active learning
+- `getExtractionDocumentsWorkspaceByWorkspaceIdTrained()` - List documents that have been trained and not dismissed
+- `getExtractionDocumentsWorkspaceByWorkspaceIdTrashed()` - List soft-deleted (trashed) documents
+- `postExtractionDocumentsBegin-upload()` - Step 1 of 2 in the two-step upload flow
+- `postExtractionDocumentsFind-or-begin-upload()` - Dedup-aware upload: returns existing document if file_hash matches, otherwise creates new document
+- `postExtractionDocumentsUpload()` - Legacy single-step upload: create a document record and immediately enqueue processing
+- `patchExtractionDocumentsByIdCancel()` - Cancel a processing document
+- `patchExtractionDocumentsByIdDismiss()` - Alias for `:dismiss_training`
+- `patchExtractionDocumentsByIdDismiss-training()` - Dismiss a trained document from the active-learning training dashboard without excluding it
+from future training
+- `patchExtractionDocumentsByIdExclude()` - Mark a document as excluded from agent training
+- `patchExtractionDocumentsByIdFinish-upload()` - Step 2 of 2 in the two-step upload flow
+- `patchExtractionDocumentsByIdInclude()` - Reverse an exclusion: allow a previously excluded document to contribute training examples
+again
+- `patchExtractionDocumentsByIdMark-trained()` - Record that a document has been used for agent training
+- `patchExtractionDocumentsByIdReprocess()` - Re-extract document with current or specified schema version
+- `patchExtractionDocumentsByIdRestore()` - Reverse an exclusion: allow a previously excluded document to contribute training examples
+again
+- `patchExtractionDocumentsByIdStatus()` - Internal-facing status update used by the web layer and API to set processing state
+- `patchExtractionDocumentsByIdVerification()` - Update the human verification status of a completed document
+- `deleteExtractionDocumentsById()` - Soft-delete a document and enqueue storage cleanup
 
 ## Document stats
 
-- `getDocumentsStats()` - List stats
+- `getDocumentsStats()` - /documents/stats operation on document_stats resource
 
 ## Email template
 
-- `getApplicationsByApplicationIdEmail-templates()` - Get email templates
-- `getApplicationsByApplicationIdEmail-templatesBySlug()` - Get email templates
-- `postApplicationsByApplicationIdEmail-templates()` - Create email templates
-- `postApplicationsByApplicationIdEmail-templatesBySlugPreview()` - Create preview
-- `postApplicationsByApplicationIdEmail-templatesBySlugTest()` - Create test
-- `patchApplicationsByApplicationIdEmail-templatesBySlug()` - Update email templates
-- `deleteApplicationsByApplicationIdEmail-templatesBySlug()` - Delete email templates
-
-## Email-marketing-campaign
-
-- `getEmail-marketingCampaignsById()` - Get campaigns
-- `getEmail-marketingCampaignsWorkspaceByWorkspaceId()` - Get workspace
-- `postEmail-marketingCampaigns()` - Create campaigns
-- `postEmail-marketingCampaignsByIdAnalyze()` - Create analyze
-- `postEmail-marketingCampaignsByIdCreate-followup()` - Create create followup
-- `postEmail-marketingCampaignsByIdExport()` - Create export
-- `postEmail-marketingCampaignsByIdGenerate-emails()` - Create generate emails
-- `postEmail-marketingCampaignsByIdImport-recipients()` - Create import recipients
-- `postEmail-marketingCampaignsByIdOptimize-send-times()` - Create optimize send times
-- `postEmail-marketingCampaignsByIdOptimize-subjects()` - Create optimize subjects
-- `postEmail-marketingCampaignsByIdSend()` - Create send
-- `patchEmail-marketingCampaignsById()` - Update campaigns
-- `deleteEmail-marketingCampaignsById()` - Delete campaigns
+- `getApplicationsByApplicationIdEmail-templates()` - List all email templates for the application, including both system and custom templates
+- `getApplicationsByApplicationIdEmail-templatesBySlug()` - Fetch a single email template by its slug within the given application
+- `postApplicationsByApplicationIdEmail-templates()` - Create a new custom email template for the application
+- `postApplicationsByApplicationIdEmail-templatesBySlugPreview()` - Preview email template with sample data
+- `postApplicationsByApplicationIdEmail-templatesBySlugTest()` - Send a test email using this template
+- `patchApplicationsByApplicationIdEmail-templatesBySlug()` - Update the display name, subject, body, branding color, or enabled state of an existing template
+- `deleteApplicationsByApplicationIdEmail-templatesBySlug()` - /applications/:application_id/email-templates/:slug operation on email_template resource
 
-## Email-marketing-generated-email
+## Email-inclusion
 
-- `getEmail-marketingGenerated-emailsById()` - Get generated emails
-- `getEmail-marketingGenerated-emailsCampaignByCampaignId()` - Get campaign
-- `patchEmail-marketingGenerated-emailsById()` - Update generated emails
-- `patchEmail-marketingGenerated-emailsByIdApprove()` - Update approve
-- `patchEmail-marketingGenerated-emailsByIdReject()` - Update reject
-- `patchEmail-marketingGenerated-emailsByIdSchedule()` - Update schedule
+- `getEmailInclusionsById()` - /email/inclusions/:id operation on email-inclusion resource
+- `getEmailInclusionsEmailByOutboundEmailId()` - /email/inclusions/email/:outbound_email_id operation on email-inclusion resource
+- `postEmailInclusions()` - /email/inclusions operation on email-inclusion resource
+- `patchEmailInclusionsById()` - /email/inclusions/:id operation on email-inclusion resource
+- `deleteEmailInclusionsById()` - /email/inclusions/:id operation on email-inclusion resource
 
-## Email-marketing-recipient
+## Email-marketing-generated-email
 
-- `getEmail-marketingRecipientsById()` - Get recipients
-- `getEmail-marketingRecipientsCampaignByCampaignId()` - Get campaign
+- `getEmail-marketingGenerated-emailsById()` - /email-marketing/generated-emails/:id operation on email-marketing-generated-email resource
+- `getEmail-marketingGenerated-emailsCampaignByCampaignId()` - /email-marketing/generated-emails/campaign/:campaign_id operation on email-marketing-generated-email resource
+- `patchEmail-marketingGenerated-emailsById()` - /email-marketing/generated-emails/:id operation on email-marketing-generated-email resource
+- `patchEmail-marketingGenerated-emailsByIdApprove()` - /email-marketing/generated-emails/:id/approve operation on email-marketing-generated-email resource
+- `patchEmail-marketingGenerated-emailsByIdReject()` - /email-marketing/generated-emails/:id/reject operation on email-marketing-generated-email resource
+- `patchEmail-marketingGenerated-emailsByIdSchedule()` - /email-marketing/generated-emails/:id/schedule operation on email-marketing-generated-email resource
 
-## Email-marketing-send-limit
+## Email-marketing-recipient
 
-- `getEmail-marketingSend-limitsById()` - Get send limits
-- `getEmail-marketingSend-limitsWorkspaceByWorkspaceId()` - Get workspace
+- `getCampaignsRecipientsById()` - /campaigns/recipients/:id operation on email-marketing-recipient resource
+- `getCampaignsRecipientsCampaignByCampaignId()` - /campaigns/recipients/campaign/:campaign_id operation on email-marketing-recipient resource
 
 ## Email-marketing-sender-profile
 
-- `getEmail-marketingSender-profilesById()` - Get sender profiles
-- `getEmail-marketingSender-profilesWorkspaceByWorkspaceId()` - Get workspace
-- `postEmail-marketingSender-profiles()` - Create sender profiles
-- `patchEmail-marketingSender-profilesById()` - Update sender profiles
-- `patchEmail-marketingSender-profilesByIdValidate-dns()` - Update validate dns
-- `deleteEmail-marketingSender-profilesById()` - Delete sender profiles
+- `getEmail-marketingSender-profilesById()` - /email-marketing/sender-profiles/:id operation on email-marketing-sender-profile resource
+- `getEmail-marketingSender-profilesWorkspaceByWorkspaceId()` - /email-marketing/sender-profiles/workspace/:workspace_id operation on email-marketing-sender-profile resource
+- `postEmail-marketingSender-profiles()` - /email-marketing/sender-profiles operation on email-marketing-sender-profile resource
+- `patchEmail-marketingSender-profilesById()` - /email-marketing/sender-profiles/:id operation on email-marketing-sender-profile resource
+- `patchEmail-marketingSender-profilesByIdSet-default()` - /email-marketing/sender-profiles/:id/set-default operation on email-marketing-sender-profile resource
+- `patchEmail-marketingSender-profilesByIdValidate-dns()` - /email-marketing/sender-profiles/:id/validate-dns operation on email-marketing-sender-profile resource
+- `deleteEmail-marketingSender-profilesById()` - /email-marketing/sender-profiles/:id operation on email-marketing-sender-profile resource
 
 ## Email-marketing-sequence
 
-- `getEmail-marketingSequencesById()` - Get sequences
-- `getEmail-marketingSequencesWorkspaceByWorkspaceId()` - Get workspace
-- `postEmail-marketingSequences()` - Create sequences
-- `patchEmail-marketingSequencesById()` - Update sequences
-- `patchEmail-marketingSequencesByIdActivate()` - Update activate
-- `patchEmail-marketingSequencesByIdComplete()` - Update complete
-- `patchEmail-marketingSequencesByIdPause()` - Update pause
-- `patchEmail-marketingSequencesByIdResume()` - Update resume
-- `deleteEmail-marketingSequencesById()` - Delete sequences
+- `getCampaignsSequencesById()` - /campaigns/sequences/:id operation on email-marketing-sequence resource
+- `getCampaignsSequencesWorkspaceByWorkspaceId()` - /campaigns/sequences/workspace/:workspace_id operation on email-marketing-sequence resource
+- `postCampaignsSequences()` - /campaigns/sequences operation on email-marketing-sequence resource
+- `patchCampaignsSequencesById()` - /campaigns/sequences/:id operation on email-marketing-sequence resource
+- `patchCampaignsSequencesByIdActivate()` - /campaigns/sequences/:id/activate operation on email-marketing-sequence resource
+- `patchCampaignsSequencesByIdComplete()` - /campaigns/sequences/:id/complete operation on email-marketing-sequence resource
+- `patchCampaignsSequencesByIdPause()` - /campaigns/sequences/:id/pause operation on email-marketing-sequence resource
+- `patchCampaignsSequencesByIdResume()` - /campaigns/sequences/:id/resume operation on email-marketing-sequence resource
+- `deleteCampaignsSequencesById()` - /campaigns/sequences/:id operation on email-marketing-sequence resource
 
 ## Email-marketing-sequence-step
 
-- `getEmail-marketingSequence-stepsById()` - Get sequence steps
-- `getEmail-marketingSequence-stepsSequenceBySequenceId()` - Get sequence
-- `postEmail-marketingSequence-steps()` - Create sequence steps
-- `patchEmail-marketingSequence-stepsById()` - Update sequence steps
-- `deleteEmail-marketingSequence-stepsById()` - Delete sequence steps
+- `getCampaignsSequence-stepsById()` - /campaigns/sequence-steps/:id operation on email-marketing-sequence-step resource
+- `getCampaignsSequence-stepsSequenceBySequenceId()` - /campaigns/sequence-steps/sequence/:sequence_id operation on email-marketing-sequence-step resource
+- `postCampaignsSequence-steps()` - /campaigns/sequence-steps operation on email-marketing-sequence-step resource
+- `patchCampaignsSequence-stepsById()` - /campaigns/sequence-steps/:id operation on email-marketing-sequence-step resource
+- `deleteCampaignsSequence-stepsById()` - /campaigns/sequence-steps/:id operation on email-marketing-sequence-step resource
 
 ## Email-marketing-template
 
-- `getEmail-marketingTemplatesById()` - Get templates
-- `getEmail-marketingTemplatesWorkspaceByWorkspaceId()` - Get workspace
-- `postEmail-marketingTemplates()` - Create templates
-- `patchEmail-marketingTemplatesById()` - Update templates
-- `patchEmail-marketingTemplatesByIdArchive()` - Update archive
-- `patchEmail-marketingTemplatesByIdRestore()` - Update restore
-- `deleteEmail-marketingTemplatesById()` - Delete templates
-
-## Email-marketing-tracking-event
-
-- `getEmail-marketingTracking-eventsById()` - Get tracking events
-- `getEmail-marketingTracking-eventsCampaignByCampaignId()` - Get campaign
+- `getEmail-marketingTemplatesById()` - /email-marketing/templates/:id operation on email-marketing-template resource
+- `getEmail-marketingTemplatesWorkspaceByWorkspaceId()` - /email-marketing/templates/workspace/:workspace_id operation on email-marketing-template resource
+- `postEmail-marketingTemplates()` - /email-marketing/templates operation on email-marketing-template resource
+- `postEmail-marketingTemplatesCompile()` - Stateless MJML → HTML compilation
+- `patchEmail-marketingTemplatesById()` - /email-marketing/templates/:id operation on email-marketing-template resource
+- `patchEmail-marketingTemplatesByIdArchive()` - /email-marketing/templates/:id/archive operation on email-marketing-template resource
+- `patchEmail-marketingTemplatesByIdPreview()` - Renders published_body_html with variable substitutions for preview
+- `patchEmail-marketingTemplatesByIdPublish()` - Compiles MJML, snapshots to published_body_html, creates TemplateVersion, bumps current_version.
+- `patchEmail-marketingTemplatesByIdRestore()` - /email-marketing/templates/:id/restore operation on email-marketing-template resource
+- `patchEmail-marketingTemplatesByIdRollback()` - Restores body_mjml from a previously published TemplateVersion snapshot.
+- `patchEmail-marketingTemplatesByIdUnpublish()` - Clears published_at — template reverts to draft state.
+- `deleteEmail-marketingTemplatesById()` - /email-marketing/templates/:id operation on email-marketing-template resource
+
+## Email-outbound-email
+
+- `getEmailOutbound-emailsById()` - /email/outbound-emails/:id operation on email-outbound-email resource
+- `getEmailOutbound-emailsWorkspaceByWorkspaceId()` - /email/outbound-emails/workspace/:workspace_id operation on email-outbound-email resource
+- `getEmailOutbound-emailsWorkspaceByWorkspaceIdContactByContactRefId()` - /email/outbound-emails/workspace/:workspace_id/contact/:contact_ref_id operation on email-outbound-email resource
+- `postEmailOutbound-emails()` - /email/outbound-emails operation on email-outbound-email resource
+- `postEmailOutbound-emailsCompose-with-ai()` - AI-draft an email from a prompt and context map.
+- `patchEmailOutbound-emailsById()` - /email/outbound-emails/:id operation on email-outbound-email resource
+- `patchEmailOutbound-emailsByIdCancel-schedule()` - /email/outbound-emails/:id/cancel-schedule operation on email-outbound-email resource
+- `patchEmailOutbound-emailsByIdSchedule()` - /email/outbound-emails/:id/schedule operation on email-outbound-email resource
+- `patchEmailOutbound-emailsByIdSend()` - Deliver this email immediately via connected account.
+- `deleteEmailOutbound-emailsById()` - /email/outbound-emails/:id operation on email-outbound-email resource
+
+## Email-recipient
+
+- `getEmailRecipientsById()` - /email/recipients/:id operation on email-recipient resource
+- `getEmailRecipientsEmailByOutboundEmailId()` - /email/recipients/email/:outbound_email_id operation on email-recipient resource
+- `postEmailRecipients()` - /email/recipients operation on email-recipient resource
+- `deleteEmailRecipientsById()` - /email/recipients/:id operation on email-recipient resource
+
+## Email-tracking-event
+
+- `getEmailTracking-eventsById()` - /email/tracking-events/:id operation on email-tracking-event resource
+- `getEmailTracking-eventsWorkspaceByWorkspaceId()` - /email/tracking-events/workspace/:workspace_id operation on email-tracking-event resource
+
+## Email-unsubscriber
+
+- `getEmail-marketingUnsubscribersById()` - /email-marketing/unsubscribers/:id operation on email-unsubscriber resource
+- `getEmail-marketingUnsubscribersWorkspaceByWorkspaceId()` - /email-marketing/unsubscribers/workspace/:workspace_id operation on email-unsubscriber resource
 
 ## Embedding
 
-- `postAiEmbed()` - Create embed
+- `postAiEmbed()` - Generate a 1024-dim vector embedding for the given text via the LlmTriage sidecar; validates workspace membership, estimates token cost, charges credits, and returns the embedding with usage stats.
 
 ## Extraction Batches
 
-- `getExtractionBatchesById()` - Get batches
-- `getExtractionBatchesByIdUpload-urls()` - Get upload urls
-- `getExtractionBatchesWorkspaceByWorkspaceId()` - Get workspace
-- `postExtractionBatches()` - Create batches
-- `deleteExtractionBatchesById()` - Delete batches
+- `getExtractionBatchesById()` - /extraction/batches/:id operation on extraction_batch resource
+- `getExtractionBatchesByIdUpload-urls()` - Generate presigned URLs for batch document upload
+- `getExtractionBatchesWorkspaceByWorkspaceId()` - List all batches for a workspace, unfiltered and unpaginated
+- `postExtractionBatches()` - Create a new extraction batch to group related documents
+- `deleteExtractionBatchesById()` - /extraction/batches/:id operation on extraction_batch resource
 
 ## Extraction export
 
-- `getWorkspacesByWorkspaceIdExtractionExports()` - Get exports
-- `getWorkspacesByWorkspaceIdExtractionExportsById()` - Get exports
-- `postWorkspacesByWorkspaceIdExtractionExports()` - Create exports
+- `getWorkspacesByWorkspaceIdExtractionExports()` - List exports for a workspace, filtered by status
+- `getWorkspacesByWorkspaceIdExtractionExportsById()` - /workspaces/:workspace_id/extraction/exports/:id operation on extraction_export resource
+- `postWorkspacesByWorkspaceIdExtractionExports()` - /workspaces/:workspace_id/extraction/exports operation on extraction_export resource
 
 ## Extraction Results
 
-- `getExtractionResults()` - List results
-- `getExtractionResultsById()` - Get results
-- `getExtractionResultsDocumentByDocumentId()` - Get document
-- `getExtractionResultsDocumentByDocumentIdHistory()` - Get history
-- `getExtractionResultsDocumentByDocumentIdPartial()` - Get partial
-- `getExtractionResultsWorkspaceByWorkspaceId()` - Get workspace
-- `patchExtractionResultsById()` - Update results
-- `patchExtractionResultsByIdRegenerate()` - Update regenerate
-- `patchExtractionResultsByIdSave-corrections()` - Update save corrections
-- `deleteExtractionResultsById()` - Delete results
+- `getExtractionResults()` - Primary read for extraction results
+- `getExtractionResultsById()` - Fetch a single ExtractionResult by ID
+- `getExtractionResultsDocumentByDocumentId()` - Fetch the latest ExtractionResult for a given document
+- `getExtractionResultsDocumentByDocumentIdHistory()` - List all ExtractionResults for a document in reverse-chronological order (newest first)
+- `getExtractionResultsDocumentByDocumentIdPartial()` - Get the latest extraction result for a document including partial (in-progress) results with per-field status
+- `getExtractionResultsWorkspaceByWorkspaceId()` - List all ExtractionResults in a workspace, sorted newest first
+- `patchExtractionResultsById()` - General-purpose update for an ExtractionResult
+- `patchExtractionResultsByIdRegenerate()` - Re-run extraction on an existing result, optionally with user feedback or targeting specific
+fields
+- `patchExtractionResultsByIdSave-corrections()` - Apply human corrections to extracted field values
+- `deleteExtractionResultsById()` - Delete an ExtractionResult record
 
 ## Field mapping confirmation
 
-- `postWorkspacesByWorkspaceIdExtractionByDocumentIdMapping()` - Create mapping
+- `postWorkspacesByWorkspaceIdExtractionByDocumentIdMapping()` - /workspaces/:workspace_id/extraction/:document_id/mapping operation on field_mapping_confirmation resource
 
 ## Field mapping result
 
-- `getWorkspacesByWorkspaceIdExtractionByDocumentIdMapping()` - Get mapping
+- `getWorkspacesByWorkspaceIdExtractionByDocumentIdMapping()` - /workspaces/:workspace_id/extraction/:document_id/mapping operation on field_mapping_result resource
 
 ## Field Templates
 
-- `getField-templates()` - List field templates
-- `getField-templatesById()` - Get field templates
-- `postField-templates()` - Create field templates
-- `deleteField-templatesById()` - Delete field templates
+- `getField-templates()` - /field-templates operation on field_template resource
+- `getField-templatesById()` - /field-templates/:id operation on field_template resource
+- `postField-templates()` - /field-templates operation on field_template resource
+- `deleteField-templatesById()` - /field-templates/:id operation on field_template resource
 
 ## Invitations
 
-- `getInvitations()` - List invitations
-- `getInvitationsConsumeByToken()` - Get consume
-- `getInvitationsMe()` - List me
-- `postInvitations()` - Create invitations
-- `postInvitationsAccept-by-token()` - Create accept by token
-- `patchInvitationsByIdAccept()` - Update accept
-- `patchInvitationsByIdAccept-by-user()` - Update accept by user
-- `patchInvitationsByIdDecline()` - Update decline
-- `patchInvitationsByIdResend()` - Update resend
-- `patchInvitationsByIdRevoke()` - Update revoke
+- `getInvitations()` - List invitations visible to the actor
+- `getInvitationsConsumeByToken()` - Look up a pending, non-expired invitation by its raw token
+- `getInvitationsMe()` - List all pending invitations addressed to the authenticated actor's email
+- `postInvitations()` - Send an invitation to a user to join a tenant or workspace
+- `postInvitationsAccept-by-token()` - Accept an invitation using only the token
+- `patchInvitationsByIdAccept()` - Accept a pending invitation using a token and the authenticated actor's identity
+- `patchInvitationsByIdAccept-by-user()` - Accept an invitation on behalf of a specific user (by user_id)
+- `patchInvitationsByIdDecline()` - Decline a pending invitation
+- `patchInvitationsByIdResend()` - Resend an invitation email with a refreshed token and a new 7-day expiry
+- `patchInvitationsByIdRevoke()` - Cancel a pending invitation by setting its status to :revoked
 
 ## Invoice
 
-- `getWalletInvoices()` - List invoices
+- `getWalletInvoices()` - Read all invoices for the current tenant
 
 ## Knowledge Graph
 
-- `getAiGraphNodes()` - List nodes
-- `getAiGraphNodesLabelByLabel()` - Get label
-- `postAiGraphNodes()` - Create nodes
-- `deleteAiGraphNodesById()` - Delete nodes
+- `getAiGraphNodes()` - Paginate Entity vertices for the caller's tenant; returns up to 50 nodes per page by default.
+- `getAiGraphNodesLabelByLabel()` - Find all Entity vertices with an exact label match; use to look up a specific named entity in the knowledge graph.
+- `postAiGraphNodes()` - Create an Entity vertex in the knowledge graph; tenant_id is always forced from the actor and cannot be supplied by the caller
+- `deleteAiGraphNodesById()` - /ai/graph/nodes/:id operation on graph_node resource
 
 ## Legal acceptance
 
-- `getLegal-acceptances()` - List legal acceptances
-- `getLegal-acceptancesById()` - Get legal acceptances
-- `getLegal-acceptancesLatest()` - List latest
+- `getLegal-acceptances()` - /legal-acceptances operation on legal_acceptance resource
+- `getLegal-acceptancesById()` - /legal-acceptances/:id operation on legal_acceptance resource
+- `getLegal-acceptancesLatest()` - Fetch the most recent acceptance record for a given user and document type
 
 ## Legal document
 
-- `getLegal-documents()` - List legal documents
-- `getLegal-documentsBy-locale()` - List by locale
-- `getLegal-documentsById()` - Get legal documents
-- `getLegal-documentsFor-application()` - List for application
-- `postLegal-documents()` - Create legal documents
-- `patchLegal-documentsById()` - Update legal documents
-- `patchLegal-documentsByIdPublish()` - Update publish
-- `patchLegal-documentsByIdUnpublish()` - Update unpublish
-- `deleteLegal-documentsById()` - Delete legal documents
+- `getLegal-documents()` - /legal-documents operation on legal_document resource
+- `getLegal-documentsBy-locale()` - Fetch active legal documents filtered by locale and optional region, used to display the appropriate ToS or Privacy Policy to a user based on their location.
+- `getLegal-documentsById()` - /legal-documents/:id operation on legal_document resource
+- `getLegal-documentsFor-application()` - List legal documents scoped to the current application context, including platform-level documents (null application_id) and application-specific overrides
+- `postLegal-documents()` - Create a new versioned legal document (Terms of Service, Privacy Policy, BAA, DPA, or SCC)
+- `patchLegal-documentsById()` - Edit draft document content, locale, region, or scheduling fields
+- `patchLegal-documentsByIdPublish()` - Make a legal document live
+- `patchLegal-documentsByIdUnpublish()` - Deactivate a legal document without deleting it
+- `deleteLegal-documentsById()` - /legal-documents/:id operation on legal_document resource
 
 ## Messages
 
-- `getAiMessages()` - List messages
-- `getMessages()` - List messages
-- `getMessagesById()` - Get messages
-- `getMessagesSearch()` - List search
-- `getMessagesSemantic-search()` - List semantic search
-- `getThreadsByIdMessages()` - Get messages
-- `postAiMessages()` - Create messages
-- `postMessages()` - Create messages
-- `patchMessagesById()` - Update messages
-- `deleteAiMessagesById()` - Delete messages
-- `deleteMessagesById()` - Delete messages
+- `getAiMessages()` - /ai/messages operation on message resource
+- `getMessages()` - /messages operation on message resource
+- `getMessagesById()` - /messages/:id operation on message resource
+- `getMessagesSearch()` - Full-text search messages by substring match on content within the actor's accessible threads
+- `getMessagesSemantic-search()` - Vector similarity search across messages using a generated embedding of the query string
+- `getThreadsByIdMessages()` - /threads/:id/messages operation on message resource
+- `postAiMessages()` - Append a new message turn (system, user, or assistant) to a Conversation
+- `postMessages()` - Add a new message turn to a thread
+- `patchMessagesById()` - Edit a message's content, role, or metadata
+- `deleteAiMessagesById()` - /ai/messages/:id operation on message resource
+- `deleteMessagesById()` - /messages/:id operation on message resource
 
 ## Notification log
 
-- `getNotification-logs()` - List notification logs
-- `getNotification-logsById()` - Get notification logs
-- `getNotification-logsStats()` - List stats
+- `getNotification-logs()` - /notification-logs operation on notification_log resource
+- `getNotification-logsById()` - /notification-logs/:id operation on notification_log resource
+- `getNotification-logsStats()` - Get notification log statistics
 
 ## Notification method
 
-- `getNotification-methods()` - List notification methods
-- `getNotification-methodsById()` - Get notification methods
-- `postNotification-methods()` - Create notification methods
-- `patchNotification-methodsById()` - Update notification methods
-- `patchNotification-methodsByIdSend-verification()` - Update send verification
-- `patchNotification-methodsByIdSet-primary()` - Update set primary
-- `patchNotification-methodsByIdVerify()` - Update verify
-- `deleteNotification-methodsById()` - Delete notification methods
+- `getNotification-methods()` - /notification-methods operation on notification_method resource
+- `getNotification-methodsById()` - /notification-methods/:id operation on notification_method resource
+- `postNotification-methods()` - Register a new notification delivery channel for a user (email address, phone number, Slack webhook, or generic webhook URL)
+- `patchNotification-methodsById()` - Update the display name or connection config for an existing notification method
+- `patchNotification-methodsByIdSend-verification()` - Generate a 6-digit verification code, store it as `verification_token`, and record `verification_sent_at`
+- `patchNotification-methodsByIdSet-primary()` - Mark this notification method as the primary channel for its type, used when multiple methods of the same type exist.
+- `patchNotification-methodsByIdVerify()` - Mark the notification method as verified by setting `verified_at` to the current timestamp
+- `deleteNotification-methodsById()` - /notification-methods/:id operation on notification_method resource
 
 ## Notification preference
 
-- `getNotification-preferences()` - List notification preferences
-- `getNotification-preferencesById()` - Get notification preferences
-- `postNotification-preferences()` - Create notification preferences
-- `patchNotification-preferencesById()` - Update notification preferences
-- `deleteNotification-preferencesById()` - Delete notification preferences
+- `getNotification-preferences()` - /notification-preferences operation on notification_preference resource
+- `getNotification-preferencesById()` - /notification-preferences/:id operation on notification_preference resource
+- `postNotification-preferences()` - Create notification preferences for a user, specifying which delivery channels are enabled (e.g., email, SMS) and category-level opt-in/out settings
+- `patchNotification-preferencesById()` - Update a user's notification channel list or per-category preferences
+- `deleteNotification-preferencesById()` - /notification-preferences/:id operation on notification_preference resource
 
 ## Operation success
 
-- `postDocumentsBulk-delete()` - Create bulk delete
+- `postDocumentsBulk-delete()` - /documents/bulk-delete operation on operation_success resource
 
 ## Payment method
 
-- `getPayment-methods()` - List payment methods
-- `getPayment-methodsById()` - Get payment methods
-- `postPayment-methods()` - Create payment methods
-- `postPayment-methodsTokenize()` - Create tokenize
-- `patchPayment-methodsById()` - Update payment methods
-- `patchPayment-methodsByIdDefault()` - Update default
-- `deletePayment-methodsById()` - Delete payment methods
+- `getPayment-methods()` - /payment-methods operation on payment_method resource
+- `getPayment-methodsById()` - /payment-methods/:id operation on payment_method resource
+- `postPayment-methods()` - Save a pre-tokenized payment method for a customer
+- `postPayment-methodsTokenize()` - Create a payment method via direct proxy tokenization (S2S)
+- `patchPayment-methodsById()` - Update a saved payment method's nickname or default status
+- `patchPayment-methodsByIdDefault()` - Set this payment method as default for the customer
+- `deletePayment-methodsById()` - /payment-methods/:id operation on payment_method resource
 
 ## Permission
 
-- `getPermissions()` - List permissions
-- `getPermissionsById()` - Get permissions
-- `getPermissionsPresets()` - List presets
+- `getPermissions()` - List all platform permissions for a given context (:tenant or :workspace); returns permission metadata from the PermissionRegistry for use in permission-picker UIs.
+- `getPermissionsById()` - Fetch all permissions and apply any query filters supplied by the caller; use :by_id for single-record lookup by permission ID string.
+- `getPermissionsPresets()` - List role presets (admin, member, viewer, etc.) for a given context (:tenant or :workspace); each preset includes its name, description, and the full permission list it grants.
 
 ## Permission meta
 
-- `getPermissionsMeta()` - List meta
+- `getPermissionsMeta()` - Fetch a single metadata record describing the permission system — schema version, available apps, scopes, categories, and suggested client cache TTL
 
 ## Permission preset
 
-- `getPermissionsPresetsById()` - Get presets
+- `getPermissionsPresetsById()` - Fetch a single permission preset by its composite ID (e.g., 'workspace:org:admin'); returns the preset with its full permission list or a not-found error.
 
 ## Presigned url
 
-- `postDocumentsPresigned-upload()` - Create presigned upload
+- `postDocumentsPresigned-upload()` - /documents/presigned-upload operation on presigned_url resource
 
 ## Processing activity
 
-- `getProcessing-activities()` - List processing activities
-- `getProcessing-activitiesById()` - Get processing activities
-- `postProcessing-activities()` - Create processing activities
-- `deleteProcessing-activitiesById()` - Delete processing activities
+- `getProcessing-activities()` - /processing-activities operation on processing_activity resource
+- `getProcessing-activitiesById()` - /processing-activities/:id operation on processing_activity resource
+- `postProcessing-activities()` - Add a new GDPR Article 30 Record of Processing Activities (ROPA) entry, documenting a processing purpose, the categories of personal data processed, data subjects, recipients, and legal basis for the workspace.
+- `deleteProcessing-activitiesById()` - /processing-activities/:id operation on processing_activity resource
 
 ## Retention policy
 
-- `getRetention-policies()` - List retention policies
-- `getRetention-policiesById()` - Get retention policies
-- `postRetention-policies()` - Create retention policies
-- `patchRetention-policiesById()` - Update retention policies
-- `deleteRetention-policiesById()` - Delete retention policies
+- `getRetention-policies()` - /retention-policies operation on retention_policy resource
+- `getRetention-policiesById()` - /retention-policies/:id operation on retention_policy resource
+- `postRetention-policies()` - Define a data retention rule for a specific data category in a workspace
+- `patchRetention-policiesById()` - Modify the retention period, expiry action, or enabled state of an existing policy
+- `deleteRetention-policiesById()` - /retention-policies/:id operation on retention_policy resource
 
 ## Role
 
-- `getRoles()` - List roles
-- `postRoles()` - Create roles
-- `patchRolesById()` - Update roles
-- `deleteRolesById()` - Delete roles
+- `getRoles()` - /roles operation on role resource
+- `postRoles()` - Create a new role (permission bundle); creates a system default if application_id is nil, or an ISV application role if application_id is supplied
+- `patchRolesById()` - Update a role's name, description, or permission list; does NOT retroactively update existing TenantMemberships — use bulk_refresh_memberships for that
+- `deleteRolesById()` - Delete a role; emits a RoleDeleted audit event
 
 ## Scan result
 
-- `getScan-results()` - List scan results
-- `getScan-resultsById()` - Get scan results
+- `getScan-results()` - /scan-results operation on scan_result resource
+- `getScan-resultsById()` - /scan-results/:id operation on scan_result resource
 
 ## Scheduling booking
 
-- `getSchedulingBookings()` - List bookings
-- `getSchedulingBookingsById()` - Get bookings
-- `postSchedulingBookings()` - Create bookings
-- `patchSchedulingBookingsSchedulingBookingsByIdCancel()` - Update cancel
-- `patchSchedulingBookingsSchedulingBookingsByIdConfirm()` - Update confirm
-- `patchSchedulingBookingsSchedulingBookingsByIdReschedule()` - Update reschedule
+- `getSchedulingBookings()` - List all bookings for a workspace
+- `getSchedulingBookingsById()` - Fetch a single booking by ID
+- `postSchedulingBookings()` - Create a booking for an external party claiming a time slot
+- `patchSchedulingBookingsSchedulingBookingsByIdCancel()` - Cancel a booking, recording cancellation_reason and cancelled_by (:booker/:organizer/:system)
+- `patchSchedulingBookingsSchedulingBookingsByIdConfirm()` - Approve a pending booking, setting status to :confirmed and confirmed_at timestamp
+- `patchSchedulingBookingsSchedulingBookingsByIdReschedule()` - Reschedule a booking by moving its linked Event to new_start_time/new_end_time
 
 ## Scheduling calendar sync
 
-- `getSchedulingCalendar-syncs()` - List calendar syncs
-- `getSchedulingCalendar-syncsById()` - Get calendar syncs
-- `postSchedulingCalendar-syncs()` - Create calendar syncs
-- `patchSchedulingCalendar-syncsSchedulingCalendar-syncsById()` - Update calendar syncs
-- `patchSchedulingCalendar-syncsSchedulingCalendar-syncsByIdPause()` - Update pause
-- `patchSchedulingCalendar-syncsSchedulingCalendar-syncsByIdResume()` - Update resume
-- `deleteSchedulingCalendar-syncsSchedulingCalendar-syncsById()` - Delete calendar syncs
+- `getSchedulingCalendar-syncs()` - List all calendar sync configurations for a specific user
+- `getSchedulingCalendar-syncsById()` - Fetch a single calendar sync configuration by ID
+- `postSchedulingCalendar-syncs()` - Link a user's external calendar for bi-directional sync
+- `patchSchedulingCalendar-syncsSchedulingCalendar-syncsById()` - Update calendar sync settings: name, direction, poll interval, or custom metadata
+- `patchSchedulingCalendar-syncsSchedulingCalendar-syncsByIdPause()` - Pause calendar sync by setting sync_status to :paused
+- `patchSchedulingCalendar-syncsSchedulingCalendar-syncsByIdResume()` - Resume a paused or errored calendar sync
+- `deleteSchedulingCalendar-syncsSchedulingCalendar-syncsById()` - Hard-delete a calendar sync configuration, stopping all future sync runs for this calendar
 
 ## Scheduling event
 
-- `getSchedulingEvents()` - List events
-- `getSchedulingEventsById()` - Get events
-- `postSchedulingEvents()` - Create events
-- `patchSchedulingEventsById()` - Update events
+- `getSchedulingEvents()` - List all events in a workspace, newest first
+- `getSchedulingEventsById()` - Fetch a single event by ID
+- `postSchedulingEvents()` - Create a scheduled event occurrence
+- `patchSchedulingEventsById()` - Update event metadata: title, description, timezone, location, notes, or custom metadata
 
 ## Scheduling event type
 
-- `getSchedulingEvent-types()` - List event types
-- `getSchedulingEvent-typesById()` - Get event types
-- `postSchedulingEvent-types()` - Create event types
-- `patchSchedulingEvent-typesById()` - Update event types
+- `getSchedulingEvent-types()` - List all active event types for a workspace
+- `getSchedulingEvent-typesById()` - Fetch a single event type by ID
+- `postSchedulingEvent-types()` - Create an event type template for a workspace
+- `patchSchedulingEvent-typesById()` - Update event type configuration including duration, buffers, location, capacity, and intake form
 
 ## Scheduling participant
 
-- `getSchedulingParticipants()` - List participants
-- `getSchedulingParticipantsById()` - Get participants
-- `postSchedulingParticipants()` - Create participants
-- `patchSchedulingParticipantsById()` - Update participants
+- `getSchedulingParticipants()` - List all participants for a specific event, including organizer and attendees
+- `getSchedulingParticipantsById()` - Fetch a single participant by ID
+- `postSchedulingParticipants()` - Add a participant to an event
+- `patchSchedulingParticipantsById()` - Update participant metadata: name, phone, role, or custom metadata
 
 ## Schema discovery
 
-- `getExtractionSchema-discoveriesById()` - Get schema discoveries
-- `postExtractionSchema-discoveries()` - Create schema discoveries
-- `postExtractionSchema-discoveriesBootstrap()` - Create bootstrap
+- `getExtractionSchema-discoveriesById()` - /extraction/schema-discoveries/:id operation on schema_discovery resource
+- `postExtractionSchema-discoveries()` - /extraction/schema-discoveries operation on schema_discovery resource
+- `postExtractionSchema-discoveriesBootstrap()` - Bootstrap schema discovery without an agent
 
 ## Search
 
-- `getSearch()` - List search
-- `getSearchHealth()` - List health
-- `getSearchIndexes()` - List indexes
-- `getSearchSaved()` - List saved
-- `getSearchSemantic()` - List semantic
-- `getSearchStats()` - List stats
-- `getSearchStatus()` - List status
-- `getSearchSuggest()` - List suggest
-- `postAiSearch()` - Create search
-- `postAiSearchAdvanced()` - Create advanced
-- `postSearchBatch()` - Create batch
-- `postSearchReindex()` - Create reindex
-- `postSearchSaved()` - Create saved
-- `postSearchSavedByIdRun()` - Create run
-- `patchSearchSavedById()` - Update saved
-- `deleteSearchSavedById()` - Delete saved
+- `getSearch()` - Full-text keyword search via Meilisearch across users, tenants, and documents
+- `getSearchHealth()` - Check Meilisearch server health, returning status and latency
+- `getSearchIndexes()` - Return the names of all configured Meilisearch indexes
+- `getSearchSaved()` - List saved searches accessible to the current actor: the actor's own searches and any searches marked `is_shared` within the same tenant.
+- `getSearchSemantic()` - Vector similarity search across document chunks using a generated embedding of the query
+- `getSearchStats()` - Return Meilisearch database size and per-index document counts
+- `getSearchStatus()` - Return the current status and tenant context for the search indexes
+- `getSearchSuggest()` - Return typeahead suggestions for a query prefix
+- `postAiSearch()` - Run a semantic similarity search against vectorized document chunks for the caller's tenant; embeds the query text and returns the top-k most relevant chunks ranked by cosine similarity.
+- `postAiSearchAdvanced()` - Run a filtered semantic search with additional constraints on document type, date range, or specific workspace IDs; use when basic search results need to be scoped to a subset of the tenant's content.
+- `postSearchBatch()` - Execute multiple search queries in a single request and return the combined results
+- `postSearchReindex()` - Trigger a Meilisearch reindex for all or a specific subset of indexes (users, tenants, documents)
+- `postSearchSaved()` - Persist a named search query for reuse
+- `postSearchSavedByIdRun()` - Re-execute a saved search by ID and return the saved search metadata enriched with an `executed_at` ISO-8601 timestamp
+- `patchSearchSavedById()` - Modify the name, query string, search type, filters, or sharing status of an existing saved search
+- `deleteSearchSavedById()` - /search/saved/:id operation on saved_search resource
 
 ## Search analytics
 
-- `getSearchAnalytics()` - List analytics
-- `getSearchAnalyticsSummary()` - List summary
+- `getSearchAnalytics()` - List search analytics with tenant-based filtering
+- `getSearchAnalyticsSummary()` - Aggregated search analytics summary (platform admin only)
 
 ## Storage
 
-- `getBuckets()` - List buckets
-- `getBucketsAll()` - List all
-- `getBucketsById()` - Get buckets
-- `getBucketsByIdStats()` - Get stats
-- `postBuckets()` - Create buckets
-- `patchBucketsById()` - Update buckets
-- `deleteBucketsById()` - Delete buckets
+- `getBuckets()` - List or fetch buckets; excludes processing-type buckets by default
+- `getBucketsAll()` - Read all buckets including system/processing buckets
+- `getBucketsById()` - List or fetch buckets; excludes processing-type buckets by default
+- `getBucketsByIdStats()` - Fetch a single bucket with the storage_used calculation (total bytes across all workspace files in this bucket).
+- `postBuckets()` - Create a bucket record and provision it in object storage (GCS in prod, MinIO in dev); sets lifecycle rules and public policy if type is :public
+- `patchBucketsById()` - Update the region of an existing bucket
+- `deleteBucketsById()` - Delete a bucket from the database and attempt to remove it from object storage; fails if any StorageFile records still reference this bucket.
 
 ## Storage file
 
-- `getStorage-files()` - List storage files
-- `getStorage-filesById()` - Get storage files
-- `postStorage-files()` - Create storage files
-- `patchStorage-filesById()` - Update storage files
-- `patchStorage-filesByIdSoft-delete()` - Update soft delete
+- `getStorage-files()` - /storage-files operation on storage_file resource
+- `getStorage-filesById()` - /storage-files/:id operation on storage_file resource
+- `postStorage-files()` - Create a StorageFile tracking record; use Storage.request_upload/5 via the facade for the full two-phase upload flow with presigned URLs.
+- `patchStorage-filesById()` - Update file metadata, tags, visibility, key, namespace, or status
+- `patchStorage-filesByIdSoft-delete()` - Mark an active file as pending_deletion; the S3 object is deleted by PendingDeletionWorker after the grace period
 
 ## Support tag
 
-- `getSupportTagsWorkspaceByWorkspaceId()` - Get workspace
-- `postSupportTags()` - Create tags
-- `deleteSupportTagsById()` - Delete tags
+- `getSupportTagsWorkspaceByWorkspaceId()` - List all tags defined for a workspace
+- `postSupportTags()` - Create a workspace-scoped ticket tag
+- `deleteSupportTagsById()` - Hard-delete a tag
 
 ## Support ticket
 
-- `getSupportTicketsById()` - Get tickets
-- `getSupportTicketsWorkspaceByWorkspaceId()` - Get workspace
-- `postSupportTickets()` - Create tickets
-- `patchSupportTicketsById()` - Update tickets
-- `deleteSupportTicketsById()` - Delete tickets
+- `getSupportTicketsById()` - Fetch a single active ticket by ID
+- `getSupportTicketsWorkspaceByWorkspaceId()` - List active tickets for a workspace, optionally filtered by status, priority, queue, or agent
+- `postSupportTickets()` - Create a support ticket
+- `patchSupportTicketsById()` - Update ticket fields including status (validated by ValidStatusTransition), queue assignment, SLA, and AI classification fields
+- `deleteSupportTicketsById()` - Soft-delete a ticket by setting deleted_at
 
 ## Support ticket attachment
 
-- `getSupportTicket-attachmentsMessageByTicketMessageId()` - Get message
-- `postSupportTicket-attachments()` - Create ticket attachments
+- `getSupportTicket-attachmentsMessageByTicketMessageId()` - List all attachments for a specific ticket message
+- `postSupportTicket-attachments()` - Register a file attachment on a ticket message
 
 ## Support ticket message
 
-- `getSupportTicket-messagesTicketByTicketId()` - Get ticket
-- `postSupportTicket-messages()` - Create ticket messages
+- `getSupportTicket-messagesTicketByTicketId()` - List all messages on a ticket in chronological order
+- `postSupportTicket-messages()` - Add a message to a ticket thread
 
 ## Support ticket rating
 
-- `postSupportTicket-ratings()` - Create ticket ratings
+- `postSupportTicket-ratings()` - Submit or update a CSAT rating (1-5) for a resolved ticket
 
 ## Tenant document stats
 
-- `getTenantsByTenantIdDocumentStats()` - Get document stats
+- `getTenantsByTenantIdDocumentStats()` - /tenants/:tenant_id/document_stats operation on tenant_document_stats resource
 
 ## Tenant stats
 
-- `getTenantsByTenantIdStats()` - Get stats
+- `getTenantsByTenantIdStats()` - /tenants/:tenant_id/stats operation on tenant_stats resource
 
 ## Tenant-membership
 
-- `getTenant-memberships()` - List tenant memberships
-- `postTenant-memberships()` - Create tenant memberships
-- `patchTenant-membershipsByTenantIdByUserId()` - Update tenant memberships
-- `deleteTenant-membershipsByTenantIdByUserId()` - Delete tenant memberships
+- `getTenant-memberships()` - /tenant-memberships operation on tenant-membership resource
+- `postTenant-memberships()` - /tenant-memberships operation on tenant-membership resource
+- `patchTenant-membershipsByTenantIdByUserId()` - /tenant-memberships/:tenant_id/:user_id operation on tenant-membership resource
+- `deleteTenant-membershipsByTenantIdByUserId()` - /tenant-memberships/:tenant_id/:user_id operation on tenant-membership resource
 
 ## Tenants
 
-- `getTenants()` - List tenants
-- `getTenantsById()` - Get tenants
-- `postTenants()` - Create tenants
-- `postTenantsByIdCredit()` - Create credit
-- `postTenantsByIdSchedule-purge()` - Create schedule purge
-- `postTenantsIsv()` - Create isv
-- `patchTenantsById()` - Update tenants
-- `deleteTenantsById()` - Delete tenants
+- `getTenants()` - /tenants operation on tenant resource
+- `getTenantsById()` - Fetch a single tenant by its UUID
+- `postTenants()` - Create a new tenant organization
+- `postTenantsByIdCredit()` - Allocate credits to the tenant's liability account
+- `postTenantsByIdSchedule-purge()` - Schedule an Oban job to purge all storage objects for the given tenant
+- `postTenantsIsv()` - Create an ISV tenant with initial credits
+- `patchTenantsById()` - Update general tenant settings: name, slug, kind, branding URLs, training price,
+plan tier, vanity slug, and storage spending cap
+- `deleteTenantsById()` - Permanently delete a tenant and all associated data
 
 ## Thread stats
 
-- `getThreadsStats()` - List stats
+- `getThreadsStats()` - Return platform-wide chat statistics including total threads, total messages, threads active in the last 24h and 7d, message distribution by role, and top 10 workspaces by thread count
 
 ## Thread workspace stats
 
-- `getThreadsWorkspace-stats()` - List workspace stats
+- `getThreadsWorkspace-stats()` - Return aggregated chat statistics for the actor's current workspace: total threads, total messages, activity counts for 24h and 7d windows, and message distribution by role
 
 ## Threads
 
-- `getThreads()` - List threads
-- `getThreadsById()` - Get threads
-- `getThreadsSearch()` - List search
-- `postThreads()` - Create threads
-- `postThreadsActive()` - Create active
-- `postThreadsByIdExport()` - Create export
-- `postThreadsByIdFork()` - Create fork
-- `postThreadsByIdMessages()` - Create messages
-- `postThreadsByIdSummarize()` - Create summarize
-- `patchThreadsById()` - Update threads
-- `patchThreadsByIdArchive()` - Update archive
-- `patchThreadsByIdUnarchive()` - Update unarchive
-- `deleteThreadsById()` - Delete threads
+- `getThreads()` - /threads operation on thread resource
+- `getThreadsById()` - /threads/:id operation on thread resource
+- `getThreadsSearch()` - Full-text search threads by title or context summary within the actor's accessible workspace
+- `postThreads()` - Create a new conversation thread scoped to a tenant, workspace, and user
+- `postThreadsActive()` - Return the current user's active thread for their workspace, creating a new one if none exists or the existing thread has expired (>24h inactive)
+- `postThreadsByIdExport()` - Export thread with messages to JSON, Markdown, or plain text format
+- `postThreadsByIdFork()` - Fork a thread by cloning it with all its messages
+- `postThreadsByIdMessages()` - Submit a user message to a thread and receive the AI response synchronously
+- `postThreadsByIdSummarize()` - Generate a 2-3 sentence LLM summary of the thread's message history and persist it as `context_summary`
+- `patchThreadsById()` - Update the thread's title or context summary
+- `patchThreadsByIdArchive()` - Archive a thread by setting `archived_at` to the current timestamp
+- `patchThreadsByIdUnarchive()` - Restore an archived thread by clearing `archived_at`, making it visible in the default thread list again.
+- `deleteThreadsById()` - /threads/:id operation on thread resource
 
 ## Token
 
-- `postTokens()` - Create tokens
+- `postTokens()` - Create a payment token
 
 ## Training analytics
 
-- `getWorkspacesAnalytics-batch()` - List analytics batch
-- `getWorkspacesByWorkspaceIdTrainingAnalytics()` - Get analytics
+- `getWorkspacesAnalytics-batch()` - Get training analytics for multiple workspaces in a single request (max 50)
+- `getWorkspacesByWorkspaceIdTrainingAnalytics()` - Get training analytics for a specific workspace
 
 ## Transaction
 
-- `getTransactions()` - List transactions
-- `getTransactionsById()` - Get transactions
+- `getTransactions()` - Read user's transactions
+- `getTransactionsById()` - Read user's transactions
 
 ## Users
 
-- `getUser-profiles()` - List user profiles
-- `getUser-profilesById()` - Get user profiles
-- `getUser-profilesMe()` - List me
-- `getUsers()` - List users
-- `getUsersBy-email()` - List by email
-- `getUsersById()` - Get users
-- `getUsersMe()` - List me
-- `getUsersMeActivity()` - List activity
-- `getUsersMeDashboard()` - List dashboard
-- `getUsersMeStats()` - List stats
-- `getUsersMeTenants()` - List tenants
-- `postUser-profiles()` - Create user profiles
-- `postUsersAuthConfirm()` - Create confirm
-- `postUsersAuthLogin()` - Create login
-- `postUsersAuthMagic-linkLogin()` - Create login
-- `postUsersAuthMagic-linkRequest()` - Create request
-- `postUsersAuthRegister()` - Create register
-- `postUsersAuthRegister-with-oidc()` - Create register with oidc
-- `postUsersAuthResend-confirmation()` - Create resend confirmation
-- `postUsersAuthReset-passwordRequest()` - Create request
-- `postUsersRegister-isv()` - Create register isv
-- `patchUser-profilesById()` - Update user profiles
-- `patchUser-profilesByIdAccept-tos()` - Update accept tos
-- `patchUser-profilesByIdDismiss-announcement()` - Update dismiss announcement
-- `patchUser-profilesByIdDismiss-welcome()` - Update dismiss welcome
-- `patchUsersAuthPasswordChange()` - Update change
-- `patchUsersAuthReset-password()` - Update reset password
-- `patchUsersById()` - Update admin
-- `patchUsersByIdConfirm-email()` - Update confirm email
-- `patchUsersByIdEmail()` - Update email
-- `patchUsersByIdReset-password()` - Update reset password
-- `deleteUser-profilesById()` - Delete user profiles
-- `deleteUsersById()` - Delete users
+- `getUser-profiles()` - /user-profiles operation on user_profile resource
+- `getUser-profilesById()` - /user-profiles/:id operation on user_profile resource
+- `getUser-profilesMe()` - Get the current user's profile
+- `getUsers()` - /users operation on user resource
+- `getUsersBy-email()` - Look up a single user by their email address (case-insensitive)
+- `getUsersById()` - /users/:id operation on user resource
+- `getUsersMe()` - Get the currently authenticated user
+- `getUsersMeActivity()` - Get activity feed for the user's tenant context
+- `getUsersMeDashboard()` - Get dashboard data for the user's tenant context
+- `getUsersMeStats()` - Get stats for the user's tenant context
+- `getUsersMeTenants()` - List all tenants the current user belongs to with their roles and permissions
+- `postUser-profiles()` - Create a user profile record linked to an existing user
+- `postUsersAuthConfirm()` - Confirm a user's email address using a confirmation token
+- `postUsersAuthLogin()` - Attempt to sign in using a username and password.
+- `postUsersAuthMagic-linkLogin()` - /users/auth/magic-link/login operation on user resource
+- `postUsersAuthMagic-linkRequest()` - /users/auth/magic-link/request operation on user resource
+- `postUsersAuthRegister()` - Register a new user account with email and password
+- `postUsersAuthRegister-with-oidc()` - Register or sign in a user via an OAuth/OIDC provider (Google, GitHub, Salesforce,
+Microsoft)
+- `postUsersAuthResend-confirmation()` - Resend confirmation email to an unconfirmed user
+- `postUsersAuthReset-passwordRequest()` - Public action for users to request a password reset email
+- `postUsersRegister-isv()` - Platform Admin action to register a new ISV (User + Tenant + App)
+- `patchUser-profilesById()` - Update the user's display profile fields: name, avatar, bio, social links, and
+raw preferences map
+- `patchUser-profilesByIdAccept-tos()` - Accept Terms of Service - merges with existing preferences
+- `patchUser-profilesByIdDismiss-announcement()` - Dismiss announcement - merges with existing preferences
+- `patchUser-profilesByIdDismiss-welcome()` - Dismiss welcome message - merges with existing preferences
+- `patchUsersAuthPasswordChange()` - Change password for authenticated user with current password verification
+- `patchUsersAuthReset-password()` - Reset password using admin-issued reset token
+- `patchUsersById()` - Admin-only user management (platform admins) - promotes/demotes admin status
+- `patchUsersByIdConfirm-email()` - Admin manually confirms user's email
+- `patchUsersByIdEmail()` - Admin-only email update
+- `patchUsersByIdReset-password()` - Admin triggers password reset email for user
+- `deleteUser-profilesById()` - /user-profiles/:id operation on user_profile resource
+- `deleteUsersById()` - Permanently delete a user account
+
+## Voice recording
+
+- `getVoiceRecordings()` - /voice/recordings operation on voice_recording resource
+- `getVoiceRecordingsById()` - /voice/recordings/:id operation on voice_recording resource
+- `getVoiceRecordingsSessionBySessionId()` - List recordings for a specific voice session
 
 ## Voice session
 
-- `getVoiceSessions()` - List sessions
-- `getVoiceSessionsById()` - Get sessions
-- `getVoiceSessionsMine()` - List mine
-- `getVoiceSessionsWorkspaceByWorkspaceId()` - Get workspace
-- `postVoiceSessions()` - Create sessions
-- `patchVoiceSessionsByIdFinalize()` - Update finalize
-- `patchVoiceSessionsByIdStop()` - Update stop
+- `getVoiceSessions()` - /voice/sessions operation on voice_session resource
+- `getVoiceSessionsById()` - /voice/sessions/:id operation on voice_session resource
+- `getVoiceSessionsMine()` - List current user's voice sessions
+- `getVoiceSessionsWorkspaceByWorkspaceId()` - List all voice sessions in a workspace (ISV admin)
+- `postVoiceSessions()` - Start a new voice session with LiveKit room provisioning
+- `patchVoiceSessionsByIdFinalize()` - Dispatch accumulated transcript to the blueprint/chat pipeline
+- `patchVoiceSessionsByIdStop()` - End a voice session and release the LiveKit room
+- `deleteVoiceSessionsById()` - /voice/sessions/:id operation on voice_session resource
+
+## Voice transcription result
+
+- `getVoiceTranscription-results()` - /voice/transcription-results operation on voice_transcription_result resource
+- `getVoiceTranscription-resultsById()` - /voice/transcription-results/:id operation on voice_transcription_result resource
+- `getVoiceTranscription-resultsSessionBySessionId()` - List transcription results for a voice session
 
 ## Watcher claim
 
-- `getWatcherClaims()` - List claims
-- `getWatcherClaimsById()` - Get claims
-- `getWatcherClaimsHistory()` - List history
-- `getWatcherClaimsStatus()` - List status
-- `postWatcherClaims()` - Create claims
-- `patchWatcherClaimsById()` - Update claims
-- `patchWatcherClaimsByIdRelease()` - Update release
-- `patchWatcherClaimsByIdRetry()` - Update retry
+- `getWatcherClaims()` - List claims for a workspace, optionally filtering by one or more statuses (e.g., [:claimed, :processing])
+- `getWatcherClaimsById()` - Paginate all ingestion claims; use by_workspace to scope to a specific workspace and filter by status.
+- `getWatcherClaimsHistory()` - Check if a file hash was already processed in this workspace
+- `getWatcherClaimsStatus()` - Get ingestion status for a workspace
+- `postWatcherClaims()` - Atomically claim a detected file for processing; returns {claimed: true, claim: ...} on success or {claimed: false, existing: ...} if another machine already holds the claim.
+- `patchWatcherClaimsById()` - Advance a claim through the state machine (claimed → processing → completed/failed); stamps completed_at when transitioning to :completed
+- `patchWatcherClaimsByIdRelease()` - Release a claim by setting its status to :expired, allowing another machine to re-claim the file on the next poll cycle.
+- `patchWatcherClaimsByIdRetry()` - Re-open a terminal claim (completed/failed/expired/document_deleted) for re-processing; increments retry_count unless reset_retry_count is true
 
 ## Watcher event
 
-- `getWatcherEvents()` - List events
-- `getWatcherEventsById()` - Get events
-- `postWatcherEvents()` - Create events
+- `getWatcherEvents()` - List ingestion events for a workspace, optionally filtered by event_type, machine_id, or a since timestamp
+- `getWatcherEventsById()` - Fetch a single ingestion event by ID; use the :list action to query events by workspace, type, machine, or time range.
+- `postWatcherEvents()` - Create multiple events in batch
 
 ## Webhooks
 
-- `getWebhook-configs()` - List webhook configs
-- `getWebhook-configsById()` - Get webhook configs
-- `getWebhook-configsByIdEvents()` - Get events
-- `getWebhook-configsStats()` - List stats
-- `getWebhook-deliveries()` - List webhook deliveries
-- `getWebhook-deliveriesById()` - Get webhook deliveries
-- `getWebhook-deliveriesStats()` - List stats
-- `postWebhook-configs()` - Create webhook configs
-- `postWebhook-configsBulk-disable()` - Create bulk disable
-- `postWebhook-configsBulk-enable()` - Create bulk enable
-- `postWebhook-configsByIdReplay()` - Create replay
-- `postWebhook-configsByIdTest()` - Create test
-- `postWebhook-deliveriesBulk-retry()` - Create bulk retry
-- `postWebhook-deliveriesByIdRetry()` - Create retry
-- `patchWebhook-configsById()` - Update webhook configs
-- `patchWebhook-configsByIdRotate-secret()` - Update rotate secret
-- `deleteWebhook-configsById()` - Delete webhook configs
+- `getWebhook-configs()` - /webhook-configs operation on webhook_config resource
+- `getWebhook-configsById()` - /webhook-configs/:id operation on webhook_config resource
+- `getWebhook-configsByIdEvents()` - List available events that can be subscribed to
+- `getWebhook-configsStats()` - Get webhook configuration statistics
+- `getWebhook-deliveries()` - /webhook-deliveries operation on webhook_delivery resource
+- `getWebhook-deliveriesById()` - /webhook-deliveries/:id operation on webhook_delivery resource
+- `getWebhook-deliveriesStats()` - Return aggregate delivery counts by status (total, delivered, failed, retrying)
+- `postWebhook-configs()` - Register a new webhook endpoint to receive platform events
+- `postWebhook-configsBulk-disable()` - Disable multiple webhook configs by ID in a single call
+- `postWebhook-configsBulk-enable()` - Enable multiple webhook configs by ID in a single call
+- `postWebhook-configsByIdReplay()` - Replay historical events to this webhook
+- `postWebhook-configsByIdTest()` - Send a realistic sample payload to the webhook URL to verify connectivity and signature verification
+- `postWebhook-deliveriesBulk-retry()` - Set multiple delivery records to `:retrying` status in bulk
+- `postWebhook-deliveriesByIdRetry()` - Re-enqueue a failed or pending delivery for immediate re-dispatch
+- `patchWebhook-configsById()` - Update webhook endpoint settings such as URL, subscribed events, and enabled state
+- `patchWebhook-configsByIdRotate-secret()` - Generate a new `whsec_`-prefixed HMAC secret for this webhook, invalidating the previous secret immediately
+- `deleteWebhook-configsById()` - /webhook-configs/:id operation on webhook_config resource
 
 ## Workspace document stats
 
-- `getTenantsByTenantIdWorkspaceStats()` - Get workspace stats
+- `getTenantsByTenantIdWorkspaceStats()` - /tenants/:tenant_id/workspace_stats operation on workspace_document_stats resource
 
 ## Workspace-membership
 
-- `getWorkspace-memberships()` - List workspace memberships
-- `getWorkspace-membershipsByWorkspaceIdByUserId()` - Get workspace memberships
-- `getWorkspace-membershipsInherited()` - List inherited
-- `getWorkspacesByIdMembers()` - Get members
-- `postWorkspace-memberships()` - Create workspace memberships
-- `patchWorkspace-membershipsByWorkspaceIdByUserId()` - Update workspace memberships
-- `patchWorkspace-membershipsByWorkspaceIdByUserIdProfile()` - Update profile
-- `deleteWorkspace-membershipsByWorkspaceIdByUserId()` - Delete workspace memberships
+- `getWorkspace-memberships()` - /workspace-memberships operation on workspace-membership resource
+- `getWorkspace-membershipsByWorkspaceIdByUserId()` - /workspace-memberships/:workspace_id/:user_id operation on workspace-membership resource
+- `getWorkspace-membershipsInherited()` - List workspace members including inherited org owners/admins
+- `getWorkspacesByIdMembers()` - /workspaces/:id/members operation on workspace-membership resource
+- `postWorkspace-memberships()` - /workspace-memberships operation on workspace-membership resource
+- `patchWorkspace-membershipsByWorkspaceIdByUserId()` - /workspace-memberships/:workspace_id/:user_id operation on workspace-membership resource
+- `patchWorkspace-membershipsByWorkspaceIdByUserIdProfile()` - Update the member's profile_attributes field
+- `deleteWorkspace-membershipsByWorkspaceIdByUserId()` - /workspace-memberships/:workspace_id/:user_id operation on workspace-membership resource
 
 ## Workspaces
 
-- `getWorkspaces()` - List workspaces
-- `getWorkspacesById()` - Get workspaces
-- `getWorkspacesMine()` - List mine
-- `getWorkspacesShared()` - List shared
-- `postWorkspaces()` - Create workspaces
-- `patchWorkspacesById()` - Update workspaces
-- `patchWorkspacesByIdAllocate()` - Update allocate
-- `patchWorkspacesByIdPopulate-hashes()` - Update populate hashes
-- `patchWorkspacesByIdStorage-settings()` - Update storage settings
-- `deleteWorkspacesById()` - Delete workspaces
+- `getWorkspaces()` - List workspaces visible to the actor
+- `getWorkspacesById()` - Fetch a single workspace by its primary key
+- `getWorkspacesMine()` - List all workspaces where the authenticated user has a direct workspace membership
+- `getWorkspacesShared()` - Workspaces where user has membership but NOT tenant membership (shared from external orgs)
+- `postWorkspaces()` - Create a new workspace under a tenant
+- `patchWorkspacesById()` - Update workspace metadata and settings
+- `patchWorkspacesByIdAllocate()` - Transfer credits from the tenant's liability account to this workspace's
+liability account
+- `patchWorkspacesByIdPopulate-hashes()` - Enqueue a background job to populate file hashes for documents missing them
+- `patchWorkspacesByIdStorage-settings()` - Update workspace storage settings - tenant admin/owner only
+- `deleteWorkspacesById()` - Soft-delete a workspace by setting archived_at to the current timestamp
 
 ## Error Handling