# Simple update without version check
curl -X PUT https://api.example.com/api/assessments/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Assessment Name",
    "progress": 50
  }'

# Update with optimistic locking
curl -X PUT https://api.example.com/api/assessments/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "COMPLETE",
    "progress": 100,
    "version": 3
  }'

const assessmentId = '550e8400-e29b-41d4-a716-446655440000';

// Update with optimistic locking
const response = await fetch(
  `https://api.example.com/api/assessments/${assessmentId}`,
  {
    method: 'PUT',
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      status: 'COMPLETE',
      progress: 100,
      version: 3  // Current version from GET request
    })
  }
);

if (response.status === 409) {
  // Conflict - assessment was modified by another user
  console.error('Assessment was updated by another user. Please refresh.');
} else {
  const updated = await response.json();
  console.log('New version:', updated.version);  // Will be 4
}

import requests

assessment_id = '550e8400-e29b-41d4-a716-446655440000'

# Update with optimistic locking
response = requests.put(
    f'https://api.example.com/api/assessments/{assessment_id}',
    headers={'Authorization': 'Bearer YOUR_TOKEN'},
    json={
        'status': 'COMPLETE',
        'progress': 100,
        'version': 3  # Current version from GET request
    }
)

if response.status_code == 409:
    # Conflict - assessment was modified
    print('Please refresh and try again')
else:
    updated = response.json()
    print(f'New version: {updated["version"]}')

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Updated Assessment Name",
  "companyName": "Acme Coffee Cooperative",
  "companyType": "Cooperative",
  "country": "Kenya",
  "status": "COMPLETE",
  "intakeMode": "UPLOAD",
  "progress": 100,
  "version": 4,
  "overallRiskScore": 38.5,
  "overallRiskLevel": "MODERATE",
  "userId": "auth0|123456789",
  "createdAt": "2026-03-04T10:30:00.000Z",
  "updatedAt": "2026-03-04T14:20:00.000Z"
}

{
  "statusCode": 404,
  "message": "Assessment not found",
  "error": "Not Found"
}

{
  "statusCode": 409,
  "message": "Assessment was modified by another user. Please refresh and try again.",
  "error": "Conflict"
}