---
title: "Stream Bodymap Image"
method: GET
path: "/stream/images/bodymaps/{exercise_id}"
tags: ["media"]
---

# Stream Bodymap Image

`GET /stream/images/bodymaps/{exercise_id}`

Stream bodymap image file through authenticated endpoint.

This endpoint serves bodymap diagram images with proper authentication via
the API-key middleware. The public contract uses an exercise ID plus
validated query parameters; internal filenames remain server-owned. Each
image request counts as an API call.

Args:
    exercise_id: Exercise ID.
    gender: Gender variant, either male or female.
    theme: Image theme, either light or dark.
    view: Body view, either front or back.
    settings: Application settings injected via dependency.

Returns:
    FileResponse with the image file.

Raises:
    HTTPException: 403 if tier is not allowed.
    HTTPException: 404 if exercise or bodymap image file is not found.

Example:
    GET /stream/images/bodymaps/1?gender=male&theme=light&view=front

## Path parameters

- `exercise_id` integer, required

## Query parameters

- `gender` 'male' | 'female'
- `theme` 'light' | 'dark'
- `view` 'front' | 'back'

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/musclewiki/apis/musclewiki-api.md) · [All operations](https://skmtc.dev/musclewiki/apis/musclewiki-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/musclewiki/musclewiki-api/revisions/fccb1308d3dc/schema)