Accessibility Recommendation

Get an AI-generated accessibility profile recommendation

This endpoint is served by the AI service at http://localhost:8001. It is an internal service and does not require authentication.

POST /ai/accessibility

Called during the onboarding accessibility wizard to recommend the best UI theme and settings for the user. The model takes behavioral and self-reported signals and returns a tailored accessibility profile.

Model accuracy: 0.89.

Request body

can_read_small_text · boolean · required

Whether the user can comfortably read small text.

uses_screen_reader · boolean · required

Whether the user relies on a screen reader.

feels_confident_with_apps · string · required

Self-reported confidence level with mobile apps. Accepted values: "low", "medium", "high".

age_range · string · required

User’s age bracket. Accepted values: "18_30", "31_50", "51_60", "60_plus".

avg_time_per_screen_seconds · integer · required

Average time the user spends per screen during the session. Must be ≥ 0.

total_validation_errors · integer · required

Total number of validation errors across the session. Must be ≥ 0.

requested_help_count · integer · required

Number of times the user explicitly requested help during the session. Must be ≥ 0.

user_id · string

Optional user identifier for logging and analytics.

Response

user_id · string

Echoed user identifier from the request.

model_version · string · required

Version of the accessibility model that produced the recommendation.

recommendation · object · required

Show recommendation properties

theme · string · required

Recommended UI theme. See theme values below.

screen_reader_mode · boolean · required

Whether screen reader optimizations should be enabled.

font_scale · number · required

Recommended font scale multiplier, e.g., 1.2 or 1.6.

nudging_level · string · required

Recommended nudging sensitivity: "low", "medium", or "high".

voice_feedback · boolean · required

Whether voice feedback should be enabled.

confidence · number · required

Model confidence score between 0.0 and 1.0.

explanation · string[] · required

Human-readable list of reasons for the recommendation.

Theme values

Theme	Description	Font scale
standard-accessible	Default accessible mode for most users.	1.2
large-text-high-contrast	For low vision or older users who need increased readability.	1.6
voice-assisted	For screen reader users. Enables voice feedback.	1.2

curl

curl --request POST \
  --url http://localhost:8001/ai/accessibility \
  --header 'Content-Type: application/json' \
  --data '{
  "user_id": "user-123",
  "can_read_small_text": false,
  "uses_screen_reader": false,
  "feels_confident_with_apps": "low",
  "age_range": "60_plus",
  "avg_time_per_screen_seconds": 45,
  "total_validation_errors": 6,
  "requested_help_count": 2
}'

Response

{
  "user_id": "user-123",
  "model_version": "accessibility-v1.1",
  "recommendation": {
    "theme": "large-text-high-contrast",
    "screen_reader_mode": false,
    "font_scale": 1.6,
    "nudging_level": "high",
    "voice_feedback": false
  },
  "confidence": 0.9,
  "explanation": ["Increased font and contrast for readability"]
}