# API Reference

Complete API documentation for the CCAT Workflow Manager. This section provides
detailed documentation for developers working with the system.

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

managers
tasks
hpc
grouping
execution
```

## Overview

The API is organized into functional areas:

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

: Core orchestration classes: trigger evaluation, workflow dispatch, and result
  collection. These follow the Manager/Worker pattern described in
  {doc}`/source/architecture/manager_worker`.

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

: Celery task definitions for staging, HPC submission, and result collection.

**HPC** ({doc}`hpc`)

: Abstract backend interface and implementations (SLURM, Kubernetes, Local).

**Grouping** ({doc}`grouping`)

: Filter engine, sub-group resolution, and preset templates.

**Execution** ({doc}`execution`)

: Command builder for Apptainer execution and manifest generation.

## Architecture Notes

All managers follow the same pattern:

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

See {doc}`/source/architecture/manager_worker` for detailed explanation.

For higher-level operational guidance, see:

- {doc}`/source/concepts/overview` - System overview
- {doc}`/source/concepts/execution_flow` - Run lifecycle
- {doc}`/source/operations/configuration` - Configuration reference