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

# Secoda

> Connect Secoda so Decimal can find catalog resources and read their documentation during investigations.

Connect Secoda to look up catalog documentation for tables, columns, and
dashboards during investigations. Open the resource's source link, when returned,
to check its definition in Secoda.

Search matches resource titles, not the full text of descriptions or definitions.
This integration reads the catalog; it does not query your warehouse, edit
resources, or import them as Decimal Knowledge Base articles.

## Before you connect

You'll need an organization admin account in Decimal, a Secoda API key, and your
Secoda workspace's region. Use a key with access only to the resources this Decimal
organization should read; there is no resource-selection step in Decimal.

Secoda's [authentication guide](https://docs.secoda.co/api/authentication) covers
API credentials and access. Keep the key out of prompts and support messages.

## Connecting Secoda

1. **Open Secoda**: Go to **Settings → Integrations → Secoda**.

2. **Enter your key**: Provide the **API key** under **Connection**.

3. **Select your region**: Match the workspace where the key belongs. **US** is the
   default.

   | Region | Secoda workspace |
   | - | - |
   | US | `app.secoda.co` |
   | EU | `eu.secoda.co` |
   | APAC | `apac.secoda.co` |

4. **Connect**: Click **Connect**. Decimal tests catalog access before saving the
   connection.

5. **Check the connection**: Confirm that **Status** reads **Connected** and
   **Region** matches your workspace.

The connection test can succeed with an empty catalog. **Connected** reflects the
saved connection, not a live credential test or a guarantee of access to every
resource.

## Troubleshooting

| What you see | What to check |
| - | - |
| **Connect** is unavailable | Enter a non-empty API key and select a region. |
| Secoda rejected the credentials | Check the key, region, and catalog permissions with your Secoda administrator. |
| Secoda is unavailable or rate limiting requests | Wait before retrying. Record the time and error text if the problem persists. |
| No matching resource or missing documentation | Try a shorter title fragment and confirm the resource exists, has the expected documentation, and is accessible to the connected key. |
| Searches stopped working | Check whether the key was revoked or its permissions changed. |
| A resource is marked **Stale** or **Archived** | Confirm the documentation with its owner or find an active replacement. These flags come from Secoda; a missing flag does not establish freshness. |

If the problem persists,
[email support](mailto:support@getdecimal.ai) with the region, error text, time,
and Decimal conversation or ticket URL. Leave the API key out of the message.

## Replace the key or disconnect

On the Secoda integration page, click **Disconnect** and confirm. This removes the
saved credentials from Decimal; revoke the key in Secoda separately if needed.

To replace the key or region, have the replacement details ready before
disconnecting. Reconnect with those details, then confirm **Connected** and the
correct **Region**.
Secoda access is unavailable while disconnected.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.