# Users

Users represent the individuals that are participating in Kantata OX projects . User objects are often returned as
nested JSON objects within other returned items such as posts or tasks.

## Fetching visible users

 - [GET /users](https://developer.kantata.com/kantata/specification/users/get-users.md): This endpoint allows you to access all visible users based on the permission level of the requester.

> Note: This endpoint relies on project participation and will not return a member of your account
who is not in a project. To see all users on the account, use the on_my_account option.

If the requester is an Account Administrator, the request will return all users who are participating in a project on the requester's account.
In addition, it will return users not on the requester's account if they are participating in any project with an account member (either on the requester's account or their own account).

If the requester is not an Account Administrator, the request will only return users who are participating in a project with the requester.


This endpoint returns structured User objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the users top-level JSON key.
Please see our Response Format section for more information.

## Fetch your own data

 - [GET /users/me](https://developer.kantata.com/kantata/specification/users/get-my-user-data.md): This endpoint allows you to fetch your own data.


This endpoint returns structured User objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the users top-level JSON key.
Please see our Response Format section for more information.

## Fetching a single User

 - [GET /users/{id}](https://developer.kantata.com/kantata/specification/users/get-user.md): This endpoint returns structured User objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the users top-level JSON key.
Please see our Response Format section for more information.

## Updating an existing User

 - [PUT /users/{id}](https://developer.kantata.com/kantata/specification/users/update-user.md): This endpoint returns structured User objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the users top-level JSON key.
Please see our Response Format section for more information.

## Fetch My Work Capacity

 - [GET /users/{id}/capacity](https://developer.kantata.com/kantata/specification/users/get-my-work-capacity.md): This endpoint returns a summary of a user's work capacity for a provided range of dates.


This endpoint returns structured User objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the users top-level JSON key.
Please see our Response Format section for more information.

## Reset Profile Photo

 - [DELETE /users/{id}/profile_photo](https://developer.kantata.com/kantata/specification/users/reset-user-profile-photo.md): Delete the profile photo for the specified user.


This endpoint returns structured User objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the users top-level JSON key.
Please see our Response Format section for more information.

## Update Profile Photo

 - [POST /users/{id}/profile_photo](https://developer.kantata.com/kantata/specification/users/update-user-profile-photo.md): Update the profile photo for the specified user.


This endpoint returns structured User objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the users top-level JSON key.
Please see our Response Format section for more information.

## Fetching visible users

 - [GET /users](https://developer.kantata.com/kantata/specification/users/get-users.md): This endpoint allows you to access all visible users based on the permission level of the requester.

> Note: This endpoint relies on project participation and will not return a member of your account
who is not in a project. To see all users on the account, use the on_my_account option.

If the requester is an Account Administrator, the request will return all users who are participating in a project on the requester's account.
In addition, it will return users not on the requester's account if they are participating in any project with an account member (either on the requester's account or their own account).

If the requester is not an Account Administrator, the request will only return users who are participating in a project with the requester.


This endpoint returns structured User objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the users top-level JSON key.
Please see our Response Format section for more information.

## Fetch your own data

 - [GET /users/me](https://developer.kantata.com/kantata/specification/users/get-my-user-data.md): This endpoint allows you to fetch your own data.


This endpoint returns structured User objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the users top-level JSON key.
Please see our Response Format section for more information.

## Fetching a single User

 - [GET /users/{id}](https://developer.kantata.com/kantata/specification/users/get-user.md): This endpoint returns structured User objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the users top-level JSON key.
Please see our Response Format section for more information.

## Updating an existing User

 - [PUT /users/{id}](https://developer.kantata.com/kantata/specification/users/update-user.md): This endpoint returns structured User objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the users top-level JSON key.
Please see our Response Format section for more information.

## Fetch My Work Capacity

 - [GET /users/{id}/capacity](https://developer.kantata.com/kantata/specification/users/get-my-work-capacity.md): This endpoint returns a summary of a user's work capacity for a provided range of dates.


This endpoint returns structured User objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the users top-level JSON key.
Please see our Response Format section for more information.

## Reset Profile Photo

 - [DELETE /users/{id}/profile_photo](https://developer.kantata.com/kantata/specification/users/reset-user-profile-photo.md): Delete the profile photo for the specified user.


This endpoint returns structured User objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the users top-level JSON key.
Please see our Response Format section for more information.

## Update Profile Photo

 - [POST /users/{id}/profile_photo](https://developer.kantata.com/kantata/specification/users/update-user-profile-photo.md): Update the profile photo for the specified user.


This endpoint returns structured User objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the users top-level JSON key.
Please see our Response Format section for more information.