Skip to content

Document Overseerr issue management features#42494

Merged
c0ffeeca7 merged 4 commits intohome-assistant:nextfrom
AmGarera:overseerr-issue-management-docs
Dec 18, 2025
Merged

Document Overseerr issue management features#42494
c0ffeeca7 merged 4 commits intohome-assistant:nextfrom
AmGarera:overseerr-issue-management-docs

Conversation

@AmGarera
Copy link
Copy Markdown
Contributor

@AmGarera AmGarera commented Dec 10, 2025

Description

This PR documents the new issue management functionality for the Overseerr integration, including:

  • 6 new issue sensors (total, open, closed, video, audio, subtitle)
  • 4 new service actions (get_issues, create_issue, update_issue, delete_issue)
  • Updated supported functionality section
  • Example automations for issue management
  • Use cases and workflow examples

Related PRs

Notes

Documentation covers both the sensors (PR #158888) and services (upcoming PR) as they form a complete feature set. This PR should be merged after both implementation PRs are merged.

@AmGarera AmGarera requested a review from joostlek as a code owner December 10, 2025 03:05
@home-assistant home-assistant Bot added current This PR goes into the current branch has-parent This PR has a parent PR in another repo in-progress This PR/Issue is currently being worked on needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch labels Dec 10, 2025
@home-assistant
Copy link
Copy Markdown

It seems that this PR is targeted against an incorrect branch since it has a parent PR on one of our codebases. Documentation that needs to be updated for an upcoming release should target the next branch. Please change the target branch of this PR to next and rebase if needed.

@netlify
Copy link
Copy Markdown

netlify Bot commented Dec 10, 2025

Deploy Preview for home-assistant-docs ready!

Name Link
🔨 Latest commit f20b321
🔍 Latest deploy log https://app.netlify.com/projects/home-assistant-docs/deploys/6942dbec3214870008d345ad
😎 Deploy Preview https://deploy-preview-42494--home-assistant-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@home-assistant home-assistant Bot removed needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch current This PR goes into the current branch labels Dec 10, 2025
@home-assistant home-assistant Bot added the next This PR goes into the next branch label Dec 10, 2025
@c0ffeeca7 c0ffeeca7 removed request for a team December 10, 2025 04:41
@c0ffeeca7
Copy link
Copy Markdown
Contributor

c0ffeeca7 commented Dec 10, 2025

Thank you for contributing, @AmGarera 👍

  1. It seems this PR was created based against the current branch. This is why there are unrelated commits and changes in the PR.
    image

  2. To resolve this, please rebase and point this PR against the next branch.

  3. Restore the original PR template.

  4. In the PR template, add the link to the related core PR.

  5. Add the link to the related brands PR.

@c0ffeeca7
Copy link
Copy Markdown
Contributor

I'm drafting this PR, as changes are needed.

Please undraft it once the changes have been implemented and the PR is ready for review again.

Add documentation for new issue management features:
- 6 new issue sensors (total, open, closed, video, audio, subtitle)
- 4 new issue services (get_issues, create_issue, update_issue, delete_issue)
- Example automations for automatic issue creation and monitoring
- Updated use cases section
@AmGarera
Copy link
Copy Markdown
Contributor Author

AmGarera commented Dec 10, 2025

Thank you for the feedback!

The PR should now be clean with only the Overseerr documentation changes.

Comment thread source/_integrations/overseerr.markdown Outdated
| `sort_order` | Yes | The sort order to sort the results in (`added`/`modified`). |
| `requested_by` | Yes | Filter the requests based on the user ID of the requester. |

### Action `overseerr.get_issues`
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For the actions documentation, please apply the style that is suggested here:
https://github.com/home-assistant/home-assistant.io/blob/current/source/_integrations/_integration_docs_template.markdown?plain=1#L139

  • Use a non-YAML title, mentioning the YAML in the introduction of the action description.
  • Use a list instead of a table, as shown in the example.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should be all resolved now

@home-assistant
Copy link
Copy Markdown

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

- Changed action section titles to non-YAML format (e.g., 'Get requests' instead of 'Action overseerr.get_requests')
- Mention the YAML action name in the introduction sentence
- Replaced tables with list format for better readability
- Format: **field_name** (*Required/Optional*): Description
c0ffeeca7
c0ffeeca7 previously approved these changes Dec 15, 2025
Copy link
Copy Markdown
Contributor

@c0ffeeca7 c0ffeeca7 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you, @AmGarera 👍

Comment thread source/_integrations/overseerr.markdown Outdated
Comment on lines +92 to +97
### Issue actions

- `overseerr.get_issues` - Get a list of issues
- `overseerr.create_issue` - Create a new issue for media
- `overseerr.update_issue` - Update an existing issue
- `overseerr.delete_issue` - Delete an issue
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not yet, let's make this PR only about the new sensors

Copy link
Copy Markdown
Contributor

@c0ffeeca7 c0ffeeca7 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you, @AmGarera 👍

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

has-parent This PR has a parent PR in another repo next This PR goes into the next branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants