Quickstart

Create a workspace, mint an API token, and make your first call in a few minutes.

1. Create an account and workspace

Sign up at app.tryorcha.com with email and password, Google, or GitHub. Your organization and first workspace are created for you. All files, folders, and databases belong to a workspace; the workspace switcher in the sidebar shows which one you are in.

2. Create an API token

Open the Tokens page and create a token with the permissions you need (read, write, delete). The token is scoped to the workspace you are currently viewing and starts with the prefix orca_. Copy it now: the full value is shown once and cannot be retrieved later.

By default a token can access the whole workspace. You can restrict it to specific folders instead; see Tokens and scoping.

3. Make your first API call

curl -H "Authorization: Bearer orca_your_token" \
  https://app.tryorcha.com/api/v1/files

Create a file:

curl -X POST \
  -H "Authorization: Bearer orca_your_token" \
  -H "Content-Type: application/json" \
  -d '{"name": "example.md", "content": "# Example", "fileType": "markdown"}' \
  https://app.tryorcha.com/api/v1/files

4. Search your context

curl -X POST \
  -H "Authorization: Bearer orca_your_token" \
  -H "Content-Type: application/json" \
  -d '{"query": "deployment requirements", "limit": 5}' \
  https://app.tryorcha.com/api/v1/search_context

Results are ranked chunks with citations and startLine/endLine anchors. Retrieval explains how hybrid search works and how to get more out of it.

5. Connect an AI client

The MCP server lives at https://app.tryorcha.com/mcp and authenticates with the same token. Follow the guide for your client:

Once connected, ask your assistant things like "What files do I have in Orcha?" or "Read my brand-voice.md and use that style to write a blog post."

6. Bring in what you already have

Two paths, depending on where the knowledge lives:

Connect a source to index GitHub, Drive, Notion, Dropbox, Linear, and others, choosing what gets indexed per repository or folder.
Import from Obsidian or Notion to migrate a vault or export with its hierarchy, relations, attachments, and links intact.