Hosting Service Account Resource¶

Added in 1.6.7

Provides information and allows linking of hosting service accounts.

The list of accounts tied to hosting services can be retrieved, and new accounts can be linked through an HTTP POST.

Details¶

Name	`hosting_service_account`
URI	`/api/hosting-service-accounts/{account_id}/`
Token Policy ID	`hosting_service_account`
HTTP Methods	GET - Retrieves information on a particular account.
Parent Resource	Hosting Service Account List Resource
Child Resources	Remote Repository List Resource

Fields¶

idInteger	The numeric ID of the hosting service account.
serviceString	The ID of the service this account is on.
usernameString	The username of the account.

Links¶

Name	Method	Resource
remote_repositories	GET	Remote Repository List Resource
self	GET	Hosting Service Account Resource

HTTP GET¶

Retrieves information on a particular account.

This will only return very basic information on the account. Authentication information is not provided.

Errors¶

100 - Does Not ExistHTTP 404 - Not Found	Object does not exist
101 - Permission DeniedHTTP 403 - Forbidden	You don’t have permission for this
103 - Not Logged InHTTP 401 - Unauthorized	You are not logged in
112 - OAuth2 Missing Scope ErrorHTTP 403 - Forbidden	Your OAuth2 token lacks the necessary scopes for this request.
113 - OAuth2 Access Denied ErrorHTTP 403 - Forbidden	OAuth2 token access for this resource is prohibited.

Examples¶

application/vnd.reviewboard.org.hosting-service-account+json¶

$ curl https://reviews.example.com/api/hosting-service-accounts/1/ -H "Accept: application/json"

HTTP 200 OK
Content-Length: 339
Content-Type: application/vnd.reviewboard.org.hosting-service-account+json
ETag: e0b14c86d7535e50d81e9f720629c0b35414d16c
Vary: Accept, Cookie
X-Content-Type-Options: nosniff

{
  "hosting_service_account": {
    "id": 1,
    "links": {
      "remote_repositories": {
        "href": "https://reviews.example.com/api/hosting-service-accounts/1/remote-repositories/",
        "method": "GET"
      },
      "self": {
        "href": "https://reviews.example.com/api/hosting-service-accounts/1/",
        "method": "GET"
      }
    },
    "service": "github",
    "username": "testuser"
  },
  "stat": "ok"
}