feat: document audio transcode parameters

[LukasParke]

Agent: Documents the audio-specific query parameters used with the existing universal transcode endpoint:

• session, the playback session UUID used by music clients
• maxAudioBitrate, the requested audio bitrate ceiling

The generic /{transcodeType}/:/transcode/universal/start.{extension} route already covers /music/:/transcode/universal/start.m3u8, so this avoids introducing a duplicate OpenAPI path while making the reported request representable.

Closes #41

Validation

• npm run validate
• speakeasy lint openapi -s plex-api-spec.yaml — 0 errors; existing warning baseline
• git diff --check

Greptile Summary

This change extends the universal-transcode request contract for music clients by documenting the playback session, maxAudioBitrate, and query-form X-Plex-Client-Profile-Extra parameters. Focused contract checks confirmed that the query and header profile-augmentation parameters remain distinct in both OpenAPI identity and generated SDK naming. The complete specification also passes Redocly validation and formatting checks.

Confidence Score: 5/5

The documented request contract is structurally valid and preserves distinct handling for the query and header forms of the client-profile parameter.

Focused parsing and serialization checks passed for the changed parameters, and full-spec validation and formatting checks completed successfully. No defects were found.

Files Needing Attention: No files need further attention.

T-Rex Logs

What T-Rex did

• Ran the universal-transcode contract validation script against plex-api-spec.yaml and verified the distinct SDK name and the session and maxAudioBitrate schemas.
• Linted the plex-api-spec.yaml with Redocly; the lint run exited successfully and the API description was reported as valid.
• The focused universal-transcode contract assertion was checked on the current revision: it failed on the parent revision because the new query parameter was absent, and then passed on this revision with separate query/header parameter identities and wire serialization.

_{Ran code and verified through T-Rex}

_{Reviews (1): Last reviewed commit: "fix: support query profile augmentations" | Re-trigger Greptile}

[coderabbitai]

Warning

Review limit reached

@LukasParke, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 53 minutes

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: Repository UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 87dad244-319b-4d38-8684-fa13a51dbf28

📥 Commits

Reviewing files that changed from the base of the PR and between 06ee983 and c2b6c28.

📒 Files selected for processing (1)

• plex-api-spec.yaml

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}