{"action":"created","comment":{"url":"https://api.github.com/repos/mattermost/mattermost-api-reference/pulls/comments/176729335","pull_request_review_id":106485759,"id":176729335,"diff_hunk":"@@ -300,22 +300,27 @@ tags:\n \n   - name: APIv3 Deprecation\n     description: |\n-      With the release of Mattermost server 4.0, API version 4 is stable and we strongly recommend using it over API version 3. The deprecation of API version 3 is planned for January 16th, 2018, which is six months after the stable release of v4.\n-\n-      The major changes from v3 to v4 are:\n-\n-      - Endpoint URLs only require team IDs when necessary, for example getting a channel by ID does not require a team ID in v4\n-      - Collection endpoints now generally return lists and include paging as part of the query string\n-      - User ID is now included in most user endpoints to allow for admins to use these endpoints to modify other users\n-\n-      All new integrations should use v4 and existing ones should begin migration over to version 4. Some suggested steps to help migrate your server and integrations are:\n-\n-      1. Set your server's log level to `DEBUG` and look for any requests hitting `/api/v3/` endpoints. The Mattermost webapp, desktop app, and classic mobile apps are solely using API version 4 and the new mobile apps will be completely moved over in their next release. That means that the majority of the logs you see will be from integrations that need to be migrated to v4.\n-      2. For in-house or self-built integrations, begin updating them to use v4 with the help of this documentation. Most v3 endpoints have direct counterparts in v4 and should be easily migrated.\n-      3. For integrations built by a third-party, visit their homepage (on GitHub, GitLab, etc.) and check if they already have a version that uses the Mattermost v4 API. If they do not, consider opening an issue asking them if support is planned.\n-      4. Once you have migrated all your integrations to use v4, take another look at the server logs to make sure you don't see many v3 endpoints in use. Then, in your `config.json`, set the setting `EnableAPIv3` to `false`. In the system console this setting is under `General` -> `Configuration` -> `Allow use of API v3 endpoints`. This will disable v3 and output an error to your server logs any time one is attempted to be used. Set your server's log level back to `ERROR` and use the error logs to help track down any last uses of v3.\n-\n-      If you have any questions about the deprecation or about migrating from v3 to v4, feel free to [join our daily build server at pre-release.mattermost.com](https://pre-release.mattermost.com/signup_user_complete/?id=f1924a8db44ff3bb41c96424cdc20676) and ask questions in the [APIv4 channel](https://pre-release.mattermost.com/core/channels/apiv4).\n+      Since Mattermost 4.0, API v4 is the preferred version to be used. API v3 are unsupported since Mattermost 4.6, released on January 16, 2018. They will be removed in Mattermost 5.0.","path":"v4/source/introduction.yaml","position":29,"original_position":29,"commit_id":"504d83dcfa4848c8c7c1909a6574fb58a12222d6","original_commit_id":"504d83dcfa4848c8c7c1909a6574fb58a12222d6","user":{"login":"jwilander","id":2672098,"avatar_url":"https://avatars0.githubusercontent.com/u/2672098?v=4","gravatar_id":"","url":"https://api.github.com/users/jwilander","html_url":"https://github.com/jwilander","followers_url":"https://api.github.com/users/jwilander/followers","following_url":"https://api.github.com/users/jwilander/following{/other_user}","gists_url":"https://api.github.com/users/jwilander/gists{/gist_id}","starred_url":"https://api.github.com/users/jwilander/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jwilander/subscriptions","organizations_url":"https://api.github.com/users/jwilander/orgs","repos_url":"https://api.github.com/users/jwilander/repos","events_url":"https://api.github.com/users/jwilander/events{/privacy}","received_events_url":"https://api.github.com/users/jwilander/received_events","type":"User","site_admin":false},"body":"`API v3 are` -> `API v3 is`","created_at":"2018-03-23T13:13:17Z","updated_at":"2018-03-23T13:16:56Z","html_url":"https://github.com/mattermost/mattermost-api-reference/pull/344#discussion_r176729335","pull_request_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/pulls/344","author_association":"COLLABORATOR","_links":{"self":{"href":"https://api.github.com/repos/mattermost/mattermost-api-reference/pulls/comments/176729335"},"html":{"href":"https://github.com/mattermost/mattermost-api-reference/pull/344#discussion_r176729335"},"pull_request":{"href":"https://api.github.com/repos/mattermost/mattermost-api-reference/pulls/344"}}},"pull_request":{"url":"https://api.github.com/repos/mattermost/mattermost-api-reference/pulls/344","id":176177053,"html_url":"https://github.com/mattermost/mattermost-api-reference/pull/344","diff_url":"https://github.com/mattermost/mattermost-api-reference/pull/344.diff","patch_url":"https://github.com/mattermost/mattermost-api-reference/pull/344.patch","issue_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/issues/344","number":344,"state":"open","locked":false,"title":"Proposed changes to APIv3 deprecation section","user":{"login":"jasonblais","id":13119842,"avatar_url":"https://avatars1.githubusercontent.com/u/13119842?v=4","gravatar_id":"","url":"https://api.github.com/users/jasonblais","html_url":"https://github.com/jasonblais","followers_url":"https://api.github.com/users/jasonblais/followers","following_url":"https://api.github.com/users/jasonblais/following{/other_user}","gists_url":"https://api.github.com/users/jasonblais/gists{/gist_id}","starred_url":"https://api.github.com/users/jasonblais/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jasonblais/subscriptions","organizations_url":"https://api.github.com/users/jasonblais/orgs","repos_url":"https://api.github.com/users/jasonblais/repos","events_url":"https://api.github.com/users/jasonblais/events{/privacy}","received_events_url":"https://api.github.com/users/jasonblais/received_events","type":"User","site_admin":false},"body":"In preparation for v4.9 release. APIv3 deprecation banner design is queued here https://mattermost.atlassian.net/browse/MM-9738","created_at":"2018-03-20T12:39:23Z","updated_at":"2018-03-23T13:16:56Z","closed_at":null,"merged_at":null,"merge_commit_sha":"c00875a7456a6499f41b0edd696b6ba2499abc0a","assignee":null,"assignees":[],"requested_reviewers":[],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/pulls/344/commits","review_comments_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/pulls/344/comments","review_comment_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/pulls/comments{/number}","comments_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/issues/344/comments","statuses_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/statuses/504d83dcfa4848c8c7c1909a6574fb58a12222d6","head":{"label":"mattermost:jasonblais-patch-1","ref":"jasonblais-patch-1","sha":"504d83dcfa4848c8c7c1909a6574fb58a12222d6","user":{"login":"mattermost","id":9828093,"avatar_url":"https://avatars1.githubusercontent.com/u/9828093?v=4","gravatar_id":"","url":"https://api.github.com/users/mattermost","html_url":"https://github.com/mattermost","followers_url":"https://api.github.com/users/mattermost/followers","following_url":"https://api.github.com/users/mattermost/following{/other_user}","gists_url":"https://api.github.com/users/mattermost/gists{/gist_id}","starred_url":"https://api.github.com/users/mattermost/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mattermost/subscriptions","organizations_url":"https://api.github.com/users/mattermost/orgs","repos_url":"https://api.github.com/users/mattermost/repos","events_url":"https://api.github.com/users/mattermost/events{/privacy}","received_events_url":"https://api.github.com/users/mattermost/received_events","type":"Organization","site_admin":false},"repo":{"id":67718239,"name":"mattermost-api-reference","full_name":"mattermost/mattermost-api-reference","owner":{"login":"mattermost","id":9828093,"avatar_url":"https://avatars1.githubusercontent.com/u/9828093?v=4","gravatar_id":"","url":"https://api.github.com/users/mattermost","html_url":"https://github.com/mattermost","followers_url":"https://api.github.com/users/mattermost/followers","following_url":"https://api.github.com/users/mattermost/following{/other_user}","gists_url":"https://api.github.com/users/mattermost/gists{/gist_id}","starred_url":"https://api.github.com/users/mattermost/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mattermost/subscriptions","organizations_url":"https://api.github.com/users/mattermost/orgs","repos_url":"https://api.github.com/users/mattermost/repos","events_url":"https://api.github.com/users/mattermost/events{/privacy}","received_events_url":"https://api.github.com/users/mattermost/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/mattermost/mattermost-api-reference","description":"Mattermost API reference documentation.","fork":false,"url":"https://api.github.com/repos/mattermost/mattermost-api-reference","forks_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/forks","keys_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/keys{/key_id}","collaborators_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/teams","hooks_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/hooks","issue_events_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/issues/events{/number}","events_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/events","assignees_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/assignees{/user}","branches_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/branches{/branch}","tags_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/tags","blobs_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/git/refs{/sha}","trees_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/git/trees{/sha}","statuses_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/statuses/{sha}","languages_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/languages","stargazers_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/stargazers","contributors_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/contributors","subscribers_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/subscribers","subscription_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/subscription","commits_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/commits{/sha}","git_commits_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/git/commits{/sha}","comments_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/comments{/number}","issue_comment_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/issues/comments{/number}","contents_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/contents/{+path}","compare_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/compare/{base}...{head}","merges_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/merges","archive_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/downloads","issues_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/issues{/number}","pulls_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/pulls{/number}","milestones_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/milestones{/number}","notifications_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/labels{/name}","releases_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/releases{/id}","deployments_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/deployments","created_at":"2016-09-08T15:57:58Z","updated_at":"2018-03-13T19:00:09Z","pushed_at":"2018-03-20T12:39:24Z","git_url":"git://github.com/mattermost/mattermost-api-reference.git","ssh_url":"git@github.com:mattermost/mattermost-api-reference.git","clone_url":"https://github.com/mattermost/mattermost-api-reference.git","svn_url":"https://github.com/mattermost/mattermost-api-reference","homepage":"https://api.mattermost.com","size":14378,"stargazers_count":26,"watchers_count":26,"language":"Makefile","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":39,"mirror_url":null,"archived":false,"open_issues_count":8,"license":null,"forks":39,"open_issues":8,"watchers":26,"default_branch":"master"}},"base":{"label":"mattermost:master","ref":"master","sha":"a33d80ecdd1249c32d66f2be4905c7cfd71b8a17","user":{"login":"mattermost","id":9828093,"avatar_url":"https://avatars1.githubusercontent.com/u/9828093?v=4","gravatar_id":"","url":"https://api.github.com/users/mattermost","html_url":"https://github.com/mattermost","followers_url":"https://api.github.com/users/mattermost/followers","following_url":"https://api.github.com/users/mattermost/following{/other_user}","gists_url":"https://api.github.com/users/mattermost/gists{/gist_id}","starred_url":"https://api.github.com/users/mattermost/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mattermost/subscriptions","organizations_url":"https://api.github.com/users/mattermost/orgs","repos_url":"https://api.github.com/users/mattermost/repos","events_url":"https://api.github.com/users/mattermost/events{/privacy}","received_events_url":"https://api.github.com/users/mattermost/received_events","type":"Organization","site_admin":false},"repo":{"id":67718239,"name":"mattermost-api-reference","full_name":"mattermost/mattermost-api-reference","owner":{"login":"mattermost","id":9828093,"avatar_url":"https://avatars1.githubusercontent.com/u/9828093?v=4","gravatar_id":"","url":"https://api.github.com/users/mattermost","html_url":"https://github.com/mattermost","followers_url":"https://api.github.com/users/mattermost/followers","following_url":"https://api.github.com/users/mattermost/following{/other_user}","gists_url":"https://api.github.com/users/mattermost/gists{/gist_id}","starred_url":"https://api.github.com/users/mattermost/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mattermost/subscriptions","organizations_url":"https://api.github.com/users/mattermost/orgs","repos_url":"https://api.github.com/users/mattermost/repos","events_url":"https://api.github.com/users/mattermost/events{/privacy}","received_events_url":"https://api.github.com/users/mattermost/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/mattermost/mattermost-api-reference","description":"Mattermost API reference documentation.","fork":false,"url":"https://api.github.com/repos/mattermost/mattermost-api-reference","forks_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/forks","keys_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/keys{/key_id}","collaborators_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/teams","hooks_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/hooks","issue_events_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/issues/events{/number}","events_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/events","assignees_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/assignees{/user}","branches_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/branches{/branch}","tags_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/tags","blobs_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/git/refs{/sha}","trees_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/git/trees{/sha}","statuses_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/statuses/{sha}","languages_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/languages","stargazers_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/stargazers","contributors_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/contributors","subscribers_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/subscribers","subscription_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/subscription","commits_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/commits{/sha}","git_commits_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/git/commits{/sha}","comments_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/comments{/number}","issue_comment_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/issues/comments{/number}","contents_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/contents/{+path}","compare_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/compare/{base}...{head}","merges_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/merges","archive_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/downloads","issues_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/issues{/number}","pulls_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/pulls{/number}","milestones_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/milestones{/number}","notifications_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/labels{/name}","releases_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/releases{/id}","deployments_url":"https://api.github.com/repos/mattermost/mattermost-api-reference/deployments","created_at":"2016-09-08T15:57:58Z","updated_at":"2018-03-13T19:00:09Z","pushed_at":"2018-03-20T12:39:24Z","git_url":"git://github.com/mattermost/mattermost-api-reference.git","ssh_url":"git@github.com:mattermost/mattermost-api-reference.git","clone_url":"https://github.com/mattermost/mattermost-api-reference.git","svn_url":"https://github.com/mattermost/mattermost-api-reference","homepage":"https://api.mattermost.com","size":14378,"stargazers_count":26,"watchers_count":26,"language":"Makefile","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":39,"mirror_url":null,"archived":false,"open_issues_count":8,"license":null,"forks":39,"open_issues":8,"watchers":26,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/mattermost/mattermost-api-reference/pulls/344"},"html":{"href":"https://github.com/mattermost/mattermost-api-reference/pull/344"},"issue":{"href":"https://api.github.com/repos/mattermost/mattermost-api-reference/issues/344"},"comments":{"href":"https://api.github.com/repos/mattermost/mattermost-api-reference/issues/344/comments"},"review_comments":{"href":"https://api.github.com/repos/mattermost/mattermost-api-reference/pulls/344/comments"},"review_comment":{"href":"https://api.github.com/repos/mattermost/mattermost-api-reference/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/mattermost/mattermost-api-reference/pulls/344/commits"},"statuses":{"href":"https://api.github.com/repos/mattermost/mattermost-api-reference/statuses/504d83dcfa4848c8c7c1909a6574fb58a12222d6"}},"author_association":"CONTRIBUTOR"}}
{"actor":{"display_login":"jwilander"}}