# API Reference

Complete API documentation for the CCAT Data Transfer System. This section provides detailed documentation for developers working with the system.

```{toctree}
:caption: 'API Documentation:'
:maxdepth: 2

managers/index
services/index
core/index
tasks/index
```

## Overview

The API is organized into functional areas:

**Managers** ({doc}`managers/index`)

: Core business logic classes that orchestrate data transfer operations.
  These follow the Manager/Worker pattern described in {doc}`../philosophy`.

**Services** ({doc}`services/index`)

: Supporting services and utilities that provide monitoring, health checks,
  and operational support.

**Core** ({doc}`core/index`)

: Fundamental components including database connections, configuration,
  exceptions, and utility functions.

**Tasks** ({doc}`tasks/index`)

: Celery task definitions and distributed processing components.

## Architecture Notes

All managers follow the same pattern:

1. **Manager Process**: Scans database, prepares operations, submits tasks
2. **Worker Process**: Executes actual work, updates database with results

See {doc}`../philosophy` for detailed explanation of the Manager/Worker duality.

For higher-level operational guidance, see the main documentation sections:

- {doc}`../concepts` - Core concepts and data model
- {doc}`../pipeline` - Data processing pipeline
- {doc}`../monitoring` - System monitoring and observability
- {doc}`../lifecycle` - Data lifecycle management