
The Beta release of our documentation is available at:
http://developer.mavenlink.com/beta/
Users in Mavenlink represent the people participating in Workspaces. User objects are often returned as nested JSON objects within other returned items such as Posts or Stories.
User objects have the following readable attributes:
user_id
- the internal ID of the userfull_name
- the full name of the userphoto_path
- the full url to the user's thumbnailemail_address
- the user's primary email addressheadline
- the short description of the user as found in the user's profileYou can also fetch data for the user whose token you are authenticating with using the /me
endpoint:
curl "https://api.mavenlink.com/api/v1/users/me.json"
You can access all visible users via the API as follows.
curl "https://api.mavenlink.com/api/v1/users.json"
If the authenticating user is not an account admin, the request will return all users in workspaces that the authenticating user is participating in.
If the authenticating user is an account admin, the request will return all users in workspaces that any member from the account is participating in.
Because of this reliance on workspace participation, this endpoint will not return, for example, a member of your account that is not in any workspaces. Please use the on_my_account
option (specified below) if you wish to simply see all users on the account.
You can access all active account members (regardless of workspace participation) via the API with the on_my_account
param as follows.
curl "https://api.mavenlink.com/api/v1/users.json?on_my_account=true"
You can users' associations with the include
param. For example, to include returned users' role, you would do the following:
curl "https://api.mavenlink.com/api/v1/users.json?include=role"
In this example, our API will ensure that the returned JSON contains top-level keys called roles
where you can find associated data by inspecting time users' role_id
fields. See Object Associations to learn more. The following associations can be requested through the API:
role
- the default account role of the user. Workspace specific roles are not shown.The Mavenlink API allows you to pass in filter conditions to allow the retrieval of only certain users.
participant_in
- only return users that are active participants in the given Workspaceaccount_id
- only return users that are on the given Account. This filter is not available in conjunction with the on_my_account
option.consultants_only
- only return users that are in at least one Workspace as a consultantclients_only
- only return users that are in at least one Workspace as a clientFor example to get all users participating in Workspace 1:
curl "https://api.mavenlink.com/api/v1/users.json?participant_in=1"