# Fitness Exercises Get Random

> Returns a single randomly selected exercise. Accepts the same filter parameters as the list endpoint, so you can get a random chest exercise, a random bodyweight exercise, etc.

- Skill: `gabrielmoreira/fitness-exercises-get-random` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/fitness-exercises-get-random`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/fitness-exercises-get-random/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/fitness-exercises-get-random

---


## Endpoint

**GET https://requiems.xyz/v1/health/exercises/random**

## Random Exercise

Returns a single randomly selected exercise. Accepts the same filter parameters as the list endpoint, so you can get a random chest exercise, a random bodyweight exercise, etc.

## Parameters

| Name | Type | Required | Location | Description |
| ---- | ---- | -------- | -------- | ----------- |
| `body_part` | string | no | query | Restrict random selection to this body part. |
| `equipment` | string | no | query | Restrict random selection to this equipment type. |
| `muscle` | string | no | query | Restrict random selection to exercises targeting this muscle. |
| `search` | string | no | query | Restrict random selection to exercises matching this search term. |

## Response Example

```json
{
  "data": {
    "id": 42,
    "name": "dumbbell curl",
    "body_parts": ["upper arms"],
    "equipment": ["dumbbell"],
    "target_muscles": ["biceps"],
    "secondary_muscles": ["brachialis"],
    "instructions": [
      "Stand with a dumbbell in each hand, arms fully extended.",
      "Curl the weights toward your shoulders, keeping your elbows close to your torso.",
      "Squeeze at the top, then lower the weights slowly.",
      "Repeat for the desired number of repetitions."
    ]
  },
  "metadata": {
    "timestamp": "2026-01-01T00:00:00Z"
  }
}
```

## Errors

- `404` **not_found** — No exercises match the given filters.
- `500` **internal_error** — Unexpected server error.