Accept Suggestion
WriteAccept a pending entity suggestion.
Permissions and limits
Account permissions
- An Octave API key (Settings, API)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Manage your Octave GTM library, motions, playbooks, tags, events, insights and assets.
Explore 169 workflow actions for Octave, including account permissions and operation limits.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Accept a pending entity suggestion.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Assign a tag value to a library entity.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Imports a batch of events (calls, emails, CRM, social) into the analytics pipeline.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Test whether one cohort of deals does better than another, on win rate or a leading outcome (advanced within N days, faster than the stage median, next conversation positive).
A repeated request may repeat the external action. Review the previous result before retrying a write.
Competitive Landscape
Count the events matching a date window and filters without returning them: total, a per-channel split, and distinct companies, external people and CRM deals.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new motion with a default playbook.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new playbook for an existing motion
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new alternative (status quo / incumbent / DIY pattern)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new brand voice from explicit/literal data (use generate endpoint for AI-powered creation from sources)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new buying trigger
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new competitor
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new core feature under a parent offering
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new objection
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new persona
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create Playbook
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new product
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new proof point
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new customer reference
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new global resource in the workspace.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new market segment
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new service
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new solution from generated output and sources
A repeated request may repeat the external action. Review the previous result before retrying a write.
Queue a PENDING entity suggestion for human review.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Add a value to an existing tag group.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a reporting tag group (a faceted dimension) for one library entity type, optionally with its initial values.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new use case
A repeated request may repeat the external action. Review the previous result before retrying a write.
Soft-delete a motion and all its ICP cells and learnings
A repeated request may repeat the external action. Review the previous result before retrying a write.
Soft-delete a motion playbook
A repeated request may repeat the external action. Review the previous result before retrying a write.
Soft delete a Alternative by OId.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Workspace-scoped; requires a workspace owner or Octave admin API key.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Permanently delete an asset and its stored files by UUID.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Permanently delete a version's snapshot files (storage cleanup).
A repeated request may repeat the external action. Review the previous result before retrying a write.
Soft delete a buying trigger by OId.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Soft delete a Competitor by OId.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Soft delete a Core Feature by OId.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Soft delete an objection by OId.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Soft delete a Persona by OId.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Soft delete a Playbook by OId.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Soft delete a Product by OId.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Soft delete a Proof Point by OId.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Soft delete a Reference by OId.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Soft delete one or more resources.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Soft delete a Segment by OId.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Soft delete a Service by OId.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Soft-delete a solution
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete one value from a tag group.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a tag group, its values, and every entity's assignment in it.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Soft delete a Use Case by OId.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Dismiss a pending access request , 'not now', not a block: if the requester verifies their email and asks again, the request returns to pending.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Entity Stats
Entity Time Series
A library entity's activity record: mention and conversation counts, the per-channel split, first/last mention, days since last mention, a daily series, whether mentions are rising or falling, and.
Cross two dimensions of the events matching a window and filters, such as objection x segment, and get event, company and deal metrics for every combination, each row and column, and the populations.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Counts per day, week or month for the events matching a window and filters: events, distinct companies and distinct linked deals per bucket, zero-filled.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Fetch a single motion by oId
Fetch a single learning by oId
Fetch a single motion playbook by oId
Get a single report configuration by oId
Get a single report group (Beats schedule) by oId, including its report configs
Get a single report run with full section details and narrative analysis
Get Alternative by OId
Fetch a single asset by its UUID, including its metadata, flat file list, and site directory tree.
Get per-day unique visit and download counts for an asset.
Get Brand Voice by OId
Get the current status of a bulk event import job.
Get buying trigger by OId
Get Competitor by OId
Get Core Feature by OId
Returns subscription-wide current-period credit usage, included allowance, additional credits, remaining balance, next reset, and overage.
Discover the valid fields/properties on a CRM entity (account, contact, lead, or opportunity) in the connected CRM (Salesforce, HubSpot, or Attio).
Returns the best verbatim customer-call quotes evidencing a library entity, with speaker attribution, call context, and recording time anchors.
Get full details for a specific event including participants, findings, and optionally full content.
Read researched competitor, segment and market intel.
Returns deduplicated direct library relationships in either direction as oId, entityType, relationship (the linked entity is a parent or child of the requested entity), and linkType (explicit or.
Get full detail for a Motion ICP cell including the AI-generated narrative and learning count.
Get objection by OId
Get Persona by OId
Get Playbook by OId
Get Product by OId
Get Proof Point by OId
Get Reference by OId
Get a resource by OId.
Get the current processing status of a resource.
Fetch a single audit-trail revision by oId.
Get Segment by OId
Get Service by OId
Get Solution by OId
Preview a single entity suggestion in full.
Roll up outcome stats for the entities in a tag group by tag value: per-value won/lost/open/total deal counts, finding and call counts, correlated won amount, and win rate (from summed deals across.
Get Use Case by OId
Get the workspace company.
Library Health
Link or unlink library entities to a source doc (Google Doc, Notion page, Linear doc, website page).
A repeated request may repeat the external action. Review the previous result before retrying a write.
List alternatives with optional filtering and pagination
List access requests across ALL of the calling user's assets , the request inbox.
List an asset's share links, each with its email/domain allowlist and expiry.
List an asset's version history, newest first.
List the identified viewers of an asset , every code-verified viewer with open counts and first/last-seen times: share-link recipients (via 'share') and workspace-verified members (via 'workspace').
List the calling user's assets (hosted sites, storage bundles, and managed skill folders).
List all brand voices in the workspace
List buying triggers with optional filtering and pagination
List the CRM deals on one side of a cohort comparison.
A repeated request may repeat the external action. Review the previous result before retrying a write.
List competitors with optional filtering and pagination
List core features with optional filtering and pagination
Workspace-scoped; requires a workspace owner or Octave admin API key.
List Events
List Findings
Read researched competitor, segment and market intel.
Returns the current learnings for a specific Motion ICP cell, sorted by pinned status and confidence.
List all ICP cells for a motion, optionally filtered to a specific playbook.
List motion playbooks, optionally filtered by motion, offering, or motion type
List motions for the workspace, optionally filtered by offering
List objections with optional filtering and pagination
List personas by query
List Playbooks
Lists product-table rows by default (type=PRODUCT).
List proof points with optional filtering and pagination
Returns the recommended library entities (use cases, proof points, reference customers, competitors, alternatives, buying triggers, objections) linked to a specific Motion ICP cell from its active.
List References
List report configurations, optionally filtered by group
List GTM report groups (Beats), including scheduling status and config count
List report runs newest window first: one config's (configOId), every config of a group's (groupOId), or by default the Weekly Beats group's
List all global resources in the workspace with optional filtering and pagination.
List audit-trail revisions for library and agent entities, with optional filters by entity type, entity oIds, date range, and author.
List segments with optional filtering and pagination
List Services
List solutions in the workspace
List entity suggestions for the workspace , proposed library changes generated from analytics (calls, emails, deals) and other sources.
List every entity of a tag group's entity type with its current value in that group; tagOId/tagName are null when the entity has no value.
List the workspace's reporting tag groups and their values.
List Use Cases
Explicitly change a library entity's lock.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Reject a pending entity suggestion.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Remove domains from an existing share link's allowlist.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Remove recipient emails from an existing share link's allowlist.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Roll an asset back to a previous version , an instant pointer flip: the asset's URL serves the chosen snapshot immediately, no files move, and newer versions are NOT deleted (they stay restorable,.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Revoke a share link by its UUID.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Semantic search over recorded call transcripts, returning verbatim, speaker-attributed moments with recording links and time anchors.
Search extracted findings from sales conversations using natural language.
Search across global resources using semantic search.
Toggle a brand voice as the workspace default.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Top Entities
Rank the library entities of one type, the values of a tag group, companies, external people, speaker sides or deal stages at the time of the event, across the events matching a window and filters.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Clear a library entity's value in one tag group.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update fields on an existing motion
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update name, active state, or narrative sections of a motion playbook
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update an existing alternative
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update an asset's editable fields , any of identifier, description, entry point, category, privacy, status, and vanitySlug.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update an existing brand voice
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update an existing buying trigger
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update an existing competitor
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update an existing core feature
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update an existing objection
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update an existing persona
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update an existing playbook.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update an existing product
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update an existing proof point
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update an existing reference
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update an existing market segment
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update an existing service
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update an existing solution
A repeated request may repeat the external action. Review the previous result before retrying a write.
Edit a PENDING entity suggestion before accepting it.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Rename or reorder a tag value.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Rename a tag group, change its description, or turn auto-infer on or off.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update an existing use case
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update the workspace company.
A repeated request may repeat the external action. Review the previous result before retrying a write.
This endpoint validates the API key provided in the header.
Workspace Baseline
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
Inspect step outputs and confirm the result in Octave. A saved workflow is not a completed provider action.