Users

User object holds information about a user of an organization.

The User object

Attribute	Type	Description
id	string	Unique user identifier
name	string	Full name of the user
email	string	Email address associated with the user
is_active	bool	Indicator whether the user is active or not. Inactive users cannot sign into Simple OKR.
created_at	string	Time when the user was created. RFC 3339 format.

Example:

{
  "id": "16682617-f25d-4df2-9f51-3c38298996b8",
  "name": "John Doe",
  "email": "[e-mail]",
  "is_active": true,
  "created_at": "2018-02-20T12:32:56Z"
}

List users

GET https://api.simpleokr.com/v1/users

Returns a list of your users.

Query Parameters

Name	Type	Description
page_token	string	Page identifier

200

{
  "next_page_token": null,
  "users": [
    {
      "id": "16682617-f25d-4df2-9f51-3c38298996b8",
      "name": "John Doe",
      "email": "[e-mail]",
      "is_active": true,
      "created_at": "2018-02-20T12:32:56Z"
    },
    {...},
    {...}
  ]
}

Retrieve user

GET https://api.simpleokr.com/v1/users/:id

Retrieve details about the existing user. Supply a unique user ID from a user list response.

Path Parameters

Name	Type	Description
id	string	User ID

200

{
  "id": "16682617-f25d-4df2-9f51-3c38298996b8",
  "name": "John Doe",
  "email": "[e-mail]",
  "is_active": true,
  "created_at": "2018-02-20T12:32:56Z"
}