User and Organizations

Get informations about users and organizations

The GitBook API is currently in beta phase. If you wish to be one of our testers, please contact our team at [email protected].

get
Get Current User

https://$HOSTNAME/v1/user
Get the currently authenticated user.
Request
Response
Request
Response
200: OK
Returns the current user properties.
{
"uid": "520LEkmK9iOpQfC3xP7Qe4vWt7E3",
"kind": "user",
"title": "John",
"baseDomain": "john"
}

get
List Current User Organizations

https://$HOSTNAME/v1/orgs
List the current user's organizations.
Request
Response
Request
Response
200: OK
Returns a list of organizations and their properties.
{
"items": [
{
"uid": "-LvAGCSXSmmX2-R7dVhO",
"kind": "org",
"title": "Acme",
"baseDomain": "acme"
},
{
"uid": "-LvGNG0NJ3kKWPcuBs9G",
"kind": "org",
"title": "Panda Org",
"baseDomain": "panda-org"
},
{
"uid": "-LwYvEZ6uQZBBtJXOSgS",
"kind": "org",
"title": "Open-Source Project",
"baseDomain": "open-source-project"
}
]
}

get
Get User or Organization

https://$HOSTNAME/v1/owners/:ownerID
Gets information about a specific user or organization.
Request
Response
Request
Path Parameters
ownerID
required
string
A unique identifier representing an User or Organization.
Response
200: OK
// For an User
{
"uid": "520LEkmK9iOpQfC3xP7Qe4vWt7E3",
"kind": "user",
"title": "John",
"baseDomain": "john"
}
// For an Organization
{
"uid": "-LvAGCSXSmmX2-R7dVhO",
"kind": "org",
"title": "Acme",
"baseDomain": "acme"
}