Get User Picture
Download a user's picture when ngris stores it: one they uploaded on their account page or a copy of their Microsoft picture (picture_source upload or microsoft in List Users). A picture from their single sign-on provider loads from its own address, picture_url. Requires the endpoints:read permission in the active account.
Path parameters
uuid string (uuid) Req
The endpoint's
uuid from /endpoints.client_uuid string (uuid) Req
The user's
uuid. Resolved under this endpoint only.An integer id in the path is refused with 400 integer_id_unsupported (see public IDs). Use the uuid.
Response (200 OK)
The picture, Content-Type: image/png.
Errors
401 Unauthorized
Missing or invalid auth.
403 Forbidden
Your role lacks
endpoints:read, or you are not a member of the active account.404 Not Found
no stored picture when ngris stores none for the user (they may still have a picture_url), endpoint user not found, or endpoint not found for an endpoint of another account.Request
curl "https://api.ngris.com/v1/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e/rbac/clients/019b4b9d-d300-736b-8601-153b3d9f70ee/picture" \
-H "X-API-KEY: <your_api_key>" \
-o picture.png
Was this helpful?