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

# API Reference

> Fabric exposes 72+ endpoints across 10 modules, with an interactive OpenAPI playground.

<Info>
  The full interactive reference is **auto-generated** from Fabric's FastAPI app. Every endpoint documented here is the actual endpoint running in your deployment.
</Info>

## Try it live

<CardGroup cols={2}>
  <Card title="OpenAPI Playground" icon="terminal" href="https://api.fabric.bulldogtechnologies.com/docs">
    Swagger UI — try requests directly in the browser with your token.
  </Card>

  <Card title="ReDoc Reference" icon="book" href="https://api.fabric.bulldogtechnologies.com/redoc">
    Read-only reference with clean navigation across all endpoints.
  </Card>
</CardGroup>

## Authentication

All endpoints require a Bearer token unless the server runs with auth disabled (dev mode).

```http theme={null}
Authorization: Bearer <token>
```

<Steps>
  <Step title="Obtain a token">
    ```bash theme={null}
    curl -X POST https://api.fabric.bulldogtechnologies.com/v1/auth/login \
      -H 'Content-Type: application/json' \
      -d '{"email": "you@example.com", "password": "..."}'
    ```
  </Step>

  <Step title="Use the token">
    ```bash theme={null}
    curl https://api.fabric.bulldogtechnologies.com/v1/projects \
      -H 'Authorization: Bearer <token>'
    ```
  </Step>

  <Step title="Or issue an API key">
    API keys are tenant- and project-scoped. Generate via `POST /v1/auth/api-keys` from an authenticated session.
  </Step>
</Steps>

## Endpoint modules

| Module                    | Endpoints | Covers                                                                       |
| ------------------------- | --------- | ---------------------------------------------------------------------------- |
| **Authentication**        | 13        | Register, login, Google OAuth, API keys, token refresh                       |
| **Projects**              | 9         | Create and manage projects, members, taxonomy discovery                      |
| **Connections**           | 13        | CRUD connectors, OAuth flow, test connection, trigger sync, discover filters |
| **Chat & Agent**          | 8         | Sessions, messages, streaming AI responses, trace logs                       |
| **Knowledge Graph**       | 11        | Nodes, edges, search, neighborhood traversal, full graph, stats              |
| **Memory / Observations** | 2         | List and search observations from the memory graph                           |
| **Files**                 | 5         | List, read, write, save artifacts, delete                                    |
| **Workflows**             | 7         | Generate, CRUD, and execute workflows                                        |
| **Admin**                 | 10        | Users, tenants, projects, usage stats, sync management, data purge           |
| **Skills**                | 4         | List skills, reload from repo, invoke by name                                |

## Base URLs

<CodeGroup>
  ```http Production theme={null}
  https://api.fabric.bulldogtechnologies.com/v1
  ```

  ```http Local dev theme={null}
  http://localhost:9000/v1
  ```

  ```http OpenAPI spec theme={null}
  https://api.fabric.bulldogtechnologies.com/openapi.json
  ```
</CodeGroup>

## MCP server (roadmap)

<Tip>
  An HTTP MCP endpoint is on the roadmap — exposing the same tool surface to external Claude Code sessions and Claude Routines, authenticated per-user by API key.
</Tip>