feat: document accepting Plex invitations

[LukasParke]

Agent: Documents the Plex.tv operation used to accept pending friend, home, and server invitations.

The operation follows the maintained Python-PlexAPI implementation:

• PUT https://plex.tv/api/invites/requests/{inviteId}
• required friend, home, and server boolean-integer flags
• legacy XML success response

Closes #87

Validation

• npm run validate
• git diff --check

Greptile Summary

Summary

This change documents the Plex.tv endpoint for accepting pending friend, home, and server invitations.

The documented PUT request was checked for its route, Plex.tv server override, required invitation ID and integer scope flags, inherited token authentication, and XML success response. The unauthenticated live route returned the documented authentication failure behavior. No defects were found.

Confidence Score: 5/5

Safe to merge; the added API documentation forms a valid, authenticated OpenAPI contract.

A focused YAML validator confirmed the added operation's path, method, server, required parameters, integer-backed flags, inherited security, and XML response declaration. Full-spec OpenAPI lint completed successfully, and a live unauthenticated request confirmed that the documented route enforces authentication.

Files Needing Attention: No files need further attention.

T-Rex Logs

What T-Rex did

• Ran the authored Node.js YAML validator against the parent revision and the updated specification, and confirmed the updated spec passes assertions for PUT /api/invites/requests/{inviteId}, the Plex.tv server override, required integer invitation flags, inherited X-Plex-Token authentication, and the XML success response.
• Sent a PUT to the Plex.tv invites endpoint without credentials and observed a 401 Unauthorized with the XML message 'Please sign in.', proving authentication is enforced for the invitation operation.
• Ran Redocly lint on the invitation operation OpenAPI spec and it exited successfully.
• Disproved structurally that the PUT path, Plex.tv server override, required integer flags, or inherited token security were missing or malformed, since the unauthenticated request returned 401 and no authenticated success path was observed.

_{Ran code and verified through T-Rex}

_{Reviews (1): Last reviewed commit: "feat: document accepting invitations" | 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: 59 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: 11ea007c-ccbf-4029-b2fa-47aa5403509f

📥 Commits

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

📒 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.}