Updates to webhook api

[Britaliope]

Summary

Documentation MR for mattermost/mattermost#30495

Question: Does it makes sense to have the webhook documentation on https://developers.mattermost.com ? My first instinct when looking for this documentation was to look on https://api.mattermost.com

[mattermost-build]

Hello @Britaliope,

Thanks for your pull request! A Core Committer will review your pull request soon. For code contributions, you can learn more about the review process here.

[cwarnermm]

@davidkrauser - Assigned you as a member of core reviewers. Feel free to reassign as needed.

[davidkrauser]

Thanks for taking the time to update the documentation along with your change 🙂

@Britaliope wrote:

Question: Does it makes sense to have the webhook documentation on https://developers.mattermost.com/ ? My first instinct when looking for this documentation was to look on https://api.mattermost.com/

I think what you've done is right - the documentation at api.mattermost.com specifies the endpoints to create and manage webhooks, while the webhook documentation on developers.mattermost.com specifies how to use them once created.

[davidkrauser]

Looks good to me, pending the related PR merges: mattermost/mattermost#30495

@cwarnermm this introduces a minor breaking change to the API. Instead of returning the plain text ok, we now return the contents of the post that was created. I know you're working on a new process around breaking changes, so wanted to point it out 🙂

[cwarnermm]

Really appreciate the visibility on this, @davidkrauser! Thank you!

[hanzei]

Thanks for documenting your changes!

[mattermost-build]

This PR has been automatically labelled "stale" because it hasn't had recent activity.
A core team member will check in on the status of the PR to help with questions.
Thank you for your contribution!

[mattermost-build]

This PR has been automatically labelled "stale" because it hasn't had recent activity.
A core team member will check in on the status of the PR to help with questions.
Thank you for your contribution!