Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.octavehq.com/llms.txt

Use this file to discover all available pages before exploring further.

​
What is a Resource?

A Resource is an external asset — a URL, a Google Drive file, or a block of raw text — that Octave ingests, indexes, and makes searchable alongside your Library. Where the Library captures your structured GTM knowledge (personas, motions, competitors), Resources capture the unstructured content that supports it: blog posts, case study PDFs, sales decks, internal wiki pages, technical docs. Together they form the full grounding surface every agent and Context Search can pull from.

​
Resource types

TypeWhat it isWhen to use
URLAny public web pageMarketing pages, blog posts, press, competitor sites
Google DriveA file in your connected DriveInternal docs, slide decks, PDFs, spreadsheets
TextA raw text snippetInline content that doesn’t have a URL or file home

​
Indexing lifecycle

When you create a Resource, Octave:
  1. Fetches the content (crawls the URL, reads the Drive file, accepts the text directly)
  2. Chunks it into semantically meaningful segments
  3. Embeds the chunks for semantic search
  4. Tags segments by relevance to existing Library entities where appropriate
You can check ingestion progress with GET /api/v2/resource/status and re-index a resource at any time. Indexing is asynchronous — large resources take time, and the status endpoint is the canonical way to know when a resource is ready for retrieval.

​
How agents use Resources

When an agent runs — Sequence, Content, Call Prep, Enrich — it can retrieve relevant Resource chunks as part of its grounding context, alongside Library entities and findings. This is what lets a Sequence Agent reference a specific case study by name without you pasting it into the prompt: the case study lives as a Resource, and the agent retrieves the right segments at runtime. The POST /api/v2/context Context Search endpoint exposes this retrieval directly — pass a query, get the relevant Resource chunks (plus Library entities and findings) back.

​
Resources vs Library entities

A Resource is content. A Library entity is strategy. Resources are how you bring existing content into Octave without restructuring it; Library entities are how you encode the strategic patterns you want every agent to operate on. Most workspaces use both: Resources hold the source material, Library entities hold the conclusions you’ve drawn from it.

​
Managing Resources via API

  • GET /api/v2/resource/list — list resources
  • GET /api/v2/resource/get — get a specific resource
  • POST /api/v2/resource/create — create a resource (URL, Google Drive, or text)
  • GET /api/v2/resource/status — check indexing status
  • POST /api/v2/resource/search — semantic search across resources
  • DELETE /api/v2/resource/delete — delete one or more resources