> ## 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 are Resources in Octave?

> Resources are the URLs, files, and text snippets Octave indexes alongside your Library so agents can ground output in your real content.

## 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](/concepts/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](/concepts/agents) and [Context Search](/v2-api-reference/context/context-search) can pull from.

## Resource types

| Type             | What it is                     | When to use                                          |
| ---------------- | ------------------------------ | ---------------------------------------------------- |
| **URL**          | Any public web page            | Marketing pages, blog posts, press, competitor sites |
| **Google Drive** | A file in your connected Drive | Internal docs, slide decks, PDFs, spreadsheets       |
| **Text**         | A raw text snippet             | Inline 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](/concepts/agents) runs — Sequence, Content, Call Prep, Enrich — it can retrieve relevant Resource chunks as part of its grounding context, alongside Library entities and [findings](/concepts/analytics). 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