# Forms

Endpoints for form management and record submission

## Get forms for a user

 - [GET /api/control/forms/getForms](https://docs.hydrobit.ag/spec/openapi/forms/getforms.md): Retrieves all forms accessible to a user based on their company context.

Requires JWT token authentication in the Authorization header.

- If subtype=tasks, returns all task forms for the user
- Otherwise, returns monitoring forms based on user access permissions

## Submit a form record

 - [POST /api/control/forms/record](https://docs.hydrobit.ag/spec/openapi/forms/submitrecord.md): Submits a new form record with field values and location data.

This endpoint:
- Validates the record data
- Processes form field values
- Determines location (project/sector) using GPS or forced location
- Saves data to persistent storage
- Uploads media files (photos, audio, signatures) to cloud storage
- Updates task status if applicable