| Safe Haskell | None |
|---|---|
| Language | Haskell2010 |
Network.PagerDuty.REST.Users
Description
Access and manipulate user data for your PagerDuty account. When a user is
shown inlined in other resources, a deleted user will have its html_url attribute
set to null.
See: http://developer.pagerduty.com/documentation/rest/users
- data ListUsers
- listUsers :: Request ListUsers s [User]
- luQuery :: Lens' (Request ListUsers s b) (Maybe Text)
- listOnCallUsers :: Request ListUsers s [User]
- data CreateUser
- createUser :: RequesterId -> Text -> Address -> Request CreateUser s User
- cuName :: Lens' (Request CreateUser s b) Text
- cuEmail :: Lens' (Request CreateUser s b) Address
- cuRole :: Lens' (Request CreateUser s b) (Maybe Role)
- cuJobTitle :: Lens' (Request CreateUser s b) (Maybe Text)
- cuTimeZone :: Lens' (Request CreateUser s b) (Maybe TimeZone)
- getUser :: UserId -> Request Empty s User
- getUserOnCall :: UserId -> Request Empty s User
- data UpdateUser
- updateUser :: UserId -> Request UpdateUser s User
- uuName :: Lens' (Request UpdateUser s b) (Maybe Text)
- uuEmail :: Lens' (Request UpdateUser s b) (Maybe Address)
- uuRole :: Lens' (Request UpdateUser s b) (Maybe Role)
- uuJobTitle :: Lens' (Request UpdateUser s b) (Maybe Text)
- uuTimeZone :: Lens' (Request UpdateUser s b) (Maybe TimeZone)
- deleteUser :: UserId -> Request Empty s Empty
- data PolicyInfo
- piId :: Lens' PolicyInfo EscalationPolicyId
- piName :: Lens' PolicyInfo Text
- data OnCall
- ocLevel :: Lens' OnCall Int
- ocStart :: Lens' OnCall (Maybe Date)
- ocEnd :: Lens' OnCall (Maybe Date)
- ocEscalationPolicy :: Lens' OnCall PolicyInfo
- data Role
- class HasUserInfo a where
- data UserInfo
- data User
- uRole :: Lens' User Role
- uAvatarUrl :: Lens' User Text
- uUserUrl :: Lens' User Text
- uInvitationSent :: Lens' User Bool
- uJobTitle :: Lens' User (Maybe Text)
List Users
listUsers :: Request ListUsers s [User] Source #
List users of your PagerDuty account, optionally filtered by a search query.
GET /users
See: http://developer.pagerduty.com/documentation/rest/users/list
luQuery :: Lens' (Request ListUsers s b) (Maybe Text) Source #
Filters the result, showing only the users whose names or email addresses match the query.
List On Call Users
listOnCallUsers :: Request ListUsers s [User] Source #
List all the existing escalation policies with currently on-call users.
If the start and end of an on-call object are null, then the user is always on-call for an escalation policy level.
GET /escalation_policies/on_call
See: http://developer.pagerduty.com/documentation/rest/escalation_policies/on_call
Create User
data CreateUser Source #
Instances
Arguments
| :: RequesterId | |
| -> Text | |
| -> Address | |
| -> Request CreateUser s User |
Create a new user for your account. An invite email will be sent asking the user to choose a password.
POST /users
See: http://developer.pagerduty.com/documentation/rest/users/create
cuEmail :: Lens' (Request CreateUser s b) Address Source #
The email of the user. The newly created user will receive an email asking to confirm the subscription.
cuJobTitle :: Lens' (Request CreateUser s b) (Maybe Text) Source #
The job title of the user.
cuTimeZone :: Lens' (Request CreateUser s b) (Maybe TimeZone) Source #
The time zone the user is in. If not specified, the time zone of the account making the API call will be used.
Get User
getUser :: UserId -> Request Empty s User Source #
Get information about an existing user.
GET /users/:id
See: http://developer.pagerduty.com/documentation/rest/users/show
Get User On Call
getUserOnCall :: UserId -> Request Empty s User Source #
Get a user object with that user's current on-call status. If the on-call object is an empty list, the user is never on-call.
If the start and end of an on-call object are null, then the user is always on-call for an escalation policy level.
GET /users/:id/on_call
See: http://developer.pagerduty.com/documentation/rest/users/show_on_call
Update User
data UpdateUser Source #
Instances
updateUser :: UserId -> Request UpdateUser s User Source #
Update an existing user.
PUT /users/:id
See: http://developer.pagerduty.com/documentation/rest/users/update
uuEmail :: Lens' (Request UpdateUser s b) (Maybe Address) Source #
The email of the user. The newly created user will receive an email asking to confirm the subscription.
uuJobTitle :: Lens' (Request UpdateUser s b) (Maybe Text) Source #
The job title of the user.
uuTimeZone :: Lens' (Request UpdateUser s b) (Maybe TimeZone) Source #
The time zone the user is in. If not specified, the time zone of the account making the API call will be used.
Delete User
deleteUser :: UserId -> Request Empty s Empty Source #
Remove an existing user.
DELETE /users/:id
See: http://developer.pagerduty.com/documentation/rest/users/delete
Types
data PolicyInfo Source #
Instances
Constructors
| RoleAdmin | |
| RoleUser | |
| RoleLimitedUser |
class HasUserInfo a where Source #
Minimal complete definition
Methods
userInfo :: Lens' a UserInfo Source #
uId :: Lens' a UserId Source #
The id of the user.
uName :: Lens' a Text Source #
The name of the user.
uEmail :: Lens' a Address Source #
The user's email address.
uColor :: Lens' a Text Source #
The color used to represent the user in schedules.
uTimeZone :: Lens' a TimeZone Source #
The user's personal time zone.
Instances
| HasUserInfo UserInfo Source # | |
| HasUserInfo User Source # | |
| HasUserInfo Override Source # | |
| (QueryLike a, ToJSON a, HasUserInfo a) => HasUserInfo (Request a s b) Source # | |