> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ravenna.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Foundry guide

> Learn what Foundry is, what you can build with it, and how to get the most out of it. Pair this guide with the main Foundry documentation as you work.

This guide is the long-form companion to the [Foundry documentation](/documentation/automate/foundry/overview). The main docs cover *what* Foundry does and *how the UI is laid out*. This guide is here to help you **learn**: see worked examples, follow walkthroughs against real third-party tools, and pick up tips from teams already using it.

If you're new to Foundry, start with the main docs and come back here when you want to go deeper.

<CardGroup cols={2}>
  <Card title="Foundry overview" icon="book-open" href="/documentation/automate/foundry/overview">
    What Foundry is, key terms, and where to find things in the UI.
  </Card>

  <Card title="Building functions" icon="code" href="/documentation/automate/foundry/actions">
    Reference for creating, testing, and publishing functions.
  </Card>

  <Card title="Integrations" icon="plug" href="/documentation/automate/foundry/integrations">
    Reference for managing integrations and OAuth providers.
  </Card>

  <Card title="Using functions" icon="zap" href="/documentation/automate/foundry/using-actions">
    Reference for using published functions in workflows and agents.
  </Card>
</CardGroup>

***

## What's in this guide

<CardGroup cols={2}>
  <Card title="Set up a custom API integration" icon="key" href="/guides/how-to/foundry/setup-custom-api">
    Walkthrough for connecting a tool that uses a static credential like an API key.
  </Card>

  <Card title="Set up a custom OAuth app" icon="key" href="/guides/how-to/foundry/setup-oauth/overview">
    What an OAuth app is, what Foundry needs from one, and walkthroughs for Google Cloud, GitHub, and DocuSign.
  </Card>

  <Card title="Examples" icon="sparkles" href="/guides/how-to/foundry/examples">
    Real things teams build with Foundry, with the prompts they used to generate them.
  </Card>

  <Card title="Tips & troubleshooting" icon="life-ring" href="/guides/how-to/foundry/tips-and-troubleshooting">
    Practices that lead to better functions, plus fixes for the most common issues.
  </Card>
</CardGroup>

***

## How to use this guide

* **Each walkthrough is self-contained.** You can jump straight to the OAuth or API setup you need.
* **The examples are starting points.** Each one shows the prompt to give Foundry and points at the integration shape required, so you can adapt them to your tools.
* **Technical reference stays in the main docs.** When you need the exact list of `ctx.ravenna` operations, the `ActionContext` shape, or the validation behaviour, this guide will send you there. That way the reference stays correct as Foundry evolves and these guides stay focused on learning.

<Callout icon="link" color="#6B7280">
  Ready to start? Begin with [Set up a custom API integration](/guides/how-to/foundry/setup-custom-api), or read the [OAuth setup overview](/guides/how-to/foundry/setup-oauth/overview) before picking a walkthrough.
</Callout>