# Workers

Endpoints for worker management and operations

## Create a new worker

 - [POST /api/control/workers](https://docs.hydrobit.ag/spec/openapi/workers/createworker.md): Creates a new worker record with automatic ID generation and optional photo upload.

Key features:
- Worker ID is auto-generated as INITIALS + MMDD (from hire date)
- Requires JWT token authentication in the Authorization header
- Company context is inferred from the authenticated user
- Validates position, employment_type, and status against template options
- Ensures worker_id uniqueness per company (idempotent on duplicate)
- Supports photo upload via base64 data URL (JPEG, PNG, WebP up to 12MB)
- Photos are uploaded to cloud storage and URL is returned in response

## Get list of workers

 - [GET /api/control/workers](https://docs.hydrobit.ag/spec/openapi/workers/listworkers.md): Retrieves a paginated list of workers for the authenticated user's company.

Features:
- Requires JWT token authentication in the Authorization header
- Company context is inferred from the authenticated user
- Supports search by name or worker_id using the 'q' parameter
- Filter by status, position, or employment_type
- Pagination with customizable page size (default 25, max 100)
- Results sorted by creation date (newest first)

## Get a single worker

 - [GET /api/control/workers/{worker}](https://docs.hydrobit.ag/spec/openapi/workers/getworker.md): Retrieves detailed information about a specific worker by unique identifier or worker_id.

Features:
- Requires JWT token authentication in the Authorization header
- Company context is inferred from the authenticated user
- Can fetch by unique identifier or by worker_id (e.g., "JS0315")
- Returns full worker details including all fields