# Submit a form record

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

Endpoint: POST /api/control/forms/record
Version: 2.0.0
Security: bearerAuth

## Request fields (application/json):

  - `record` (object, required)

  - `record._id` (string, required)
    Form ID (not the record ID)
    Example: "form_abc123"

  - `record.auth0Id` (string, required)
    User identifier
    Example: "user_123456789"

  - `record.type` (string, required)
    Record type
    Example: "inspection"

  - `record.latitude` (number)
    GPS latitude
    Example: 19.4326

  - `record.longitude` (number)
    GPS longitude
    Example: -99.1332

  - `record.form_id` (string)
    Form identifier
    Example: "form_abc123"

  - `record.form_values` (array)
    Array of form field values

  - `record.inicio` (string)
    Record start time
    Example: "2025-10-09T10:00:00Z"

  - `record.segundos` (number)
    Time spent on record (in seconds)
    Example: 120

## Response 201 fields (application/json):

  - `status` (string)
    Example: "success"

  - `verification` (object)

  - `verification.project` (boolean)
    Whether the location is verified within a project
    Example: true

  - `verification.sector` (boolean)
    Whether the location is verified within a sector
    Example: true

## Response 400 fields (application/json):

  - `status` (string)
    Example: "error"

  - `message` (string)
    Example: "Error message description"

  - `error` (string)
    Example: "Detailed error information"

## Response 401 fields (application/json):

  - `status` (string)
    Example: "error"

  - `message` (string)
    Example: "Error message description"

  - `error` (string)
    Example: "Detailed error information"

## Response 500 fields (application/json):

  - `status` (string)
    Example: "error"

  - `message` (string)
    Example: "Error message description"

  - `error` (string)
    Example: "Detailed error information"