{"action":"created","comment":{"url":"https://api.github.com/repos/bitreserve/api/pulls/comments/32478873","id":32478873,"diff_hunk":"@@ -39,19 +103,65 @@ curl https://api.bitreserve.org/v0/me/tokens \\\n   -d '{ \"description\": \"My command line script\" }'\n ```\n \n-> If your request for a token checks out, then our API will return the following:\n+To create a Personal Access Token you may use the following endpoint:\n \n-```json\n-{\n-  \"access_token\": \"41ee8b1fa14042e031fe304bb4793b54e6576d19b306dc205136172b80d59d20\",\n-  \"description\": \"My command line script\",\n-  \"expires\": null\n-}\n+`POST https://bitreserve.org/v0/me/tokens`\n+\n+Supported parameters:\n+\n+Parameter | Required |  Description\n+--------- | ----------- | -----------\n+description | no | A human-readable description of this PAT.\n+\n+<aside class=\"notice\">\n+**Import Notice**: This request must be authenticated with your username and password using the HTTP Basic Authentication scheme.\n+\n+Additionally, if the account is secured with Two-Factor Authentication, the `X-Bitreserve-OTP` header is required.\n+</aside>\n+\n+### Revoking a PAT\n+\n+> To revoke a Personal Access Token, execute the following command:\n+\n+```bash\n+curl https://api.bitreserve.org/v0/me/tokens/:token \\\n+  -X DELETE \\\n+  -H \"Authorization: Bearer <token>\"\n ```\n \n-> Here is an example for using the personal access token to make requests to our API:\n+To revoke a Personal Access Token you may use the following endpoint:\n+\n+`DELETE https://bitreserve.org/v0/me/tokens/:token`\n+\n+Supported parameters:\n+\n+Parameter | Required |  Description\n+--------- | ----------- | -----------\n+token | yes | The PAT you wish to revoke.\n+\n+### Using a PAT\n+\n+> Example of using a personal access token to make requests to our API:\n \n ```bash\n curl https://api.bitreserve.org/v0/me \\\n   -u 41ee8b1fa14042e031fe304bb4793b54e6576d19b306dc205136172b80d59d20:X-OAuth-Basic\n ```\n+\n+A PAT may be used for authenticating a request via the HTTP Basic Authentication scheme.\n+\n+The username should be set as the `token` and password should be set to `X-OAuth-Basic`.\n+\n+## Basic Authentication\n+\n+> Simple request using username or email and password:\n+\n+```bash\n+curl https://api.bitreserve.org/v0/me \\\n+  -H 'X-Bitreserve-OTP: <OTP-Token>' \\","path":"_authentication.md","position":176,"original_position":176,"commit_id":"7e9def7424b4438b3493d5aed71c0502f4b54e4c","original_commit_id":"7e9def7424b4438b3493d5aed71c0502f4b54e4c","user":{"login":"fixe","id":484559,"avatar_url":"https://avatars.githubusercontent.com/u/484559?v=3","gravatar_id":"","url":"https://api.github.com/users/fixe","html_url":"https://github.com/fixe","followers_url":"https://api.github.com/users/fixe/followers","following_url":"https://api.github.com/users/fixe/following{/other_user}","gists_url":"https://api.github.com/users/fixe/gists{/gist_id}","starred_url":"https://api.github.com/users/fixe/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/fixe/subscriptions","organizations_url":"https://api.github.com/users/fixe/orgs","repos_url":"https://api.github.com/users/fixe/repos","events_url":"https://api.github.com/users/fixe/events{/privacy}","received_events_url":"https://api.github.com/users/fixe/received_events","type":"User","site_admin":false},"body":"Should we mention that OTP isn't required when using a PAT?","created_at":"2015-06-15T23:36:46Z","updated_at":"2015-06-15T23:36:46Z","html_url":"https://github.com/bitreserve/api/pull/53#discussion_r32478873","pull_request_url":"https://api.github.com/repos/bitreserve/api/pulls/53","_links":{"self":{"href":"https://api.github.com/repos/bitreserve/api/pulls/comments/32478873"},"html":{"href":"https://github.com/bitreserve/api/pull/53#discussion_r32478873"},"pull_request":{"href":"https://api.github.com/repos/bitreserve/api/pulls/53"}}},"pull_request":{"url":"https://api.github.com/repos/bitreserve/api/pulls/53","id":37594816,"html_url":"https://github.com/bitreserve/api/pull/53","diff_url":"https://github.com/bitreserve/api/pull/53.diff","patch_url":"https://github.com/bitreserve/api/pull/53.patch","issue_url":"https://api.github.com/repos/bitreserve/api/issues/53","number":53,"state":"open","locked":false,"title":"Add Bitreserve Connect documentation","user":{"login":"digobaptista","id":11156750,"avatar_url":"https://avatars.githubusercontent.com/u/11156750?v=3","gravatar_id":"","url":"https://api.github.com/users/digobaptista","html_url":"https://github.com/digobaptista","followers_url":"https://api.github.com/users/digobaptista/followers","following_url":"https://api.github.com/users/digobaptista/following{/other_user}","gists_url":"https://api.github.com/users/digobaptista/gists{/gist_id}","starred_url":"https://api.github.com/users/digobaptista/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/digobaptista/subscriptions","organizations_url":"https://api.github.com/users/digobaptista/orgs","repos_url":"https://api.github.com/users/digobaptista/repos","events_url":"https://api.github.com/users/digobaptista/events{/privacy}","received_events_url":"https://api.github.com/users/digobaptista/received_events","type":"User","site_admin":false},"body":"","created_at":"2015-06-12T19:09:56Z","updated_at":"2015-06-15T23:36:46Z","closed_at":null,"merged_at":null,"merge_commit_sha":"db98eb69e01b9dbbbb67708ea053a516bca99626","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/bitreserve/api/pulls/53/commits","review_comments_url":"https://api.github.com/repos/bitreserve/api/pulls/53/comments","review_comment_url":"https://api.github.com/repos/bitreserve/api/pulls/comments{/number}","comments_url":"https://api.github.com/repos/bitreserve/api/issues/53/comments","statuses_url":"https://api.github.com/repos/bitreserve/api/statuses/7e9def7424b4438b3493d5aed71c0502f4b54e4c","head":{"label":"bitreserve:enhancement/add-bitreserve-connect-docs","ref":"enhancement/add-bitreserve-connect-docs","sha":"7e9def7424b4438b3493d5aed71c0502f4b54e4c","user":{"login":"bitreserve","id":7734494,"avatar_url":"https://avatars.githubusercontent.com/u/7734494?v=3","gravatar_id":"","url":"https://api.github.com/users/bitreserve","html_url":"https://github.com/bitreserve","followers_url":"https://api.github.com/users/bitreserve/followers","following_url":"https://api.github.com/users/bitreserve/following{/other_user}","gists_url":"https://api.github.com/users/bitreserve/gists{/gist_id}","starred_url":"https://api.github.com/users/bitreserve/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bitreserve/subscriptions","organizations_url":"https://api.github.com/users/bitreserve/orgs","repos_url":"https://api.github.com/users/bitreserve/repos","events_url":"https://api.github.com/users/bitreserve/events{/privacy}","received_events_url":"https://api.github.com/users/bitreserve/received_events","type":"Organization","site_admin":false},"repo":{"id":29829387,"name":"api","full_name":"bitreserve/api","owner":{"login":"bitreserve","id":7734494,"avatar_url":"https://avatars.githubusercontent.com/u/7734494?v=3","gravatar_id":"","url":"https://api.github.com/users/bitreserve","html_url":"https://github.com/bitreserve","followers_url":"https://api.github.com/users/bitreserve/followers","following_url":"https://api.github.com/users/bitreserve/following{/other_user}","gists_url":"https://api.github.com/users/bitreserve/gists{/gist_id}","starred_url":"https://api.github.com/users/bitreserve/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bitreserve/subscriptions","organizations_url":"https://api.github.com/users/bitreserve/orgs","repos_url":"https://api.github.com/users/bitreserve/repos","events_url":"https://api.github.com/users/bitreserve/events{/privacy}","received_events_url":"https://api.github.com/users/bitreserve/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/bitreserve/api","description":"Bitreserve API Reference","fork":false,"url":"https://api.github.com/repos/bitreserve/api","forks_url":"https://api.github.com/repos/bitreserve/api/forks","keys_url":"https://api.github.com/repos/bitreserve/api/keys{/key_id}","collaborators_url":"https://api.github.com/repos/bitreserve/api/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/bitreserve/api/teams","hooks_url":"https://api.github.com/repos/bitreserve/api/hooks","issue_events_url":"https://api.github.com/repos/bitreserve/api/issues/events{/number}","events_url":"https://api.github.com/repos/bitreserve/api/events","assignees_url":"https://api.github.com/repos/bitreserve/api/assignees{/user}","branches_url":"https://api.github.com/repos/bitreserve/api/branches{/branch}","tags_url":"https://api.github.com/repos/bitreserve/api/tags","blobs_url":"https://api.github.com/repos/bitreserve/api/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/bitreserve/api/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/bitreserve/api/git/refs{/sha}","trees_url":"https://api.github.com/repos/bitreserve/api/git/trees{/sha}","statuses_url":"https://api.github.com/repos/bitreserve/api/statuses/{sha}","languages_url":"https://api.github.com/repos/bitreserve/api/languages","stargazers_url":"https://api.github.com/repos/bitreserve/api/stargazers","contributors_url":"https://api.github.com/repos/bitreserve/api/contributors","subscribers_url":"https://api.github.com/repos/bitreserve/api/subscribers","subscription_url":"https://api.github.com/repos/bitreserve/api/subscription","commits_url":"https://api.github.com/repos/bitreserve/api/commits{/sha}","git_commits_url":"https://api.github.com/repos/bitreserve/api/git/commits{/sha}","comments_url":"https://api.github.com/repos/bitreserve/api/comments{/number}","issue_comment_url":"https://api.github.com/repos/bitreserve/api/issues/comments{/number}","contents_url":"https://api.github.com/repos/bitreserve/api/contents/{+path}","compare_url":"https://api.github.com/repos/bitreserve/api/compare/{base}...{head}","merges_url":"https://api.github.com/repos/bitreserve/api/merges","archive_url":"https://api.github.com/repos/bitreserve/api/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/bitreserve/api/downloads","issues_url":"https://api.github.com/repos/bitreserve/api/issues{/number}","pulls_url":"https://api.github.com/repos/bitreserve/api/pulls{/number}","milestones_url":"https://api.github.com/repos/bitreserve/api/milestones{/number}","notifications_url":"https://api.github.com/repos/bitreserve/api/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/bitreserve/api/labels{/name}","releases_url":"https://api.github.com/repos/bitreserve/api/releases{/id}","created_at":"2015-01-25T20:20:49Z","updated_at":"2015-06-12T11:36:17Z","pushed_at":"2015-06-15T18:24:25Z","git_url":"git://github.com/bitreserve/api.git","ssh_url":"git@github.com:bitreserve/api.git","clone_url":"https://github.com/bitreserve/api.git","svn_url":"https://github.com/bitreserve/api","homepage":" https://developer.bitreserve.org","size":396,"stargazers_count":9,"watchers_count":9,"language":null,"has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":8,"mirror_url":null,"open_issues_count":12,"forks":8,"open_issues":12,"watchers":9,"default_branch":"master"}},"base":{"label":"bitreserve:master","ref":"master","sha":"6da934dcf3d08992077b7a07470987c726919534","user":{"login":"bitreserve","id":7734494,"avatar_url":"https://avatars.githubusercontent.com/u/7734494?v=3","gravatar_id":"","url":"https://api.github.com/users/bitreserve","html_url":"https://github.com/bitreserve","followers_url":"https://api.github.com/users/bitreserve/followers","following_url":"https://api.github.com/users/bitreserve/following{/other_user}","gists_url":"https://api.github.com/users/bitreserve/gists{/gist_id}","starred_url":"https://api.github.com/users/bitreserve/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bitreserve/subscriptions","organizations_url":"https://api.github.com/users/bitreserve/orgs","repos_url":"https://api.github.com/users/bitreserve/repos","events_url":"https://api.github.com/users/bitreserve/events{/privacy}","received_events_url":"https://api.github.com/users/bitreserve/received_events","type":"Organization","site_admin":false},"repo":{"id":29829387,"name":"api","full_name":"bitreserve/api","owner":{"login":"bitreserve","id":7734494,"avatar_url":"https://avatars.githubusercontent.com/u/7734494?v=3","gravatar_id":"","url":"https://api.github.com/users/bitreserve","html_url":"https://github.com/bitreserve","followers_url":"https://api.github.com/users/bitreserve/followers","following_url":"https://api.github.com/users/bitreserve/following{/other_user}","gists_url":"https://api.github.com/users/bitreserve/gists{/gist_id}","starred_url":"https://api.github.com/users/bitreserve/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bitreserve/subscriptions","organizations_url":"https://api.github.com/users/bitreserve/orgs","repos_url":"https://api.github.com/users/bitreserve/repos","events_url":"https://api.github.com/users/bitreserve/events{/privacy}","received_events_url":"https://api.github.com/users/bitreserve/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/bitreserve/api","description":"Bitreserve API Reference","fork":false,"url":"https://api.github.com/repos/bitreserve/api","forks_url":"https://api.github.com/repos/bitreserve/api/forks","keys_url":"https://api.github.com/repos/bitreserve/api/keys{/key_id}","collaborators_url":"https://api.github.com/repos/bitreserve/api/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/bitreserve/api/teams","hooks_url":"https://api.github.com/repos/bitreserve/api/hooks","issue_events_url":"https://api.github.com/repos/bitreserve/api/issues/events{/number}","events_url":"https://api.github.com/repos/bitreserve/api/events","assignees_url":"https://api.github.com/repos/bitreserve/api/assignees{/user}","branches_url":"https://api.github.com/repos/bitreserve/api/branches{/branch}","tags_url":"https://api.github.com/repos/bitreserve/api/tags","blobs_url":"https://api.github.com/repos/bitreserve/api/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/bitreserve/api/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/bitreserve/api/git/refs{/sha}","trees_url":"https://api.github.com/repos/bitreserve/api/git/trees{/sha}","statuses_url":"https://api.github.com/repos/bitreserve/api/statuses/{sha}","languages_url":"https://api.github.com/repos/bitreserve/api/languages","stargazers_url":"https://api.github.com/repos/bitreserve/api/stargazers","contributors_url":"https://api.github.com/repos/bitreserve/api/contributors","subscribers_url":"https://api.github.com/repos/bitreserve/api/subscribers","subscription_url":"https://api.github.com/repos/bitreserve/api/subscription","commits_url":"https://api.github.com/repos/bitreserve/api/commits{/sha}","git_commits_url":"https://api.github.com/repos/bitreserve/api/git/commits{/sha}","comments_url":"https://api.github.com/repos/bitreserve/api/comments{/number}","issue_comment_url":"https://api.github.com/repos/bitreserve/api/issues/comments{/number}","contents_url":"https://api.github.com/repos/bitreserve/api/contents/{+path}","compare_url":"https://api.github.com/repos/bitreserve/api/compare/{base}...{head}","merges_url":"https://api.github.com/repos/bitreserve/api/merges","archive_url":"https://api.github.com/repos/bitreserve/api/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/bitreserve/api/downloads","issues_url":"https://api.github.com/repos/bitreserve/api/issues{/number}","pulls_url":"https://api.github.com/repos/bitreserve/api/pulls{/number}","milestones_url":"https://api.github.com/repos/bitreserve/api/milestones{/number}","notifications_url":"https://api.github.com/repos/bitreserve/api/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/bitreserve/api/labels{/name}","releases_url":"https://api.github.com/repos/bitreserve/api/releases{/id}","created_at":"2015-01-25T20:20:49Z","updated_at":"2015-06-12T11:36:17Z","pushed_at":"2015-06-15T18:24:25Z","git_url":"git://github.com/bitreserve/api.git","ssh_url":"git@github.com:bitreserve/api.git","clone_url":"https://github.com/bitreserve/api.git","svn_url":"https://github.com/bitreserve/api","homepage":" https://developer.bitreserve.org","size":396,"stargazers_count":9,"watchers_count":9,"language":null,"has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":8,"mirror_url":null,"open_issues_count":12,"forks":8,"open_issues":12,"watchers":9,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/bitreserve/api/pulls/53"},"html":{"href":"https://github.com/bitreserve/api/pull/53"},"issue":{"href":"https://api.github.com/repos/bitreserve/api/issues/53"},"comments":{"href":"https://api.github.com/repos/bitreserve/api/issues/53/comments"},"review_comments":{"href":"https://api.github.com/repos/bitreserve/api/pulls/53/comments"},"review_comment":{"href":"https://api.github.com/repos/bitreserve/api/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/bitreserve/api/pulls/53/commits"},"statuses":{"href":"https://api.github.com/repos/bitreserve/api/statuses/7e9def7424b4438b3493d5aed71c0502f4b54e4c"}}}}