Skip to main content
A collection groups documents so you can ask one question across all of them. From the CLI you list collections and query them. Collections themselves are created and managed in the web app or via the Collections API — there is no okra collections create.

​
Commands

collections accepts either a collection name or a collection ID (col-...). The CLI tries ID lookup first, then falls back to name.

​
List collections

​
Query a collection

okra collections query fans the same question out across every document in the collection and returns the combined result.

​
Creating and publishing collections

Creating a collection, adding or removing documents, and publishing a collection to a public URL are not CLI operations:
  • Create / manage — use the web app or POST /v1/collections (see Create a collection).
  • Publish — publishing to a public URL asserts that you own or are licensed to publish the content, so it is a deliberate, gated action in the web app, not a one-line CLI flag.
Public collection pages live at okrapdf.com/c/<slug>. They are part of the free, read-only public tier — see the web overview for how the surfaces relate.